Commit Graph

15881 Commits

Author SHA1 Message Date
Victor Stinner 1c4b892d71 Add a sequence diagram for the chained coroutines example 2013-12-12 12:35:17 +01:00
R David Murray 50bfbb9903 #19063: fix set_payload handling of non-ASCII string input.
This version of the fix raises an error instead of accepting the invalid
input (ie: if a non-ASCII string is used but no charset is specified).
2013-12-11 16:52:11 -05:00
Eric Snow b282b3d804 Issue #18864: Add a setter for ModuleSpec.has_location. 2013-12-10 22:16:41 -07:00
Nick Coghlan 1f609e9b02 Issue #19407: merge PPUG notes from 3.3 2013-12-10 21:31:14 +10:00
Nick Coghlan b5c4fd0a96 Issue #19407: add Python Packaging User Guide notes
The stdlib docs for package distribution and building extensions
are rather dated, and that isn't expected to change for 2.7 and
3.3.

The Python Packaging User Guide isn't complete either, but it's
already a much better road map for new users than the existing
stdlib docs.
2013-12-10 21:24:55 +10:00
Victor Stinner a6fa15367f asyncio doc: simplify task example 2013-12-10 12:20:14 +01:00
Victor Stinner 0839ed4730 asyncio doc: don't document Task.cancel(), already documented in Future.cancel() 2013-12-10 12:18:15 +01:00
Victor Stinner 742520be43 asyncio: document Task.current_task() 2013-12-10 12:14:50 +01:00
Victor Stinner fc25d629ab asyncio: don't document private functions 2013-12-10 02:52:49 +01:00
Victor Stinner 34f2946a11 asyncio: fix 2nd task example 2013-12-10 02:51:05 +01:00
Victor Stinner dbd8950b28 asyncio doc: rewrite the callback hello world to use call_soon() instead of a
direct call.
2013-12-10 02:47:22 +01:00
Victor Stinner b69d62dcac assyncio doc: rewrite, improve and move coroutine, Future and Task examples 2013-12-10 02:09:46 +01:00
Stefan Krah 29e64548c5 Fix typo. 2013-12-09 19:18:59 +01:00
Stefan Krah 345ec35da3 Fix whitespace. 2013-12-09 19:11:05 +01:00
Stefan Krah 2d181de44c Merge 3.3. 2013-12-09 19:03:24 +01:00
Victor Stinner a881a7f205 asyncio doc: explain why the loop is running twice 2013-12-09 13:19:23 +01:00
Victor Stinner d8f11e9265 asyncio: another Future example using add_done_callback() 2013-12-09 13:04:12 +01:00
Victor Stinner 45c2fd9f8a asyncio doc: add an example with Future 2013-12-09 12:40:17 +01:00
Stefan Krah 1761fa9dd1 Add libmpdec license. 2013-12-08 20:54:02 +01:00
Nadeem Vawda bd6932a576 Closes #18430: Document that peek() may change the position of the underlying
file for the BZ2File, GzipFile and LZMAFile classes.
2013-12-08 19:50:05 +01:00
Nadeem Vawda 6976104a36 #18430: Document that peek() may change the position of the underlying file for
the BZ2File, GzipFile and LZMAFile classes.
2013-12-08 19:47:22 +01:00
doko@ubuntu.com ca616a2709 - Issue #19736: Add module-level statvfs constants defined for GNU/glibc
based systems.
2013-12-08 15:23:07 +01:00
Christian Heimes 5bb414d176 Issue #19343: Expose FreeBSD-specific APIs in resource module. Original patch by Koobs. 2013-12-08 14:35:55 +01:00
Guido van Rossum 9710ff04ac Silently ignore unregistering closed files. Fixes issue 19876. With docs and slight test refactor. 2013-12-07 15:57:01 -08:00
Alexandre Vassalotti d05c9ff845 Issue #6784: Strings from Python 2 can now be unpickled as bytes objects.
Initial patch by Merlijn van Deen.

I've added a few unrelated docstring fixes in the patch while I was at
it, which makes the documentation for pickle a bit more consistent.
2013-12-07 01:09:27 -08:00
Benjamin Peterson d45a46b60d merge 3.3 (#19910) 2013-12-06 20:12:51 -05:00
Benjamin Peterson 933142a8f2 document that compile() can take bytes (closes #19910) 2013-12-06 20:12:39 -05:00
Antoine Pitrou 9bcb1127f1 Mention pickle protocol 4, and some tweaks. 2013-12-07 01:05:57 +01:00
Antoine Pitrou 9858e8b98d Issue #19900: improve generalities at the start of the pickle module doc 2013-12-07 00:57:44 +01:00
Antoine Pitrou d4d60554bc Issue #19900: improve generalities at the start of the pickle module doc 2013-12-07 00:56:59 +01:00
Vinay Sajip 1b8b868b84 Merged minor documentation update from 3.3. 2013-12-06 11:23:08 +00:00
Vinay Sajip b1a92a4c89 Added minor clarification in logging HOWTO. 2013-12-06 11:22:24 +00:00
Antoine Pitrou 710280b6d6 Issue #18840: Introduce the json module in the tutorial, and deemphasize the pickle module. 2013-12-05 23:48:10 +01:00
Antoine Pitrou dd799d2e32 Issue #18840: Introduce the json module in the tutorial, and deemphasize the pickle module. 2013-12-05 23:46:32 +01:00
Antoine Pitrou f9c54944df Merge socket doc changes from 3.3 2013-12-04 21:15:24 +01:00
Antoine Pitrou a5cc9d68b9 Tweak the socket module doc layout 2013-12-04 21:11:03 +01:00
Antoine Pitrou e3658a70c3 Issue #19882: tweak docs for socket.close() 2013-12-04 21:02:42 +01:00
Victor Stinner 31d83228c2 asyncio doc: add some notes on the ping example 2013-12-04 11:16:17 +01:00
Victor Stinner 99c2ab4b83 asyncio doc: oh, asyncio module has its own Future class
Improve also wait() documentation: mention that the first parameter is a
sequence
2013-12-03 19:17:25 +01:00
Victor Stinner cf6f72e329 Fix typo in asyncio.AbstractServer documentation 2013-12-03 18:23:52 +01:00
Victor Stinner c6fba92ebc asyncio doc: add one more example of coroutines 2013-12-03 17:37:31 +01:00
Victor Stinner 85a2be7da7 ayncio: replace the disclamer with a seealso section 2013-12-03 15:04:36 +01:00
Victor Stinner 15faa9c8ad asyncio doc: simplify ping example, remove the useless timeout 2013-12-03 15:04:18 +01:00
Victor Stinner afbf827875 asyncio doc: fix definition of stop() method 2013-12-03 02:05:42 +01:00
Victor Stinner 933a8c82ce asyncio doc: reorder methods; typo 2013-12-03 01:59:38 +01:00
Victor Stinner 1ca5ba611b asyncio io: group transports and protocols in a new title 2013-12-03 01:49:43 +01:00
Victor Stinner 0c6f1ca40c asyncio doc: write a complete TCP echo example, client and server
Example based on tcp_echo.py example from Tulip source code.
2013-12-03 01:46:39 +01:00
Victor Stinner 3e09e32c8a asyncio doc: move coroutine example to the Task page 2013-12-03 01:22:06 +01:00
Victor Stinner ea3183f5b8 Split asyncio documentation into subfiles 2013-12-03 01:08:00 +01:00
Victor Stinner fa2ce78a21 asyncio doc: change level of titles
Remove also a duplicated Protocols section!
2013-12-03 00:56:27 +01:00
Victor Stinner b3be72cac3 asyncio doc: reorder sections 2013-12-03 00:49:26 +01:00
Victor Stinner 34d8df5171 asyncio: document wait() function 2013-12-03 00:42:59 +01:00
Victor Stinner dd339a248c asyncio doc
* complete create_connection() prototype
* link to Server
* document get_extra_info() keys
2013-12-03 00:32:48 +01:00
Christian Heimes a5768f7292 Issue #19785: smtplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 20:44:17 +01:00
Christian Heimes 216d463b1f Issue #19783: nntplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 20:20:11 +01:00
Christian Heimes 1bc7068d7f Issue #19784: poplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 20:10:50 +01:00
Christian Heimes b8a3f58158 merge 2013-12-02 20:02:04 +01:00
Christian Heimes 48aae57996 Issue #19782: imaplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 20:01:29 +01:00
Serhiy Storchaka 6de88b3107 Fixed formatting (was parsed as description list). 2013-12-02 20:31:00 +02:00
Serhiy Storchaka 475546facf Fixed regex match representation in an example. 2013-12-02 20:23:19 +02:00
Victor Stinner 0c924b83ee asyncio: sort some methods 2013-12-02 17:52:31 +01:00
Victor Stinner b09f9b33d2 asyncio doc: group transport method by classes
Declare classes because they are mentionned in documentation of other functions
2013-12-02 17:46:04 +01:00
Victor Stinner e91f180efe asyncio: more documentation 2013-12-02 17:40:48 +01:00
Victor Stinner be490633be asyncio: document network functions, and stream reader/writer 2013-12-02 17:28:32 +01:00
Eli Bendersky b55c4d4539 Issue #19814: Clarify argparse's docs w.r.t prefix matching 2013-12-02 05:50:48 -08:00
Eli Bendersky f3114532e4 Issue #19814: Clarify argparse's docs w.r.t prefix matching 2013-12-02 05:49:54 -08:00
Victor Stinner c37dd614b6 asyncio: document locks 2013-12-02 14:31:16 +01:00
Victor Stinner 0da1d29c8a asyncio: document Queue classes 2013-12-02 14:06:03 +01:00
Victor Stinner 60efaae4f9 Document Task class and task functions 2013-12-02 13:47:23 +01:00
Victor Stinner 3c3c4f5a11 asyncio: cleanup doc 2013-12-02 13:04:25 +01:00
Victor Stinner 550a09ef86 Issue #19833: Document more asyncio.BaseEventLoop methods 2013-12-02 12:41:54 +01:00
Victor Stinner 4e70bb84e6 Issue #19833: add 2 examples to asyncio doc (hello world) 2013-12-02 12:21:30 +01:00
Victor Stinner 8dc434e092 Issue #19833: asyncio doc: add class name to methods 2013-12-02 12:20:57 +01:00
Victor Stinner 5f5657ee50 (Merge 3.3) Issue #19728: Fix sys.getfilesystemencoding() documentation 2013-12-02 12:17:29 +01:00
Victor Stinner 22d0418f71 Issue #19728: Fix sys.getfilesystemencoding() documentation 2013-12-02 12:16:46 +01:00
Christian Heimes e5b5edfa2c Issue #19781: ftplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 02:56:02 +01:00
Christian Heimes 1aa9a75fbf Issue #19509: Add SSLContext.check_hostname to match the peer's certificate
with server_hostname on handshake.
2013-12-02 02:41:19 +01:00
Charles-François Natali 837a6e012f Issue #19849: selectors: Document the possibility of early select() wakeup upon
EINTR.
2013-12-01 13:23:48 +01:00
Zachary Ware 7c63c85f17 Issue #19845: Updated the Compiling Python on Windows docs. 2013-11-30 17:03:03 -06:00
Zachary Ware f8ceb04fcf Issue #19845: Updated the Compiling Python on Windows docs. 2013-11-30 16:59:33 -06:00
Vinay Sajip 8b1e2f351d Closes #19789: Merged update from 3.3. 2013-11-30 22:46:29 +00:00
Vinay Sajip a9c179bd3e Issue #19789: Clarified documentation for logging.disable. 2013-11-30 22:45:29 +00:00
Guido van Rossum 8519e5ade6 More realistic example for selectors.py. 2013-11-29 14:51:18 -08:00
Charles-François Natali a951f3d1ac Remove trailing blanks. 2013-11-29 18:57:47 +01:00
Charles-François Natali a9f90bc602 Set the FDs non-blocking in the selectors example. 2013-11-29 18:52:51 +01:00
Serhiy Storchaka 0e90e99188 Issue #19795: Improved markup of True/False constants. 2013-11-29 12:19:53 +02:00
Serhiy Storchaka fbc1c26803 Issue #19795: Improved markup of True/False constants. 2013-11-29 12:17:13 +02:00
Eli Bendersky b6e66ebdf7 Some minor clarifications in the documentation of pathlib + inheritance diagram 2013-11-28 06:53:05 -08:00
Serhiy Storchaka 889d24ee3a Revert unrelated changes introduced by changeset b2066bc8cab9 (issue #19795). 2013-11-29 23:40:35 +02:00
Ned Deily c034156f26 Change pathlib documentation to use "raise" instead of "throw". 2013-11-27 14:42:55 -08:00
Victor Stinner 5362abf4ec Issue #19818: tracemalloc, the number of frame limit cannot be zero anymore 2013-11-27 23:39:55 +01:00
Victor Stinner 3c0481d426 Close #19798: replace "maximum" term with "peak" in get_traced_memory()
documentation. Use also the term "current" for the current size.
2013-11-27 21:39:49 +01:00
Benjamin Peterson 5143ce5a01 merge 3.3 (#19805) 2013-11-26 23:05:37 -06:00
Benjamin Peterson b152e177ef recommend OrderedDict for this FAQ (closes #19805) 2013-11-26 23:05:25 -06:00
Serhiy Storchaka 03cc56539f Issue #19793: Improved markup for True/False constants in pathlib documentation. 2013-11-26 21:37:12 +02:00
Serhiy Storchaka 6bfe39272e Issue #19794: Improved markup for True/False constants. 2013-11-26 17:33:13 +02:00
Serhiy Storchaka 22dc4d5fa8 Issue #19794: Improved markup for True/False constants. 2013-11-26 17:32:16 +02:00
Georg Brandl 5831882c08 merge with 3.3 2013-11-26 08:25:45 +01:00
Georg Brandl 1833ac37b5 Markup fix. 2013-11-26 08:25:24 +01:00
Victor Stinner 8e3708d88b Issue #18874: allow to call tracemalloc.Snapshot.statistics(cumulative=True)
with traceback_limit=1
2013-11-26 00:45:47 +01:00
Victor Stinner 00773df9f3 Issue #18874: apply Jim Jewett's patch on tracemalloc doc 2013-11-26 00:40:10 +01:00
Ezio Melotti dd7e291dc3 #13592, #17087: add whatsnew entry about regex/match object repr improvements. 2013-11-25 23:20:20 +02:00
Ezio Melotti 613a97e193 #19778: fix a couple of re reprs in the documentation. 2013-11-25 22:47:01 +02:00
Antoine Pitrou c7cf5fca7c Issue #19691: remove outdated mention about RuntimeError 2013-11-25 19:11:07 +01:00
Antoine Pitrou 9527f16bf4 Issue #19691: remove outdated mention about RuntimeError 2013-11-25 19:08:32 +01:00
Victor Stinner d2736affa1 Mention the new tracemalloc module in the What's New in Python 3.4 document 2013-11-25 09:40:27 +01:00
Georg Brandl d476ab1276 merge with 3.3 2013-11-25 08:52:24 +01:00
Georg Brandl 37b70bb908 Closes #19622: clarify message about bufsize changes in 3.2.4 and 3.3.1. 2013-11-25 08:48:37 +01:00
Georg Brandl db5e74fab3 Fix doc markup error. 2013-11-25 08:29:44 +01:00
Ezio Melotti fb310a9ec6 Merge broken link fix from 3.3. 2013-11-25 06:41:00 +02:00
Ezio Melotti f5005883ba Fix broken link in html.entities docs. 2013-11-25 06:40:12 +02:00
Ezio Melotti 250a06c3cb Add whatsnew section about the html package. 2013-11-25 06:18:47 +02:00
Georg Brandl 4d01c4b6bb merge with 3.3 2013-11-24 16:18:23 +01:00
Georg Brandl 44d2429a25 Doc/Makefile: also do "make suspicious" during daily autobuild 2013-11-24 16:17:54 +01:00
Georg Brandl ed007d5b1b Fix suspicious markup in the docs. 2013-11-24 16:09:26 +01:00
Georg Brandl 472a65a710 Fix a few markup problems in the new import doc. 2013-11-24 12:39:56 +01:00
Zachary Ware a4b7a7548c Issue #3158: doctest can now find doctests in functions and methods
written in C.

As a part of this, a few doctests have been added to the builtins module
(on hex(), oct(), and bin()), a doctest has been fixed (hopefully on all
platforms) on float, and test_builtins now runs doctests in builtins.
2013-11-24 01:19:09 -06:00
Serhiy Storchaka d27b455bbc Issue #13477: Added command line interface to the tarfile module.
Original patch by Berker Peksag.
2013-11-24 01:53:29 +02:00
Larry Hastings 3a9079742f Issue #19722: Added opcode.stack_effect(), which accurately
computes the stack effect of bytecode instructions.
2013-11-23 14:49:22 -08:00
Serhiy Storchaka 32eddc1bbc Issue #16203: Add re.fullmatch() function and regex.fullmatch() method,
which anchor the pattern at both ends of the string to match.

Original patch by Matthew Barnett.
2013-11-23 23:20:30 +02:00
Serhiy Storchaka 3062c9a6c8 Issue #19641: Added the audioop.byteswap() function to convert big-endian
samples to little-endian and vice versa.
2013-11-23 22:26:01 +02:00
Serhiy Storchaka 6787a3806e Issue #15204: Deprecated the 'U' mode in file-like objects. 2013-11-23 22:12:06 +02:00
Ezio Melotti 6bdd98622e #10712: 2to3 has a new "asserts" fixer that replaces deprecated names of unittest methods. 2013-11-23 21:14:42 +02:00
Ezio Melotti 7571941db6 #19639: update the repr of the match objects in the docs. Patch by Claudiu Popa. 2013-11-23 20:27:27 +02:00
Antoine Pitrou c9dc4a2a8a Issue #17810: Implement PEP 3154, pickle protocol 4.
Most of the work is by Alexandre.
2013-11-23 18:59:12 +01:00
Ezio Melotti 95401c5f6b #13633: Added a new convert_charrefs keyword arg to HTMLParser that, when True, automatically converts all character references. 2013-11-23 19:52:05 +02:00
Serhiy Storchaka be0c3250b1 Issue #19668: Added support for the cp1125 encoding. 2013-11-23 18:52:23 +02:00
Antoine Pitrou 5bef410471 Tweak ssl docs 2013-11-23 16:16:29 +01:00
Christian Heimes 5de397e158 merge 2013-11-23 15:59:07 +01:00
Christian Heimes 4c05b472dd Issue #19689: Add ssl.create_default_context() factory function. It creates
a new SSLContext object with secure default settings.
2013-11-23 15:58:30 +01:00
Serhiy Storchaka 235c5e0dd6 Issue #17201: ZIP64 extensions now are enabled by default.
Patch by William Mallard.
2013-11-23 15:55:38 +02:00
Christian Heimes 6b2ff98df4 Correct documentation clientAuth -> CLIENT_AUTH 2013-11-23 14:42:01 +01:00
Christian Heimes 72d28500b3 Issue #19292: Add SSLContext.load_default_certs() to load default root CA
certificates from default stores or system stores. By default the method
loads CA certs for authentication of server certs.
2013-11-23 13:56:58 +01:00
Antoine Pitrou a30d82f597 Document create_connection 2013-11-23 13:55:35 +01:00
Antoine Pitrou 9a62a1987f Start documenting the event loop 2013-11-23 13:10:08 +01:00
Antoine Pitrou 4d1046c7e6 Document asyncio transport APIs 2013-11-23 12:50:52 +01:00
Victor Stinner 3728d6ced0 Issue #18874: Remove tracemalloc.set_traceback_limit()
tracemalloc.start() now has an option nframe parameter
2013-11-23 12:37:20 +01:00
Victor Stinner ed3b0bca3e Issue #18874: Implement the PEP 454 (tracemalloc) 2013-11-23 12:27:24 +01:00
Christian Heimes 2427b50fdd Issue #8813: X509_VERIFY_PARAM is only available on OpenSSL 0.9.8+
The patch removes the verify_flags feature on Mac OS X 10.4 with OpenSSL 0.9.7l 28 Sep 2006.
2013-11-23 11:24:32 +01:00
Ned Deily 44a0db0c1e Issue #19551: Update whatsnew. 2013-11-22 22:39:09 -08:00
Nick Coghlan 7bc4b3bee3 Update What's New with PEP 453 progress 2013-11-23 11:59:40 +10:00
Nick Coghlan 9c1aed8f94 Close #7475: Restore binary & text transform codecs
The codecs themselves were restored in Python 3.2, this
completes the restoration by adding back the convenience
aliases.

These aliases were originally left out due to confusing
errors when attempting to use them with the text encoding
specific convenience methods. Python 3.4 includes several
improvements to those errors, thus permitting the aliases
to be restored as well.
2013-11-23 11:13:36 +10:00
Guido van Rossum f8d0ff9f42 Add source link for asyncio. 2013-11-22 16:53:25 -08:00
Antoine Pitrou 74193af0cf Finish protocol documentation 2013-11-23 01:21:11 +01:00
Antoine Pitrou a035e1b000 Start documenting protocols 2013-11-23 01:08:43 +01:00
Guido van Rossum f0f5d3844a Mention threadpool interface in asyncio overview. 2013-11-22 15:45:02 -08:00
Antoine Pitrou bba8682200 Issue #19291: add crude stubs to the asyncio docs 2013-11-23 00:34:26 +01:00
Andrew Kuchling b3931d2111 Wording changes 2013-11-22 16:15:28 -05:00
Andrew Kuchling 7a4e2d1751 Wording changes to pathlib docs.
Only possibly-controversial change: joinpath() was described as:

  "Calling this method is equivalent to indexing the path with each of
  the *other* arguments in turn."

'Indexing' is an odd word to use, because you can't subscript Path or
PurePath objects, so I changed it to "combining".
2013-11-22 15:45:02 -05:00
Guido van Rossum 4da459c488 Fix markup of notes recommending asyncio. 2013-11-22 12:27:45 -08:00