diff options
Diffstat (limited to 'portato/backend')
| -rw-r--r-- | portato/backend/portage/system.py | 90 | ||||
| -rw-r--r-- | portato/backend/system_interface.py | 143 |
2 files changed, 156 insertions, 77 deletions
diff --git a/portato/backend/portage/system.py b/portato/backend/portage/system.py index 8d8e6da..5916a9f 100644 --- a/portato/backend/portage/system.py +++ b/portato/backend/portage/system.py @@ -113,7 +113,8 @@ class PortageSystem (SystemInterface): @returns: 1. None if no name is given 2. a lambda function - @rtype: function""" + @rtype: function + """ if name != None: if isinstance(name, str): @@ -123,35 +124,52 @@ class PortageSystem (SystemInterface): else: return lambda x: True - def geneticize_list (self, list_of_packages): + def geneticize_list (self, list_of_packages, only_cpv = False): """Convertes a list of cpv's into L{backend.Package}s. @param list_of_packages: the list of packages - @type list_of_packages: list of gentoolkit.Packages + @type list_of_packages: string[] + @param only_cpv: do nothing - return the passed list + @type only_cpv: boolean @returns: converted list - @rtype: PortagePackage[]""" + @rtype: PortagePackage[] + """ - return [PortagePackage(x) for x in list_of_packages] + if not only_cpv: + return [PortagePackage(x) for x in list_of_packages] + else: + return list_of_packages def get_global_settings (self, key): return self.settings.settings[key] - def find_best (self, list): - return PortagePackage(portage.best(list)) + def find_best (self, list, only_cpv = False): + if only_cpv: + return portage.best(list) + else: + return PortagePackage(portage.best(list)) - def find_best_match (self, search_key, only_installed = False): + def find_best_match (self, search_key, only_installed = False, only_cpv = False): t = None if not only_installed: - t = self.find_packages(search_key) + try: + t = self.settings.porttree.dbapi.match(search_key) + except ValueError, e: # ambigous package + if isinstance(e[0], list): + t = [] + for cp in e[0]: + t += self.settings.porttree.dbapi.match(cp) + else: + raise else: - t = self.find_installed_packages(search_key) + t = self.find_installed_packages(search_key, only_cpv = True) if t: - return self.find_best([x.get_cpv() for x in t]) + return self.find_best(t, only_cpv) return None - def find_packages (self, search_key, masked=False): + def find_packages (self, search_key, masked=False, only_cpv = False): try: if masked: t = self.settings.porttree.dbapi.xmatch("match-all", search_key) @@ -171,13 +189,13 @@ class PortageSystem (SystemInterface): t += self.settings.porttree.dbapi.match(cp) t += self.settings.vartree.dbapi.match(cp) else: - raise ValueError(e) + raise # Make the list of packages unique t = unique_array(t) t.sort() - return self.geneticize_list(t) + return self.geneticize_list(t, only_cpv) - def find_installed_packages (self, search_key, masked = False): + def find_installed_packages (self, search_key, masked = False, only_cpv = False): try: t = self.settings.vartree.dbapi.match(search_key) # catch the "ambigous package" Exception @@ -189,48 +207,50 @@ class PortageSystem (SystemInterface): else: raise ValueError(e) - return self.geneticize_list(t) + return self.geneticize_list(t, only_cpv) - def __find_resolved_unresolved (self, list, check): + def __find_resolved_unresolved (self, list, check, only_cpv = False): """Checks a given list and divides it into a "resolved" and an "unresolved" part. @param list: list of cpv's @type list: string[] @param check: function called to check whether an entry is ok @type check: function(cpv) + @param only_cpv: do not return packages but cpv-strings + @type only_cpv: boolean @returns: the divided list: (resolved, unresolved) - @rtype: (Package[], Package[])""" + @rtype: (Package[], Package[]) or (string[], string[])""" resolved = [] unresolved = [] for x in list: cpv = x.strip() if len(cpv) and check(cpv): - pkg = self.find_best_match(cpv) + pkg = self.find_best_match(cpv, only_cpv = only_cpv) if pkg: resolved.append(pkg) else: - unresolved.append(self.find_best_match(cpv, True)) + unresolved.append(self.find_best_match(cpv, True, only_cpv = only_cpv)) return (resolved, unresolved) - def find_system_packages (self): + def find_system_packages (self, only_cpv = False): pkglist = self.settings.settings.packages - return self.__find_resolved_unresolved(pkglist, lambda cpv: cpv[0] == "*") + return self.__find_resolved_unresolved(pkglist, lambda cpv: cpv[0] == "*", only_cpv) - def find_world_packages (self): + def find_world_packages (self, only_cpv = False): f = open(portage.WORLD_FILE) pkglist = f.readlines() f.close() - return self.__find_resolved_unresolved(pkglist, lambda cpv: cpv[0] != "#") + return self.__find_resolved_unresolved(pkglist, lambda cpv: cpv[0] != "#", only_cpv) - def find_all_installed_packages (self, name = None, withVersion=True): + def find_all_installed_packages (self, name = None, withVersion=True, only_cpv = False): if withVersion: t = self.settings.vartree.dbapi.cpv_all() if name: t = filter(self.find_lambda(name),t) - return self.geneticize_list(t) + return self.geneticize_list(t, only_cpv) else: t = self.settings.vartree.dbapi.cp_all() @@ -238,11 +258,11 @@ class PortageSystem (SystemInterface): t = filter(self.find_lambda(name),t) return t - def find_all_uninstalled_packages (self, name = None): + def find_all_uninstalled_packages (self, name = None, only_cpv = False): alist = self.find_all_packages(name) - return self.geneticize_list([x for x in alist if not x.is_installed()]) + return self.geneticize_list([x.get_cpv() for x in alist if not x.is_installed()], only_cpv) - def find_all_packages (self, name = None, withVersion = True): + def find_all_packages (self, name = None, withVersion = True, only_cpv = False): t = self.settings.porttree.dbapi.cp_all() t += self.settings.vartree.dbapi.cp_all() if name: @@ -250,23 +270,23 @@ class PortageSystem (SystemInterface): t = filter(lambda x: not self.unwantedPkgsRE.match(x), unique_array(t)) - if (withVersion): + if withVersion: t2 = [] for x in t: t2 += self.settings.porttree.dbapi.cp_list(x) t2 += self.settings.vartree.dbapi.cp_list(x) t2 = unique_array(t2) - return self.geneticize_list(t2) + return self.geneticize_list(t2, only_cpv) else: return t - def find_all_world_packages (self, name = None): - world = filter(self.find_lambda(name), (x.get_cpv() for x in self.find_world_packages()[0])) + def find_all_world_packages (self, name = None, only_cpv = False): + world = filter(self.find_lambda(name), self.find_world_packages(only_cpv = True)[0]) world = unique_array(world) - return self.geneticize_list(world) + return self.geneticize_list(world, only_cpv) def find_all_system_packages (self, name = None): - sys = filter(self.find_lambda(name), (x.get_cpv() for x in self.find_system_packages()[0])) + sys = filter(self.find_lambda(name), self.find_system_packages(only_cpv = True)[0]) sys = unique_array(sys) return self.geneticize_list(sys) diff --git a/portato/backend/system_interface.py b/portato/backend/system_interface.py index 4e9618b..c0f4e68 100644 --- a/portato/backend/system_interface.py +++ b/portato/backend/system_interface.py @@ -18,7 +18,8 @@ class SystemInterface (object): @param cpv: the cpv to split @type cpv: string @returns: the splitted cpv - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -30,129 +31,169 @@ class SystemInterface (object): @param criterion: criterion to check against @type criterion: string @returns: match result - @rtype: boolean""" + @rtype: boolean + """ raise NotImplementedError - def find_best(self, list): + def find_best(self, list, only_cpv = False): """Returns the best package out of a list of packages. @param list: the list of packages to select from @type list: string[] + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean + @returns: the best package - @rtype: backend.Package""" + @rtype: backend.Package or string + """ raise NotImplementedError - def find_best_match (self, search_key, only_installed = False): + def find_best_match (self, search_key, only_installed = False, only_cpv = False): """Finds the best match in the portage tree. It does not find masked packages! @param search_key: the key to find in the portage tree @type search_key: string @param only_installed: if True, only installed packages are searched @type only_installed: boolean + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean @returns: the package found or None - @rtype: backend.Package""" + @rtype: backend.Package or string + """ raise NotImplementedError - def find_packages (self, search_key, masked=False): + def find_packages (self, search_key, masked = False, only_cpv = False): """This returns a list of packages which have to fit exactly. Additionally ranges like '<,>,=,~,!' et. al. are possible. @param search_key: the key to look for @type search_key: string @param masked: if True, also look for masked packages @type masked: boolean + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean @returns: list of found packages - @rtype: backend.Package[]""" + @rtype: backend.Package[] or string[] + """ raise NotImplementedError - def find_installed_packages (self, search_key, masked = False): + def find_installed_packages (self, search_key, masked = False, only_cpv = False): """This returns a list of packages which have to fit exactly. Additionally ranges like '<,>,=,~,!' et. al. are possible. @param search_key: the key to look for @type search_key: string @param masked: if True, also look for masked packages @type masked: boolean + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean @returns: list of found packages - @rtype: backend.Package[]""" + @rtype: backend.Package[] or string[] + """ raise NotImplementedError - def find_system_packages (self): + def find_system_packages (self, only_cpv = False): """Looks for all packages saved as "system-packages". + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean + @returns: a tuple of (resolved_packages, unresolved_packages). - @rtype: (backend.Package[], backend.Package[])""" + @rtype: (backend.Package[], backend.Package[]) or (string[], string[]) + """ raise NotImplementedError - def find_world_packages (self): + def find_world_packages (self, only_cpv = False): """Looks for all packages saved in the world-file. + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean + @returns: a tuple of (resolved_packages, unresolved_packages). - @rtype: (backend.Package[], backend.Package[])""" + @rtype: (backend.Package[], backend.Package[]) or (string[], string[]) + """ raise NotImplementedError - def find_all_installed_packages (self, name = None, withVersion = True): + def find_all_installed_packages (self, name = None, withVersion = True, only_cpv = False): """Finds all installed packages matching a name or all if no name is specified. @param name: the name to look for - it is expanded to .*name.* ; if None, all packages are returned @type name: string or None @param withVersion: if True version-specific packages are returned; else only the cat/package-strings a delivered @type withVersion: boolean + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean @returns: all packages/cp-strings found - @rtype: backend.Package[] or cp-string[]""" + @rtype: backend.Package[] or string[] + """ raise NotImplementedError - def find_all_uninstalled_packages (self, name = None): + def find_all_uninstalled_packages (self, name = None, only_cpv = False): """Finds all uninstalled packages matching a name or all if no name is specified. @param name: the name to look for - it is expanded to .*name.* ; if None, all packages are returned @type name: string or None + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean + @returns: all packages found - @rtype: backend.Package[]""" + @rtype: backend.Package[] or string[] + """ raise NotImplementedError - def find_all_packages (self, name = None, withVersion = True): + def find_all_packages (self, name = None, withVersion = True, only_cpv = False): """Finds all packages matching a name or all if no name is specified. @param name: the name to look for - it is expanded to .*name.* ; if None, all packages are returned @type name: string or None @param withVersion: if True version-specific packages are returned; else only the cat/package-strings a delivered @type withVersion: boolean + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean @returns: all packages/cp-strings found - @rtype: backend.Package[] or cp-string[]""" + @rtype: backend.Package[] or string[] + """ raise NotImplementedError - def find_all_world_packages (self, name = None): + def find_all_world_packages (self, name = None, only_cpv = False): """Finds all world packages matching a name or all if no name is specified. @param name: the name to look for - it is expanded to .*name.* ; if None, all packages are returned @type name: string or None + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean + @returns: all packages found - @rtype: backend.Package[]""" + @rtype: backend.Package[] or string[] + """ raise NotImplementedError - def find_all_system_packages (self, name = None): + def find_all_system_packages (self, name = None, only_cpv = False): """Finds all system packages matching a name or all if no name is specified. @param name: the name to look for - it is expanded to .*name.* ; if None, all packages are returned @type name: string or None + @param only_cpv: do not return package but only the cpv + @type only_cpv: boolean + @returns: all packages found - @rtype: backend.Package[]""" + @rtype: backend.Package[] or string[] + """ raise NotImplementedError @@ -162,7 +203,8 @@ class SystemInterface (object): @param name: the name to look for - it is expanded to .*name.* ; if None, all categories are returned @type name: string or None @returns: all categories found - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -170,7 +212,8 @@ class SystemInterface (object): """Sorts a package list in the same manner portage does. @param pkglist: list to sort - @type pkglist: Packages[]""" + @type pkglist: Packages[] + """ raise NotImplementedError @@ -187,7 +230,8 @@ class SystemInterface (object): @param deep: Not only check world packages but also there dependencies. @type deep: boolean @returns: a list of the tuple (new_package, old_package) - @rtype: (backend.Package, backend.Package)[]""" + @rtype: (backend.Package, backend.Package)[] + """ raise NotImplementedError @@ -196,7 +240,8 @@ class SystemInterface (object): This differs from update_world as it takes all installed packages into account but ignores changed useflags. @returns: the list of new packages - @rtype: backend.Package[]""" + @rtype: backend.Package[] + """ raise NotImplementedError @@ -209,7 +254,8 @@ class SystemInterface (object): @param package: name of a package: if given local use descriptions are searched too @type package: cp-string @returns: found description - @rtype: string""" + @rtype: string + """ raise NotImplementedError @@ -219,7 +265,8 @@ class SystemInterface (object): @param key: the setting to return @type key: string @returns: the value of this setting - @rtype: string""" + @rtype: string + """ raise NotImplementedError @@ -229,7 +276,8 @@ class SystemInterface (object): @param cpv: the cpv to create the package from @type cpv: string @returns: a new Package-object. - @rtype: Package""" + @rtype: Package + """ raise NotImplementedError @@ -237,7 +285,8 @@ class SystemInterface (object): """Returns the actual path to the config files. @returns: the path, e.g. /etc/portage - @rtype: string""" + @rtype: string + """ raise NotImplementedError @@ -245,7 +294,8 @@ class SystemInterface (object): """Returns the path to the world file. @returns: the path of the world file - @rtype: string""" + @rtype: string + """ raise NotImplementedError @@ -253,7 +303,8 @@ class SystemInterface (object): """Returns the command(s) to run for syncing. This can be overridden by the user. @returns: command to run - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -261,7 +312,8 @@ class SystemInterface (object): """Returns the command(s) to run for the merging. @returns: command to run - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -269,7 +321,8 @@ class SystemInterface (object): """Returns the options to append for marking a merge as "oneshot". @returns: option(s) to append - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -277,7 +330,8 @@ class SystemInterface (object): """Returns the options to append for marking a merge as "newuse". @returns: option(s) to append - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -285,7 +339,8 @@ class SystemInterface (object): """Returns the options to append for marking a merge as "deep". @returns: option(s) to append - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -293,7 +348,8 @@ class SystemInterface (object): """Returns the options to append for marking a merge as "update". @returns: option(s) to append - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -301,7 +357,8 @@ class SystemInterface (object): """Returns the options to append for marking a merge as "pretend". @returns: option(s) to append - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -309,7 +366,8 @@ class SystemInterface (object): """Returns the options to append for marking a merge as "unmerge". @returns: option(s) to append - @rtype: string[]""" + @rtype: string[] + """ raise NotImplementedError @@ -317,6 +375,7 @@ class SystemInterface (object): """Returns a dictionary of environment variables to set prior to do an emerge. @returns: environment variables - @rtype: dict{string : string}""" + @rtype: dict{string : string} + """ raise NotImplementedError |