[gentoo-commits] proj/gentoopm:master commit in: gentoopm/basepm/

[Michał Górny]

commit:     763280601768fdbea58a4824d5d6d35b1b66888a
Author:     Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Tue Jul 26 19:37:20 2011 +0000
Commit:     Michał Górny <mgorny <AT> gentoo <DOT> org>
CommitDate: Tue Jul 26 19:41:54 2011 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/gentoopm.git;a=commit;h=76328060

Introduce an abstract API for getting IUSE.

---
 gentoopm/basepm/pkg.py |   48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 48 insertions(+), 0 deletions(-)

diff --git a/gentoopm/basepm/pkg.py b/gentoopm/basepm/pkg.py
index d4f421f..b92a9cc 100644
--- a/gentoopm/basepm/pkg.py
+++ b/gentoopm/basepm/pkg.py
@@ -70,6 +70,45 @@ class PMPackageDescription(ABCObject, StringCompat):
 		"""
 		return str(self.long or self.short)
 
+class PMUseFlag(ABCObject, StringCompat):
+	"""
+	A base class for a USE flag supported by a package.
+	"""
+
+	def __init__(self, usestr):
+		"""
+		Instantiate from an IUSE atom.
+
+		@param usestr: the IUSE atom (C{[+-]?flag})
+		@type usestr: string
+		"""
+		self._default = None
+		if usestr[0] in ('-', '+'):
+			self._default = (usestr[0] == '+')
+			usestr = usestr[1:]
+		self._name = usestr
+
+	@property
+	def default(self):
+		"""
+		The default state, if provided by the ebuild.
+
+		@type: bool/C{None}
+		"""
+		return self._default
+
+	@property
+	def name(self):
+		"""
+		The flag name.
+
+		@type: string
+		"""
+		return self._name
+
+	def __str__(self):
+		return self.name
+
 class PMPackage(PMAtom, FillMissingComparisons):
 	"""
 	An abstract class representing a single, uniquely-identified package
@@ -240,6 +279,15 @@ class PMPackage(PMAtom, FillMissingComparisons):
 		"""
 		pass
 
+	@property
+	def use(self):
+		"""
+		Get the list of USE flags declared in the ebuild (C{IUSE}).
+
+		@type: L{SpaceSepTuple}(L{PMUseFlag})
+		"""
+		pass
+
 	@abstractproperty
 	def slotted(self):
 		"""