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

["Michał Górny" <mgorny@gentoo.org>]

commit:     0c6a91e0c47221086b4a58462cf8b97c5217c923
Author:     Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Thu Jul  7 11:45:53 2011 +0000
Commit:     Michał Górny <mgorny <AT> gentoo <DOT> org>
CommitDate: Thu Jul  7 11:46:07 2011 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/gentoopm.git;a=commit;h=0c6a91e0

Introduce an abstract API for filters.

---
 gentoopm/basepm/filter.py |   35 +++++++++++++++++++++++++++++++++++
 gentoopm/basepm/pkg.py    |    3 ++-
 2 files changed, 37 insertions(+), 1 deletions(-)

diff --git a/gentoopm/basepm/filter.py b/gentoopm/basepm/filter.py
new file mode 100644
index 0000000..26d9e37
--- /dev/null
+++ b/gentoopm/basepm/filter.py
@@ -0,0 +1,35 @@
+#!/usr/bin/python
+#	vim:fileencoding=utf-8
+# (c) 2011 Michał Górny <mgorny@gentoo.org>
+# Released under the terms of the 2-clause BSD license.
+
+from abc import abstractmethod
+
+from gentoopm.util import ABCObject
+
+class PMPackageMatcher(ABCObject):
+	"""
+	Base class for a package matcher.
+	"""
+
+	@abstractmethod
+	def __call__(self, pkg):
+		"""
+		Check whether a package matches the condition specified in the matcher.
+		Return True if it does, False otherwise.
+		"""
+		pass
+
+class PMKeywordMatcher(ABCObject):
+	"""
+	Base class for a keyword matcher (one passed as a keyword argument
+	instead of a plain string).
+	"""
+
+	@abstractmethod
+	def __eq__(self, val):
+		"""
+		Check whether the value of a metadata key matches the condition
+		specified in the matcher. Return True if it does, False otherwise.
+		"""
+		pass

diff --git a/gentoopm/basepm/pkg.py b/gentoopm/basepm/pkg.py
index 9365465..1bb2447 100644
--- a/gentoopm/basepm/pkg.py
+++ b/gentoopm/basepm/pkg.py
@@ -22,7 +22,8 @@ class PMPackageSet(ABCObject):
 
 		The positional arguments can provide a number of PMPackageMatchers (see
 		gentoopm.basepm.filter) and/or an atom string. The keyword arguments
-		match metadata keys using '==' comparison with passed values (objects).
+		match metadata keys using '==' comparison with passed string
+		(or PMKeywordMatchers).
 
 		Multiple filters will be AND-ed together. Same applies for .filter()
 		called multiple times. You should, however, avoid passing multiple