From: Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr>
Date: Fri, 23 Feb 2007 16:28:10 +0000 (+0000)
Subject: extended documentation to describe pattern-matching and negation features
X-Git-Tag: PLCAPI-4.2-0~179
X-Git-Url: http://git.onelab.eu/?a=commitdiff_plain;h=18882d48e97f9960502010a2a3f9bf608d332650;p=plcapi.git

extended documentation to describe pattern-matching and negation features
---

diff --git a/PLC/Filter.py b/PLC/Filter.py
index 9f5fb42b..49990c69 100644
--- a/PLC/Filter.py
+++ b/PLC/Filter.py
@@ -11,8 +11,9 @@ from PLC.Parameter import Parameter, Mixed, python_type
 class Filter(Parameter, dict):
     """
     A type of parameter that represents a filter on one or more
-    columns of a database table. fields should be a dictionary of
-    field names and types, e.g.
+    columns of a database table.
+
+    field should be a dictionary of field names and types, e.g.
 
     {'node_id': Parameter(int, "Node identifier"),
      'hostname': Parameter(int, "Fully qualified hostname", max = 255),
@@ -24,6 +25,14 @@ class Filter(Parameter, dict):
     representing an intersection (if join_with is AND) or union (if
     join_with is OR) filter. If a value is a sequence type, then it
     should represent a list of possible values for that field.
+
+    Special forms:
+    * a field starting with the ~ character means negation.
+    example :  { '~peer_id' : None }
+    * a (string) value containing either a * or a % character is
+      treated as a (sql) pattern; * are replaced with % that is the
+      SQL wildcard character.
+    example :  { 'hostname' : '*.jp' } 
     """
 
     def __init__(self, fields = {}, filter = {}, doc = "Attribute filter"):