From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1SjHi0-0005o5-Jt for garchives@archives.gentoo.org; Mon, 25 Jun 2012 22:24:36 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 13F8421C172; Mon, 25 Jun 2012 22:23:47 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id C953121C172 for ; Mon, 25 Jun 2012 22:23:46 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id DEAB71B44EA for ; Mon, 25 Jun 2012 22:23:45 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id E7A2DE5442 for ; Mon, 25 Jun 2012 22:23:43 +0000 (UTC) From: "Slava Bacherikov" To: gentoo-commits@lists.gentoo.org Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Slava Bacherikov" Message-ID: <1340660719.b1ca10a9ac31b5a0a99a26780b2a293a8a315790.bacher09@gentoo> Subject: [gentoo-commits] proj/gentoo-packages:master commit in: gpackages/libs/package_info/generic_metadata/ X-VCS-Repository: proj/gentoo-packages X-VCS-Files: gpackages/libs/package_info/generic_metadata/repo_info.py X-VCS-Directories: gpackages/libs/package_info/generic_metadata/ X-VCS-Committer: bacher09 X-VCS-Committer-Name: Slava Bacherikov X-VCS-Revision: b1ca10a9ac31b5a0a99a26780b2a293a8a315790 X-VCS-Branch: master Date: Mon, 25 Jun 2012 22:23:43 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: 7213ed91-f4fd-486c-903a-06ed4bb10686 X-Archives-Hash: 7f88db9f3aec2933db2669dffd93e40e commit: b1ca10a9ac31b5a0a99a26780b2a293a8a315790 Author: Slava Bacherikov bacher09 org> AuthorDate: Mon Jun 25 21:45:19 2012 +0000 Commit: Slava Bacherikov bacherikov org ua> CommitDate: Mon Jun 25 21:45:19 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=3Dproj/gentoo-packag= es.git;a=3Dcommit;h=3Db1ca10a9 Add docstrings to repo_info file --- .../package_info/generic_metadata/repo_info.py | 21 ++++++++++++++= ++++++ 1 files changed, 21 insertions(+), 0 deletions(-) diff --git a/gpackages/libs/package_info/generic_metadata/repo_info.py b/= gpackages/libs/package_info/generic_metadata/repo_info.py index 9316f34..d9ba513 100644 --- a/gpackages/libs/package_info/generic_metadata/repo_info.py +++ b/gpackages/libs/package_info/generic_metadata/repo_info.py @@ -17,8 +17,11 @@ def _gen_funct(name): return func =20 class Enum(object): + "Enum object" =20 def __init__(self, lst): + """Args: + lst -- list of strings""" dct =3D {} dct2 =3D {} self.list =3D lst @@ -30,6 +33,7 @@ class Enum(object): self.num_dict =3D dct2 =20 def get_as_tuple(self): + "Return tuple to use as choices in django model" return tuple([(num, item) for num, item in enumerate(self.list)]) =20 REPO_TYPE =3D ( 'git',=20 @@ -47,8 +51,12 @@ REPOS_TYPE =3D Enum(REPO_TYPE) =20 @total_ordering class SourcesObject(ToStrMixin): + "Represent source of repository" =20 def __init__(self, source_tuple): + """Args: + source_tuple -- tuple (source_url, source_type, source_subpa= th) + """ self.source_url =3D source_tuple[0].lower() self.source_type =3D REPOS_TYPE.repo_dict[source_tuple[1].lower(= )] self.source_subpath =3D source_tuple[2] @@ -70,6 +78,8 @@ class SourcesObject(ToStrMixin): return self.source_url =20 class TreeMetadataMetaclass(type): + """Dynamicaly add properties by `simple_attrs` tuple + It gets this name from `_dct` dict in object""" =20 def __init__(cls, name, bases, dct): super(TreeMetadataMetaclass, cls).__init__(name, bases, dct) @@ -77,6 +87,7 @@ class TreeMetadataMetaclass(type): setattr(cls, v, property(_gen_funct(v))) =20 class TreeMetadata(ToStrMixin): + "Represent metadata information about portage tree (overlay)" __metaclass__ =3D TreeMetadataMetaclass =20 simple_attrs =3D ( 'name', 'description', 'supported', 'owner_name', @@ -86,6 +97,10 @@ class TreeMetadata(ToStrMixin): qualities =3D {'stable': 0 , 'testing': 1, 'experimental': 2} =20 def __init__(self, repo_name, dct =3D None): + """Args: + repo_name -- repository name + dct -- dict of params, could be None that it will be calcula= ted=20 + """ repo_name =3D self._find_real_repo_name(repo_name) self.repo_name =3D repo_name =20 @@ -138,10 +153,12 @@ class TreeMetadata(ToStrMixin): =20 @property def int_status(self): + "Return repostory status as int, int values a keys in `statuses`= " return self.statuses.get(self._dct['status'], 1) =20 @cached_property def homepage(self): + "Return valid str homepage" homepage =3D self._dct.get('homepage') try: validate_url(homepage) @@ -152,6 +169,7 @@ class TreeMetadata(ToStrMixin): =20 @cached_property def owner_email(self): + "Return valid str owner email" email =3D self._dct.get('owner_email') try: validate_email(email) @@ -162,6 +180,7 @@ class TreeMetadata(ToStrMixin): =20 @cached_property def feeds(self): + "Return validated list of feeds" ret =3D set() for feed in self._dct.get('feeds', ()): try: @@ -174,6 +193,7 @@ class TreeMetadata(ToStrMixin): =20 @cached_property def sources(self): + "Return list of `SourcesObject`s" ret =3D set()=20 for source in self._dct['sources']: ret.add(SourcesObject(source)) @@ -181,6 +201,7 @@ class TreeMetadata(ToStrMixin): =20 @property def int_quality(self): + "Return repostory quality as int, int values a keys in `qualitie= s`" return self.qualities.get(self._dct['quality'], 2) =20 def __unicode__(self):