xref: /OK3568_Linux_fs/yocto/poky/bitbake/lib/bb/fetch2/local.py (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1"""
2BitBake 'Fetch' implementations
3
4Classes for obtaining upstream sources for the
5BitBake build tools.
6
7"""
8
9# Copyright (C) 2003, 2004  Chris Larson
10#
11# SPDX-License-Identifier: GPL-2.0-only
12#
13# Based on functions from the base bb module, Copyright 2003 Holger Schurig
14#
15
16import os
17import urllib.request, urllib.parse, urllib.error
18import bb
19import bb.utils
20from   bb.fetch2 import FetchMethod, FetchError, ParameterError
21from   bb.fetch2 import logger
22
23class Local(FetchMethod):
24    def supports(self, urldata, d):
25        """
26        Check to see if a given url represents a local fetch.
27        """
28        return urldata.type in ['file']
29
30    def urldata_init(self, ud, d):
31        # We don't set localfile as for this fetcher the file is already local!
32        ud.decodedurl = urllib.parse.unquote(ud.url.split("://")[1].split(";")[0])
33        ud.basename = os.path.basename(ud.decodedurl)
34        ud.basepath = ud.decodedurl
35        ud.needdonestamp = False
36        if "*" in ud.decodedurl:
37            raise bb.fetch2.ParameterError("file:// urls using globbing are no longer supported. Please place the files in a directory and reference that instead.", ud.url)
38        return
39
40    def localpath(self, urldata, d):
41        """
42        Return the local filename of a given url assuming a successful fetch.
43        """
44        return self.localpaths(urldata, d)[-1]
45
46    def localpaths(self, urldata, d):
47        """
48        Return the local filename of a given url assuming a successful fetch.
49        """
50        searched = []
51        path = urldata.decodedurl
52        newpath = path
53        if path[0] == "/":
54            return [path]
55        filespath = d.getVar('FILESPATH')
56        if filespath:
57            logger.debug2("Searching for %s in paths:\n    %s" % (path, "\n    ".join(filespath.split(":"))))
58            newpath, hist = bb.utils.which(filespath, path, history=True)
59            searched.extend(hist)
60        if not os.path.exists(newpath):
61            dldirfile = os.path.join(d.getVar("DL_DIR"), path)
62            logger.debug2("Defaulting to %s for %s" % (dldirfile, path))
63            bb.utils.mkdirhier(os.path.dirname(dldirfile))
64            searched.append(dldirfile)
65            return searched
66        return searched
67
68    def need_update(self, ud, d):
69        if os.path.exists(ud.localpath):
70            return False
71        return True
72
73    def download(self, urldata, d):
74        """Fetch urls (no-op for Local method)"""
75        # no need to fetch local files, we'll deal with them in place.
76        if self.supports_checksum(urldata) and not os.path.exists(urldata.localpath):
77            locations = []
78            filespath = d.getVar('FILESPATH')
79            if filespath:
80                locations = filespath.split(":")
81            locations.append(d.getVar("DL_DIR"))
82
83            msg = "Unable to find file " + urldata.url + " anywhere. The paths that were searched were:\n    " + "\n    ".join(locations)
84            raise FetchError(msg)
85
86        return True
87
88    def checkstatus(self, fetch, urldata, d):
89        """
90        Check the status of the url
91        """
92        if os.path.exists(urldata.localpath):
93            return True
94        return False
95
96    def clean(self, urldata, d):
97        return
98
99