Raymond Hettinger
bc512d3abd
Backport PEP 372: OrderedDict()
2009-03-03 04:45:34 +00:00
Raymond Hettinger
a665853bab
Clarify Counter() docs.
2009-02-25 22:48:24 +00:00
Raymond Hettinger
eb7cbb94c5
Restore Py2.x version of sample call to super().
2009-02-25 00:39:47 +00:00
Raymond Hettinger
f746a1f1e4
Fix-up intro paragraph for collections docs.
2009-02-17 08:33:01 +00:00
Raymond Hettinger
e4ae63c402
Clean-up named tuple docs.
2009-02-11 00:06:17 +00:00
Raymond Hettinger
322daea7c3
Issue 1818: collections.namedtuple() to support automatic renaming of invalid fieldnames.
2009-02-10 01:24:05 +00:00
Raymond Hettinger
939a3cc5a2
Tweak the docs for Counter() objects.
2009-02-04 11:31:30 +00:00
Raymond Hettinger
d507afdc81
Minor doc fixups.
2009-02-04 10:52:32 +00:00
Raymond Hettinger
1712baa852
Correct docs for ABCs (MutableSequence was missing __setiem). Simplify the table by taking out inherited requirements for abstract methods.
2009-01-28 23:58:16 +00:00
Raymond Hettinger
d081abc8be
Promote combinations_with_replacement() from a recipe to a regular itertool.
2009-01-27 02:58:49 +00:00
Raymond Hettinger
22bfa9e3e8
Tweak column alignment for collections docs.
2009-01-27 02:36:33 +00:00
Raymond Hettinger
2bcb8e9b0d
Promote compress() from a recipe to being a regular itertool.
2009-01-25 21:04:14 +00:00
Raymond Hettinger
7bdca05a3b
More doc tweaks.
2009-01-22 05:20:47 +00:00
Raymond Hettinger
0a1f7b8f72
Tighten-up the docs for Counter().
2009-01-21 23:12:51 +00:00
Raymond Hettinger
4571f347f9
Simplify explanation of multiset operations by removing restrictions on negative inputs.
2009-01-21 20:31:50 +00:00
Raymond Hettinger
acdc84abcf
Beautify and cleanup the references section.
2009-01-20 23:42:54 +00:00
Raymond Hettinger
196a0f7a8a
Fix typos.
2009-01-20 12:59:36 +00:00
Raymond Hettinger
230dd27628
Don't disrupt automatic url target name generation
...
with manually specified, conflicting names.
Before:
http://docs.python.org/dev/library/collections.html#id1
After:
http://docs.python.org/dev/library/collections.html#counter-objects
2009-01-20 07:11:47 +00:00
Raymond Hettinger
bad1eb2ff3
Build-outs for Counter() class:
...
* Constructor and update() support keyword args (like their dict counterparts).
* The 'del' statement no longer raises KeyError for missing values.
* Add multiset operations: __add__, __sub__, __and__, __or__.
2009-01-20 01:19:26 +00:00
Raymond Hettinger
2950bca89c
Fix-up indentation of sample code blocks for namedtuple mthod definitions.
2009-01-14 01:39:51 +00:00
Raymond Hettinger
59894127e4
Minor doc tweaks.
2009-01-14 00:15:21 +00:00
Raymond Hettinger
fbcf749479
Add table of idioms/patterns for using Counter objects.
...
Improve the appearance and flow of the References section -- it used
to have a box around it that wasn't distinct from the preceding code
boxes and it had a weird bolding pattern and hanging indents that
made the section disproportionately large.
2009-01-13 08:38:14 +00:00
Raymond Hettinger
8278385a05
Minor documentation tweaks and simpler update() example.
2009-01-13 03:49:43 +00:00
Raymond Hettinger
aaa6e630f8
Simplify Counter() API. Replace items keyword argument
...
with a mapping. Makes Counter() idempotent, makes update()
API the same as Counter.__init__(), makes a more readable
repr, makes the API more dict-like, and allows Steven
Bethard's update() example to work.
2009-01-13 01:05:03 +00:00
Raymond Hettinger
f94d7fa5fb
Issue 1696199: Add collections.Counter().
2009-01-12 22:58:41 +00:00
Georg Brandl
7044b11818
Remove tabs from the documentation.
2009-01-03 21:04:55 +00:00
Georg Brandl
c62ef8b4d9
Remove trailing whitespace.
2009-01-03 20:55:06 +00:00
Georg Brandl
df9bcf1196
Fix typo.
2008-11-24 16:16:07 +00:00
Georg Brandl
061d2e2ee9
#4392 : fix parameter name.
2008-11-23 19:17:25 +00:00
Benjamin Peterson
5c4e006367
document that deque indexing is O(n) #4123
2008-10-16 18:52:14 +00:00
Skip Montanaro
b40890db07
usage
2008-09-17 11:50:36 +00:00
Georg Brandl
dbc5987e2f
Add missing ABCs to list.
2008-07-08 07:05:23 +00:00
Raymond Hettinger
ee51cffc95
Fix whitespace in example code.
2008-06-27 21:34:24 +00:00
Raymond Hettinger
e98839a1f4
Issue3065: Fixed pickling of named tuples. Added tests.
2008-06-09 01:28:30 +00:00
Raymond Hettinger
96b424062b
Fix typo
2008-05-23 17:34:34 +00:00
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
Raymond Hettinger
2115bbc4da
Add comments to NamedTuple code.
...
Let the field spec be either a string or a non-string sequence (suggested by Martin Blais with use cases).
Improve the error message in the case of a SyntaxError (caused by a duplicate field name).
2007-10-08 09:14:28 +00:00
Raymond Hettinger
a7fc4b13e0
Add __asdict__() to NamedTuple and refine the docs.
...
Add maxlen support to deque() and fixup docs.
Partially fix __reduce__(). The None as a third arg was no longer supported.
Still needs work on __reduce__() to handle recursive inputs.
2007-10-05 02:47:07 +00:00
Raymond Hettinger
7268e9d1ff
Fit nits
2007-09-20 03:03:43 +00:00
Raymond Hettinger
cbab5949c9
Cleanup docs for NamedTuple.
2007-09-18 22:18:02 +00:00
Raymond Hettinger
2b03d45bb9
Handle corner cased on 0-tuples and 1-tuples. Add verbose option so people can see how it works.
2007-09-18 03:33:19 +00:00
Raymond Hettinger
d36a60e1e3
Sync-up named tuples with the latest version of the ASPN recipe.
...
Allows optional commas in the field-name spec (help when named tuples are used in conjuction with sql queries).
Adds the __fields__ attribute for introspection and to support conversion to dictionary form.
Adds a __replace__() method similar to str.replace() but using a named field as a target.
Clean-up spelling and presentation in doc-strings.
2007-09-17 00:55:00 +00:00
Mark Summerfield
7f626f4c34
Added more cross-references.
2007-08-30 15:03:03 +00:00
Georg Brandl
8ec7f65613
Move the 2.6 reST doc tree in place.
2007-08-15 14:28:01 +00:00