# CPV - category/package-version
class Package:
- """Package descriptor. Contains convenience functions for querying the
- state of a package, its contents, name manipulation, ebuild info and
- similar."""
- def __init__(self,cpv):
- self._cpv = cpv
- self._scpv = portage.catpkgsplit(self._cpv)
- if not self._scpv:
- raise Exception("invalid cpv: %s" % cpv)
- self._db = None
- self._settings = None
- def get_name(self):
- """Returns base name of package, no category nor version"""
- return self._scpv[1]
- def get_version(self):
- """Returns version of package, with revision number"""
- v=self._scpv[2]
- if self._scpv[3] != "r0":
- v+="-"+self._scpv[3]
- return v
- def get_category(self):
- """Returns category of package"""
- return self._scpv[0]
- def get_cpv(self):
- """Returns full Category/Package-Version string"""
- return self._cpv
- def get_provides(self):
- """Return a list of provides, if any"""
- return vartree.get_provides(self._cpv)
- def get_dependants(self):
- """Retrieves a list of CPVs for all packages depending on this one"""
- raise "Not implemented yet!"
- def get_runtime_deps(self):
- """Returns a linearised list of first-level compile time dependencies for this package, on
- the form [(comparator, [use flags], cpv), ...]"""
- cd=self.get_env_var("RDEPEND").split()
- r,i=self._parse_deps(cd)
- return r
- def get_compiletime_deps(self):
- """Returns a linearised list of first-level compile time dependencies for this package, on
- the form [(comparator, [use flags], cpv), ...]"""
- rd=self.get_env_var("DEPEND").split()
- r,i=self._parse_deps(rd)
- return r
- def _parse_deps(self,deps,curuse=[],level=0):
- # store (comparator, [use predicates], cpv)
- r=[]
- comparators=["~","<",">","=","<=",">="]
- end=len(deps)
- i=0
- while i < end:
- tok=deps[i]
- if tok == ')':
- return r,i
- if tok[-1] == "?" or tok[0] == "!":
- tok=tok.replace("?","")
- sr,l = self._parse_deps(deps[i+2:],curuse=curuse+[tok],level=level+1)
- r += sr
- i+=l+3
- continue
- # pick out comparator, if any
- cmp=""
- for c in comparators:
- if tok.find(c) == 0:
- cmp=c
- tok=tok[len(cmp):]
- r.append((cmp,curuse,tok))
- i+=1
- return r,i
- def is_installed(self):
- """Returns true if this package is installed (merged)"""
- self._initdb()
- return os.path.exists(self._db.getpath())
- def is_overlay(self):
- dir,ovl=portage.portdb.findname2(self._cpv)
- return ovl
- def is_masked(self):
- """Returns true if this package is masked against installation. Note: We blindly assume that
- the package actually exists on disk somewhere."""
- unmasked = portage.portdb.xmatch("match-visible", "=" + self._cpv)
- return self._cpv not in unmasked
- def get_ebuild_path(self,in_vartree=0):
- """Returns the complete path to the .ebuild file"""
- if in_vartree:
- return vartree.getebuildpath(self._cpv)
- else:
- return portage.portdb.findname(self._cpv)
- def get_package_path(self):
- """Returns the path to where the ChangeLog, Manifest, .ebuild files reside"""
- p=self.get_ebuild_path()
- sp=p.split("/")
- if len(sp):
- return string.join(sp[:-1],"/")
- def get_env_var(self, var):
- """Returns one of the predefined env vars DEPEND, RDEPEND, SRC_URI,...."""
- r=porttree.dbapi.aux_get(self._cpv,[var])
- if not r:
- raise "WTF??"
- if len(r)!=1:
- raise "Should only get one element!"
- return r[0]
- def get_use_vars(self):
- """Returns the USE flags active at time of installation"""
- self._initdb()
- if self.is_installed():
- return self._db.getfile("USE")
- return ""
- def get_contents(self):
- """Returns the full contents, as a dictionary, on the form
- [ '/bin/foo' : [ 'obj', '1052505381', '45ca8b8975d5094cd75bdc61e9933691' ], ... ]"""
- self._initdb()
- if self.is_installed():
- return self._db.getcontents()
- return {}
- def compare_version(self,other):
- """Compares this package's version to another's CPV; returns -1, 0, 1"""
- v1=self._scpv
- v2=portage.catpkgsplit(other.get_cpv())
- if v1[0] != v2[0] or v1[1] != v2[1]:
- return None
- return portage.pkgcmp(v1[1:],v2[1:])
- def size(self):
- """Estimates the installed size of the contents of this package, if possible.
- Returns [size, number of files in total, number of uncounted files]"""
- contents = self.get_contents()
- size=0
- uncounted = 0
- files=0
- for x in contents:
- try:
- size += os.stat(x).st_size
- files += 1
- except OSError:
- uncounted += 1
- return [size, files, uncounted]
+ """Package descriptor. Contains convenience functions for querying the
+ state of a package, its contents, name manipulation, ebuild info and
+ similar."""
+ def __init__(self,cpv):
+ self._cpv = cpv
+ self._scpv = portage.catpkgsplit(self._cpv)
+ if not self._scpv:
+ raise Exception("invalid cpv: %s" % cpv)
+ self._db = None
+ self._settings = None
+ def get_name(self):
+ """Returns base name of package, no category nor version"""
+ return self._scpv[1]
+ def get_version(self):
+ """Returns version of package, with revision number"""
+ v=self._scpv[2]
+ if self._scpv[3] != "r0":
+ v+="-"+self._scpv[3]
+ return v
+ def get_category(self):
+ """Returns category of package"""
+ return self._scpv[0]
+ def get_cpv(self):
+ """Returns full Category/Package-Version string"""
+ return self._cpv
+ def get_provides(self):
+ """Return a list of provides, if any"""
+ return vartree.get_provides(self._cpv)
+ def get_dependants(self):
+ """Retrieves a list of CPVs for all packages depending on this one"""
+ raise "Not implemented yet!"
+ def get_runtime_deps(self):
+ """Returns a linearised list of first-level compile time dependencies for this package, on
+ the form [(comparator, [use flags], cpv), ...]"""
+ cd=self.get_env_var("RDEPEND").split()
+ r,i=self._parse_deps(cd)
+ return r
+ def get_compiletime_deps(self):
+ """Returns a linearised list of first-level compile time dependencies for this package, on
+ the form [(comparator, [use flags], cpv), ...]"""
+ rd=self.get_env_var("DEPEND").split()
+ r,i=self._parse_deps(rd)
+ return r
+ def _parse_deps(self,deps,curuse=[],level=0):
+ # store (comparator, [use predicates], cpv)
+ r=[]
+ comparators=["~","<",">","=","<=",">="]
+ end=len(deps)
+ i=0
+ while i < end:
+ tok=deps[i]
+ if tok == ')':
+ return r,i
+ if tok[-1] == "?" or tok[0] == "!":
+ tok=tok.replace("?","")
+ sr,l = self._parse_deps(deps[i+2:],curuse=curuse+[tok],level=level+1)
+ r += sr
+ i+=l+3
+ continue
+ # pick out comparator, if any
+ cmp=""
+ for c in comparators:
+ if tok.find(c) == 0:
+ cmp=c
+ tok=tok[len(cmp):]
+ r.append((cmp,curuse,tok))
+ i+=1
+ return r,i
+ def is_installed(self):
+ """Returns true if this package is installed (merged)"""
+ self._initdb()
+ return os.path.exists(self._db.getpath())
+ def is_overlay(self):
+ dir,ovl=portage.portdb.findname2(self._cpv)
+ return ovl
+ def is_masked(self):
+ """Returns true if this package is masked against installation. Note: We blindly assume that
+ the package actually exists on disk somewhere."""
+ unmasked = portage.portdb.xmatch("match-visible", "=" + self._cpv)
+ return self._cpv not in unmasked
+ def get_ebuild_path(self,in_vartree=0):
+ """Returns the complete path to the .ebuild file"""
+ if in_vartree:
+ return vartree.getebuildpath(self._cpv)
+ else:
+ return portage.portdb.findname(self._cpv)
+ def get_package_path(self):
+ """Returns the path to where the ChangeLog, Manifest, .ebuild files reside"""
+ p=self.get_ebuild_path()
+ sp=p.split("/")
+ if len(sp):
+ return string.join(sp[:-1],"/")
+ def get_env_var(self, var):
+ """Returns one of the predefined env vars DEPEND, RDEPEND, SRC_URI,...."""
+ r=porttree.dbapi.aux_get(self._cpv,[var])
+ if not r:
+ raise "WTF??"
+ if len(r)!=1:
+ raise "Should only get one element!"
+ return r[0]
+ def get_use_vars(self):
+ """Returns the USE flags active at time of installation"""
+ self._initdb()
+ if self.is_installed():
+ return self._db.getfile("USE")
+ return ""
+ def get_contents(self):
+ """Returns the full contents, as a dictionary, on the form
+ [ '/bin/foo' : [ 'obj', '1052505381', '45ca8b8975d5094cd75bdc61e9933691' ], ... ]"""
+ self._initdb()
+ if self.is_installed():
+ return self._db.getcontents()
+ return {}
+ def compare_version(self,other):
+ """Compares this package's version to another's CPV; returns -1, 0, 1"""
+ v1=self._scpv
+ v2=portage.catpkgsplit(other.get_cpv())
+ if v1[0] != v2[0] or v1[1] != v2[1]:
+ return None
+ return portage.pkgcmp(v1[1:],v2[1:])
+ def size(self):
+ """Estimates the installed size of the contents of this package, if possible.
+ Returns [size, number of files in total, number of uncounted files]"""
+ contents = self.get_contents()
+ size=0
+ uncounted = 0
+ files=0
+ for x in contents:
+ try:
+ size += os.stat(x).st_size
+ files += 1
+ except OSError:
+ uncounted += 1
+ return [size, files, uncounted]
- def _initdb(self):
- """Internal helper function; loads package information from disk,
- when necessary"""
- if not self._db:
- cat=self.get_category()
- pnv=self.get_name()+"-"+self.get_version()
- self._db=portage.dblink(cat,pnv,"",settings)
+ def _initdb(self):
+ """Internal helper function; loads package information from disk,
+ when necessary"""
+ if not self._db:
+ cat=self.get_category()
+ pnv=self.get_name()+"-"+self.get_version()
+ self._db=portage.dblink(cat,pnv,"",settings)
#
# Global helper functions
#
def find_packages(search_key):
- """Returns a list of Package objects that matched the search key."""
- # FIXME: this one failes if search_key contains version suffix
- t=portage.portdb.match(search_key)
- return map(lambda x: Package(x), t)
+ """Returns a list of Package objects that matched the search key."""
+ # FIXME: this one failes if search_key contains version suffix
+ t=portage.portdb.match(search_key)
+ return map(lambda x: Package(x), t)
def find_best_match(search_key):
- """Returns a Package object for the best available installed candidate that
- matched the search key. Doesn't handle virtuals perfectly"""
- # FIXME: How should we handled versioned virtuals??
- cat,pkg,ver,rev=split_package_name(search_key)
- if cat == "virtual":
- t=vartree.dep_bestmatch(cat+"/"+pkg)
- else:
- t=vartree.dep_bestmatch(search_key)
- if t:
- return Package(t)
- return None
+ """Returns a Package object for the best available installed candidate that
+ matched the search key. Doesn't handle virtuals perfectly"""
+ # FIXME: How should we handled versioned virtuals??
+ cat,pkg,ver,rev=split_package_name(search_key)
+ if cat == "virtual":
+ t=vartree.dep_bestmatch(cat+"/"+pkg)
+ else:
+ t=vartree.dep_bestmatch(search_key)
+ if t:
+ return Package(t)
+ return None
def find_system_packages(prefilter=None):
- """Returns a tuple of lists, first list is resolved system packages,
- second is a list of unresolved packages."""
- f = open(portage.profiledir+"/packages")
- pkglist = f.readlines()
- resolved = []
- unresolved = []
- for x in pkglist:
- cpv = x.strip()
- if len(cpv) and cpv[0] == "*":
- pkg = find_best_match(cpv)
- if pkg:
- resolved.append(pkg)
- else:
- unresolved.append(cpv)
- return (resolved, unresolved)
-
+ """Returns a tuple of lists, first list is resolved system packages,
+ second is a list of unresolved packages."""
+ f = open(portage.profiledir+"/packages")
+ pkglist = f.readlines()
+ resolved = []
+ unresolved = []
+ for x in pkglist:
+ cpv = x.strip()
+ if len(cpv) and cpv[0] == "*":
+ pkg = find_best_match(cpv)
+ if pkg:
+ resolved.append(pkg)
+ else:
+ unresolved.append(cpv)
+ return (resolved, unresolved)
+
def find_world_packages(prefilter=None):
- """Returns a tuple of lists, first list is resolved world packages,
- seond is unresolved package names."""
- f = open(portage.root+"var/cache/edb/world")
- pkglist = f.readlines()
- resolved = []
- unresolved = []
- for x in pkglist:
- cpv = x.strip()
- if len(cpv) and cpv[0] != "#":
- pkg = find_best_match(cpv)
- if pkg:
- resolved.append(pkg)
- else:
- unresolved.append(cpv)
- return (resolved,unresolved)
+ """Returns a tuple of lists, first list is resolved world packages,
+ seond is unresolved package names."""
+ f = open(portage.root+"var/cache/edb/world")
+ pkglist = f.readlines()
+ resolved = []
+ unresolved = []
+ for x in pkglist:
+ cpv = x.strip()
+ if len(cpv) and cpv[0] != "#":
+ pkg = find_best_match(cpv)
+ if pkg:
+ resolved.append(pkg)
+ else:
+ unresolved.append(cpv)
+ return (resolved,unresolved)
def find_all_installed_packages(prefilter=None):
- """Returns a list of all installed packages, after applying the prefilter
- function"""
- t=vartree.dbapi.cpv_all()
- if prefilter:
- t=filter(prefilter,t)
- return [Package(x) for x in t]
+ """Returns a list of all installed packages, after applying the prefilter
+ function"""
+ t=vartree.dbapi.cpv_all()
+ if prefilter:
+ t=filter(prefilter,t)
+ return [Package(x) for x in t]
def find_all_uninstalled_packages(prefilter=None):
- """Returns a list of all uninstalled packages, after applying the prefilter
- function"""
- alist = find_all_packages(prefilter)
- return [x for x in alist if not x.is_installed()]
+ """Returns a list of all uninstalled packages, after applying the prefilter
+ function"""
+ alist = find_all_packages(prefilter)
+ return [x for x in alist if not x.is_installed()]
def find_all_packages(prefilter=None):
- """Returns a list of all known packages, installed or not, after applying
- the prefilter function"""
- t=portage.portdb.cp_all()
- if prefilter:
- t=filter(prefilter,t)
- t2=[]
- for x in t:
- t2 += portage.portdb.cp_list(x)
- return [Package(x) for x in t2]
+ """Returns a list of all known packages, installed or not, after applying
+ the prefilter function"""
+ t=portage.portdb.cp_all()
+ if prefilter:
+ t=filter(prefilter,t)
+ t2=[]
+ for x in t:
+ t2 += portage.portdb.cp_list(x)
+ return [Package(x) for x in t2]
def split_package_name(name):
- """Returns a list on the form [category, name, version, revision]. Revision will
- be 'r0' if none can be inferred. Category and version will be empty, if none can
- be inferred."""
- r=portage.catpkgsplit(name)
- if not r:
- r=name.split("/")
- if len(r) == 1:
- return ["",name,"","r0"]
- else:
- return r + ["","r0"]
- if r[0] == 'null':
- r[0] = ''
- return r
+ """Returns a list on the form [category, name, version, revision]. Revision will
+ be 'r0' if none can be inferred. Category and version will be empty, if none can
+ be inferred."""
+ r=portage.catpkgsplit(name)
+ if not r:
+ r=name.split("/")
+ if len(r) == 1:
+ return ["",name,"","r0"]
+ else:
+ return r + ["","r0"]
+ if r[0] == 'null':
+ r[0] = ''
+ return r
def sort_package_list(pkglist):
"""Returns the list ordered in the same way portage would do with lowest version
return pkglist
if __name__ == "__main__":
- print "This module is for import only"
+ print "This module is for import only"
projects / gentoolkit.git / commitdiff