IntenseWebs/freeipa
3
0
Fork 0
mirror of https://salsa.debian.org/freeipa-team/freeipa.git synced 2025-01-13 01:31:56 -06:00
Code Issues Packages Projects Releases Wiki Activity

A few base.NameSpace docstring tweaks

Browse Source
This commit is contained in:
Jason Gerard DeRose 2008-12-31 15:47:28 -07:00
parent 86325bf4eb
commit b3063dbb8a
1 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
ipalib/base.py
View File

@ -18,7 +18,7 @@
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
"""
Low-level functions and abstract base classes.
Core functions and classes.
"""
import re
@ -255,6 +255,10 @@ class NameSpace(ReadOnly):
>>> namespace = NameSpace([my_member])
>>> namespace
NameSpace(<1 member>, sort=True)
We can then access ``my_member`` both as an attribute and as a dictionary
item:
>>> my_member is namespace.my_name # As an attribute
True
>>> my_member is namespace['my_name'] # As dictionary item
@ -315,15 +319,15 @@ class NameSpace(ReadOnly):
>>> list(ns()) # A more efficient, less verbose way to do it
[Member(0), Member(1), Member(2)]
As another convenience, the `NameSpace.__todict__()` method will return copy
of the ``dict`` mapping the member names to the members. For example:
As another convenience, the `NameSpace.__todict__()` method will return a
copy of the ``dict`` mapping the member names to the members. For example:
>>> ns.__todict__()
{'member1': Member(1), 'member0': Member(0), 'member2': Member(2)}
`NameSpace.__init__()` locks the instance, so `NameSpace` instances are
read-only from the get-go. For example:
As `NameSpace.__init__()` locks the instance, `NameSpace` instances are
read-only from the get-go. An ``AttributeError`` is raised if you try to
set *any* attribute on a `NameSpace` instance. For example:
>>> ns.member3 = Member(3) # Lets add that missing 'member3'
Traceback (most recent call last):