Raymond Hettinger
5a9fed75bd
Fix-up the enumerate type example and move it to the end.
2008-05-08 07:23:30 +00:00
Benjamin Peterson
c7b05920d6
reformat some documentation of classes so methods and attributes are under the class directive
2008-04-25 01:29:10 +00:00
Georg Brandl
d289ea6df9
#2502 : add example how to do enum types with named tuples.
2008-03-28 12:58:26 +00:00
Georg Brandl
4c8bbe69e5
Make collections' doctests executable.
...
(The <BLANKLINE>s will be stripped from presentation output.)
2008-03-22 21:06:20 +00:00
Georg Brandl
907a720f89
A lot more typo fixes by Ori Avtalion.
2008-02-22 12:31:45 +00:00
Raymond Hettinger
bc4ffc17df
Backport ABC docs
2008-02-11 23:38:00 +00:00
Raymond Hettinger
9bba7b7085
Removed an unnecessary and confusing paragraph from the namedtuple docs.
2008-01-27 10:47:55 +00:00
Raymond Hettinger
0fe6ca4673
Better variable name in an example.
2008-01-18 21:14:58 +00:00
Raymond Hettinger
171f3916c5
Minor wordsmithing.
2008-01-16 23:38:16 +00:00
Raymond Hettinger
e805782b53
Fix-up half-written paragraph in the docs
2008-01-15 21:22:47 +00:00
Raymond Hettinger
f59e962b49
Refactor if/elif chain for clarity and speed. Remove dependency on subclasses having to implement _empty and _full.
2008-01-15 20:52:42 +00:00
Raymond Hettinger
d1ef85420f
Run doctests on the collections module
2008-01-11 00:23:13 +00:00
Raymond Hettinger
15b5e55b48
Neaten-up the named tuple docs
2008-01-10 23:00:01 +00:00
Raymond Hettinger
e850c466c7
Clarify how to add a field to a named tuple.
2008-01-10 20:37:12 +00:00
Raymond Hettinger
e1655088ca
Examples for named tuple subclassing should include __slots__
2008-01-10 19:15:10 +00:00
Raymond Hettinger
dc1854dec4
Fix typo
2008-01-09 03:13:20 +00:00
Raymond Hettinger
e11230e11b
Syntax highlighting only works when >>> lines are accompanied by ... lines
2008-01-09 03:02:23 +00:00
Raymond Hettinger
ac5742e0fe
Docs on named tuple's naming conventions and limits of subclassing
2008-01-08 02:24:15 +00:00
Raymond Hettinger
f6b769b464
Documentation nits.
2008-01-07 21:33:51 +00:00
Raymond Hettinger
f5e8af1bb7
Use get() instead of pop() for the optimized version of _replace().
2008-01-07 20:56:05 +00:00
Raymond Hettinger
fb3ced663d
Minor markup fix
2008-01-07 20:17:35 +00:00
Raymond Hettinger
9a359210aa
Cleanup named tuple subclassing example.
2008-01-07 20:07:38 +00:00
Georg Brandl
b3255ed8c9
Restore "somenamedtuple" as the "class" for named tuple attrs.
2008-01-07 16:43:47 +00:00
Georg Brandl
503f2935c9
Clean up markup.
2008-01-07 09:18:17 +00:00
Raymond Hettinger
dc55f35f38
Add another named tuple subclassing example.
2008-01-07 09:03:49 +00:00
Raymond Hettinger
1db6f80cd5
Cleanup subclassing example to more clearly show fixed-width print format.
2008-01-07 05:50:35 +00:00
Raymond Hettinger
b8e0072fec
Add subclassing example to docs for named tuples.
2008-01-07 04:24:49 +00:00
Raymond Hettinger
1166872006
Small code simplification. Forgot that classmethods can be called from intances.
2008-01-06 09:02:24 +00:00
Raymond Hettinger
1b50fd7cb3
Add error-checking to namedtuple's _replace() method.
2008-01-05 02:17:24 +00:00
Raymond Hettinger
02740f73ff
Improve namedtuple's _cast() method with a docstring, new name, and error-checking.
2008-01-05 01:35:43 +00:00
Raymond Hettinger
e0734e7dc0
Minor fix-ups to named tuples:
...
* Make the _replace() method respect subclassing.
* Using property() to make _fields read-only wasn't a good idea.
It caused len(Point._fields) to fail.
* Add note to _cast() about length checking and alternative with the star-operator.
2008-01-04 03:22:53 +00:00
Georg Brandl
b19be571e0
Some cleanup in the docs.
2007-12-29 10:57:00 +00:00
Raymond Hettinger
85dfcf3530
Users demand iterable input for named tuples. The author capitulates.
2007-12-18 23:51:15 +00:00
Raymond Hettinger
8777bcae27
Simplify and speedup _asdict() for named tuples.
2007-12-18 22:21:27 +00:00
Raymond Hettinger
88880b2dd6
Add more namedtuple() test cases. Neaten the code and comments.
2007-12-18 00:13:45 +00:00
Raymond Hettinger
e846f38c77
Add usage note
2007-12-14 21:51:50 +00:00
Raymond Hettinger
07ae83f840
Faster and simpler _replace() method
2007-12-14 19:19:59 +00:00
Raymond Hettinger
48eca67ab9
Add line spacing for readability
2007-12-14 18:08:20 +00:00
Raymond Hettinger
42da874cdd
Cleaner method naming convention
2007-12-14 02:49:47 +00:00
Raymond Hettinger
04a9a0e904
Simplify implementation of __replace__()
2007-12-13 22:55:52 +00:00
Raymond Hettinger
8465ae8cea
Fix signature in example
2007-11-17 01:51:22 +00:00
Raymond Hettinger
bc693491eb
Add example for use cases requiring default values.
2007-11-15 22:39:34 +00:00
Raymond Hettinger
7c3738e11c
Example of multiple replacements.
2007-11-15 03:16:09 +00:00
Raymond Hettinger
213ae014db
Fixup example in docs.
2007-11-15 02:58:20 +00:00
Raymond Hettinger
5681cbce81
Small improvement to the implementation of __replace__().
2007-11-15 02:55:42 +00:00
Raymond Hettinger
eeeb9c4445
Accept Issac Morland's suggestion for __replace__ to allow multiple replacements
...
(suprisingly, this simplifies the signature, improves clarity, and is comparably fast).
Update the docs to reflect a previous change to the function name.
Add an example to the docs showing how to override the default __repr__ method.
2007-11-15 02:44:53 +00:00
Raymond Hettinger
abfd8dff3b
More docs, error messages, and tests
2007-10-16 21:28:32 +00:00
Raymond Hettinger
68995867d5
Accept Jim Jewett's api suggestion to use None instead of -1 to indicate unbounded deques.
2007-10-10 00:26:46 +00:00
Raymond Hettinger
a48a29947a
Eliminate camelcase function name
2007-10-08 21:26:58 +00:00
Raymond Hettinger
b6893f2bf8
Missed a line in the docs
2007-10-08 09:56:29 +00:00