[Zope3-checkins] CVS: Zope3/src/zope/interface/common - __init__.py:1.2 mapping.py:1.2

Jim Fulton jim@zope.com
Wed, 25 Dec 2002 09:15:42 -0500


Update of /cvs-repository/Zope3/src/zope/interface/common
In directory cvs.zope.org:/tmp/cvs-serv20790/src/zope/interface/common

Added Files:
	__init__.py mapping.py 
Log Message:
Grand renaming:

- Renamed most files (especially python modules) to lower case.

- Moved views and interfaces into separate hierarchies within each
  project, where each top-level directory under the zope package
  is a separate project.

- Moved everything to src from lib/python.

  lib/python will eventually go away. I need access to the cvs
  repository to make this happen, however.

There are probably some bits that are broken. All tests pass
and zope runs, but I haven't tried everything. There are a number
of cleanups I'll work on tomorrow.



=== Zope3/src/zope/interface/common/__init__.py 1.1 => 1.2 ===
--- /dev/null	Wed Dec 25 09:15:42 2002
+++ Zope3/src/zope/interface/common/__init__.py	Wed Dec 25 09:15:11 2002
@@ -0,0 +1,2 @@
+#
+# This file is necessary to make this directory a package.


=== Zope3/src/zope/interface/common/mapping.py 1.1 => 1.2 ===
--- /dev/null	Wed Dec 25 09:15:42 2002
+++ Zope3/src/zope/interface/common/mapping.py	Wed Dec 25 09:15:11 2002
@@ -0,0 +1,58 @@
+##############################################################################
+#
+# Copyright (c) 2001, 2002 Zope Corporation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.0 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+"""
+$Id$
+"""
+
+from zope.interface import Interface
+
+class IReadMapping(Interface):
+    """Basic mapping interface
+    """
+
+    def __getitem__(key):
+        """Get a value for a key
+
+        A KeyError is raised if there is no value for the key.
+        """
+
+    def get(key, default=None):
+        """Get a value for a key
+
+        The default is returned if there is no value for the key.
+        """
+
+    def __contains__(key):
+        """Tell if a key exists in the mapping
+        """
+
+class IEnumerableMapping(IReadMapping):
+    """Mapping objects whose items can be enumerated
+    """
+
+    def keys():
+        """Return the keys of the mapping object
+        """
+
+    def values():
+        """Return the values of the mapping object
+        """
+
+    def items():
+        """Return the items of the mapping object
+        """
+
+    def __len__():
+        """Return the number of items
+        """