| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708 |
- .. :changelog:
- Release History
- ---------------
- 2.0.0 (2013-09-24)
- ++++++++++++++++++
- **API Changes:**
- - Keys in the Headers dictionary are now native strings on all Python versions,
- i.e. bytestrings on Python 2, unicode on Python 3.
- - Proxy URLs now *must* have an explicit scheme. A ``MissingSchema`` exception
- will be raised if they don't.
- - Timeouts now apply to read time if ``Stream=False``.
- - ``RequestException`` is now a subclass of ``IOError``, not ``RuntimeError``.
- - Added new method to ``PreparedRequest`` objects: ``PreparedRequest.copy()``.
- - Added new method to ``Session`` objects: ``Session.update_request()``. This
- method updates a ``Request`` object with the data (e.g. cookies) stored on
- the ``Session``.
- - Added new method to ``Session`` objects: ``Session.prepare_request()``. This
- method updates and prepares a ``Request`` object, and returns the
- corresponding ``PreparedRequest`` object.
- - Added new method to ``HTTPAdapter`` objects: ``HTTPAdapter.proxy_headers()``.
- This should not be called directly, but improves the subclass interface.
- - ``httplib.IncompleteRead`` exceptions caused by incorrect chunked encoding
- will now raise a Requests ``ChunkedEncodingError`` instead.
- - Invalid percent-escape sequences now cause a Requests ``InvalidURL``
- exception to be raised.
- - HTTP 208 no longer uses reason phrase ``"im_used"``. Correctly uses
- ``"already_reported"``.
- - HTTP 226 reason added (``"im_used"``).
- **Bugfixes:**
- - Vastly improved proxy support, including the CONNECT verb. Special thanks to
- the many contributors who worked towards this improvement.
- - Cookies are now properly managed when 401 authentication responses are
- received.
- - Chunked encoding fixes.
- - Support for mixed case schemes.
- - Better handling of streaming downloads.
- - Retrieve environment proxies from more locations.
- - Minor cookies fixes.
- - Imroved redirect behaviour.
- - Improved streaming behaviour, particularly for compressed data.
- - Miscellaneous small Python 3 text encoding bugs.
- - ``.netrc`` no longer overrides explicit auth.
- - Cookies set by hooks are now correctly persisted on Sessions.
- - Fix problem with cookies that specify port numbers in their host field.
- - ``BytesIO`` can be used to perform streaming uploads.
- - More generous parsing of the ``no_proxy`` environment variable.
- - Non-string objects can be passed in data values alongside files.
- 1.2.3 (2013-05-25)
- ++++++++++++++++++
- - Simple packaging fix
- 1.2.2 (2013-05-23)
- ++++++++++++++++++
- - Simple packaging fix
- 1.2.1 (2013-05-20)
- ++++++++++++++++++
- - Python 3.3.2 compatibility
- - Always percent-encode location headers
- - Fix connection adapter matching to be most-specific first
- - new argument to the default connection adapter for passing a block argument
- - prevent a KeyError when there's no link headers
- 1.2.0 (2013-03-31)
- ++++++++++++++++++
- - Fixed cookies on sessions and on requests
- - Significantly change how hooks are dispatched - hooks now receive all the
- arguments specified by the user when making a request so hooks can make a
- secondary request with the same parameters. This is especially necessary for
- authentication handler authors
- - certifi support was removed
- - Fixed bug where using OAuth 1 with body ``signature_type`` sent no data
- - Major proxy work thanks to @Lukasa including parsing of proxy authentication
- from the proxy url
- - Fix DigestAuth handling too many 401s
- - Update vendored urllib3 to include SSL bug fixes
- - Allow keyword arguments to be passed to ``json.loads()`` via the
- ``Response.json()`` method
- - Don't send ``Content-Length`` header by default on ``GET`` or ``HEAD``
- requests
- - Add ``elapsed`` attribute to ``Response`` objects to time how long a request
- took.
- - Fix ``RequestsCookieJar``
- - Sessions and Adapters are now picklable, i.e., can be used with the
- multiprocessing library
- - Update charade to version 1.0.3
- The change in how hooks are dispatched will likely cause a great deal of
- issues.
- 1.1.0 (2013-01-10)
- ++++++++++++++++++
- - CHUNKED REQUESTS
- - Support for iterable response bodies
- - Assume servers persist redirect params
- - Allow explicit content types to be specified for file data
- - Make merge_kwargs case-insensitive when looking up keys
- 1.0.3 (2012-12-18)
- ++++++++++++++++++
- - Fix file upload encoding bug
- - Fix cookie behavior
- 1.0.2 (2012-12-17)
- ++++++++++++++++++
- - Proxy fix for HTTPAdapter.
- 1.0.1 (2012-12-17)
- ++++++++++++++++++
- - Cert verification exception bug.
- - Proxy fix for HTTPAdapter.
- 1.0.0 (2012-12-17)
- ++++++++++++++++++
- - Massive Refactor and Simplification
- - Switch to Apache 2.0 license
- - Swappable Connection Adapters
- - Mountable Connection Adapters
- - Mutable ProcessedRequest chain
- - /s/prefetch/stream
- - Removal of all configuration
- - Standard library logging
- - Make Response.json() callable, not property.
- - Usage of new charade project, which provides python 2 and 3 simultaneous chardet.
- - Removal of all hooks except 'response'
- - Removal of all authentication helpers (OAuth, Kerberos)
- This is not a backwards compatible change.
- 0.14.2 (2012-10-27)
- +++++++++++++++++++
- - Improved mime-compatible JSON handling
- - Proxy fixes
- - Path hack fixes
- - Case-Insensistive Content-Encoding headers
- - Support for CJK parameters in form posts
- 0.14.1 (2012-10-01)
- +++++++++++++++++++
- - Python 3.3 Compatibility
- - Simply default accept-encoding
- - Bugfixes
- 0.14.0 (2012-09-02)
- ++++++++++++++++++++
- - No more iter_content errors if already downloaded.
- 0.13.9 (2012-08-25)
- +++++++++++++++++++
- - Fix for OAuth + POSTs
- - Remove exception eating from dispatch_hook
- - General bugfixes
- 0.13.8 (2012-08-21)
- +++++++++++++++++++
- - Incredible Link header support :)
- 0.13.7 (2012-08-19)
- +++++++++++++++++++
- - Support for (key, value) lists everywhere.
- - Digest Authentication improvements.
- - Ensure proxy exclusions work properly.
- - Clearer UnicodeError exceptions.
- - Automatic casting of URLs to tsrings (fURL and such)
- - Bugfixes.
- 0.13.6 (2012-08-06)
- +++++++++++++++++++
- - Long awaited fix for hanging connections!
- 0.13.5 (2012-07-27)
- +++++++++++++++++++
- - Packaging fix
- 0.13.4 (2012-07-27)
- +++++++++++++++++++
- - GSSAPI/Kerberos authentication!
- - App Engine 2.7 Fixes!
- - Fix leaking connections (from urllib3 update)
- - OAuthlib path hack fix
- - OAuthlib URL parameters fix.
- 0.13.3 (2012-07-12)
- +++++++++++++++++++
- - Use simplejson if available.
- - Do not hide SSLErrors behind Timeouts.
- - Fixed param handling with urls containing fragments.
- - Significantly improved information in User Agent.
- - client certificates are ignored when verify=False
- 0.13.2 (2012-06-28)
- +++++++++++++++++++
- - Zero dependencies (once again)!
- - New: Response.reason
- - Sign querystring parameters in OAuth 1.0
- - Client certificates no longer ignored when verify=False
- - Add openSUSE certificate support
- 0.13.1 (2012-06-07)
- +++++++++++++++++++
- - Allow passing a file or file-like object as data.
- - Allow hooks to return responses that indicate errors.
- - Fix Response.text and Response.json for body-less responses.
- 0.13.0 (2012-05-29)
- +++++++++++++++++++
- - Removal of Requests.async in favor of `grequests <https://github.com/kennethreitz/grequests>`_
- - Allow disabling of cookie persistiance.
- - New implimentation of safe_mode
- - cookies.get now supports default argument
- - Session cookies not saved when Session.request is called with return_response=False
- - Env: no_proxy support.
- - RequestsCookieJar improvements.
- - Various bug fixes.
- 0.12.1 (2012-05-08)
- +++++++++++++++++++
- - New ``Response.json`` property.
- - Ability to add string file uploads.
- - Fix out-of-range issue with iter_lines.
- - Fix iter_content default size.
- - Fix POST redirects containing files.
- 0.12.0 (2012-05-02)
- +++++++++++++++++++
- - EXPERIMENTAL OAUTH SUPPORT!
- - Proper CookieJar-backed cookies interface with awesome dict-like interface.
- - Speed fix for non-iterated content chunks.
- - Move ``pre_request`` to a more usable place.
- - New ``pre_send`` hook.
- - Lazily encode data, params, files.
- - Load system Certificate Bundle if ``certify`` isn't available.
- - Cleanups, fixes.
- 0.11.2 (2012-04-22)
- +++++++++++++++++++
- - Attempt to use the OS's certificate bundle if ``certifi`` isn't available.
- - Infinite digest auth redirect fix.
- - Multi-part file upload improvements.
- - Fix decoding of invalid %encodings in URLs.
- - If there is no content in a response don't throw an error the second time that content is attempted to be read.
- - Upload data on redirects.
- 0.11.1 (2012-03-30)
- +++++++++++++++++++
- * POST redirects now break RFC to do what browsers do: Follow up with a GET.
- * New ``strict_mode`` configuration to disable new redirect behavior.
- 0.11.0 (2012-03-14)
- +++++++++++++++++++
- * Private SSL Certificate support
- * Remove select.poll from Gevent monkeypatching
- * Remove redundant generator for chunked transfer encoding
- * Fix: Response.ok raises Timeout Exception in safe_mode
- 0.10.8 (2012-03-09)
- +++++++++++++++++++
- * Generate chunked ValueError fix
- * Proxy configuration by environment variables
- * Simplification of iter_lines.
- * New `trust_env` configuration for disabling system/environment hints.
- * Suppress cookie errors.
- 0.10.7 (2012-03-07)
- +++++++++++++++++++
- * `encode_uri` = False
- 0.10.6 (2012-02-25)
- +++++++++++++++++++
- * Allow '=' in cookies.
- 0.10.5 (2012-02-25)
- +++++++++++++++++++
- * Response body with 0 content-length fix.
- * New async.imap.
- * Don't fail on netrc.
- 0.10.4 (2012-02-20)
- +++++++++++++++++++
- * Honor netrc.
- 0.10.3 (2012-02-20)
- +++++++++++++++++++
- * HEAD requests don't follow redirects anymore.
- * raise_for_status() doesn't raise for 3xx anymore.
- * Make Session objects picklable.
- * ValueError for invalid schema URLs.
- 0.10.2 (2012-01-15)
- +++++++++++++++++++
- * Vastly improved URL quoting.
- * Additional allowed cookie key values.
- * Attempted fix for "Too many open files" Error
- * Replace unicode errors on first pass, no need for second pass.
- * Append '/' to bare-domain urls before query insertion.
- * Exceptions now inherit from RuntimeError.
- * Binary uploads + auth fix.
- * Bugfixes.
- 0.10.1 (2012-01-23)
- +++++++++++++++++++
- * PYTHON 3 SUPPORT!
- * Dropped 2.5 Support. (*Backwards Incompatible*)
- 0.10.0 (2012-01-21)
- +++++++++++++++++++
- * ``Response.content`` is now bytes-only. (*Backwards Incompatible*)
- * New ``Response.text`` is unicode-only.
- * If no ``Response.encoding`` is specified and ``chardet`` is available, ``Respoonse.text`` will guess an encoding.
- * Default to ISO-8859-1 (Western) encoding for "text" subtypes.
- * Removal of `decode_unicode`. (*Backwards Incompatible*)
- * New multiple-hooks system.
- * New ``Response.register_hook`` for registering hooks within the pipeline.
- * ``Response.url`` is now Unicode.
- 0.9.3 (2012-01-18)
- ++++++++++++++++++
- * SSL verify=False bugfix (apparent on windows machines).
- 0.9.2 (2012-01-18)
- ++++++++++++++++++
- * Asynchronous async.send method.
- * Support for proper chunk streams with boundaries.
- * session argument for Session classes.
- * Print entire hook tracebacks, not just exception instance.
- * Fix response.iter_lines from pending next line.
- * Fix but in HTTP-digest auth w/ URI having query strings.
- * Fix in Event Hooks section.
- * Urllib3 update.
- 0.9.1 (2012-01-06)
- ++++++++++++++++++
- * danger_mode for automatic Response.raise_for_status()
- * Response.iter_lines refactor
- 0.9.0 (2011-12-28)
- ++++++++++++++++++
- * verify ssl is default.
- 0.8.9 (2011-12-28)
- ++++++++++++++++++
- * Packaging fix.
- 0.8.8 (2011-12-28)
- ++++++++++++++++++
- * SSL CERT VERIFICATION!
- * Release of Cerifi: Mozilla's cert list.
- * New 'verify' argument for SSL requests.
- * Urllib3 update.
- 0.8.7 (2011-12-24)
- ++++++++++++++++++
- * iter_lines last-line truncation fix
- * Force safe_mode for async requests
- * Handle safe_mode exceptions more consistently
- * Fix iteration on null responses in safe_mode
- 0.8.6 (2011-12-18)
- ++++++++++++++++++
- * Socket timeout fixes.
- * Proxy Authorization support.
- 0.8.5 (2011-12-14)
- ++++++++++++++++++
- * Response.iter_lines!
- 0.8.4 (2011-12-11)
- ++++++++++++++++++
- * Prefetch bugfix.
- * Added license to installed version.
- 0.8.3 (2011-11-27)
- ++++++++++++++++++
- * Converted auth system to use simpler callable objects.
- * New session parameter to API methods.
- * Display full URL while logging.
- 0.8.2 (2011-11-19)
- ++++++++++++++++++
- * New Unicode decoding system, based on over-ridable `Response.encoding`.
- * Proper URL slash-quote handling.
- * Cookies with ``[``, ``]``, and ``_`` allowed.
- 0.8.1 (2011-11-15)
- ++++++++++++++++++
- * URL Request path fix
- * Proxy fix.
- * Timeouts fix.
- 0.8.0 (2011-11-13)
- ++++++++++++++++++
- * Keep-alive support!
- * Complete removal of Urllib2
- * Complete removal of Poster
- * Complete removal of CookieJars
- * New ConnectionError raising
- * Safe_mode for error catching
- * prefetch parameter for request methods
- * OPTION method
- * Async pool size throttling
- * File uploads send real names
- * Vendored in urllib3
- 0.7.6 (2011-11-07)
- ++++++++++++++++++
- * Digest authentication bugfix (attach query data to path)
- 0.7.5 (2011-11-04)
- ++++++++++++++++++
- * Response.content = None if there was an invalid repsonse.
- * Redirection auth handling.
- 0.7.4 (2011-10-26)
- ++++++++++++++++++
- * Session Hooks fix.
- 0.7.3 (2011-10-23)
- ++++++++++++++++++
- * Digest Auth fix.
- 0.7.2 (2011-10-23)
- ++++++++++++++++++
- * PATCH Fix.
- 0.7.1 (2011-10-23)
- ++++++++++++++++++
- * Move away from urllib2 authentication handling.
- * Fully Remove AuthManager, AuthObject, &c.
- * New tuple-based auth system with handler callbacks.
- 0.7.0 (2011-10-22)
- ++++++++++++++++++
- * Sessions are now the primary interface.
- * Deprecated InvalidMethodException.
- * PATCH fix.
- * New config system (no more global settings).
- 0.6.6 (2011-10-19)
- ++++++++++++++++++
- * Session parameter bugfix (params merging).
- 0.6.5 (2011-10-18)
- ++++++++++++++++++
- * Offline (fast) test suite.
- * Session dictionary argument merging.
- 0.6.4 (2011-10-13)
- ++++++++++++++++++
- * Automatic decoding of unicode, based on HTTP Headers.
- * New ``decode_unicode`` setting.
- * Removal of ``r.read/close`` methods.
- * New ``r.faw`` interface for advanced response usage.*
- * Automatic expansion of parameterized headers.
- 0.6.3 (2011-10-13)
- ++++++++++++++++++
- * Beautiful ``requests.async`` module, for making async requests w/ gevent.
- 0.6.2 (2011-10-09)
- ++++++++++++++++++
- * GET/HEAD obeys allow_redirects=False.
- 0.6.1 (2011-08-20)
- ++++++++++++++++++
- * Enhanced status codes experience ``\o/``
- * Set a maximum number of redirects (``settings.max_redirects``)
- * Full Unicode URL support
- * Support for protocol-less redirects.
- * Allow for arbitrary request types.
- * Bugfixes
- 0.6.0 (2011-08-17)
- ++++++++++++++++++
- * New callback hook system
- * New persistient sessions object and context manager
- * Transparent Dict-cookie handling
- * Status code reference object
- * Removed Response.cached
- * Added Response.request
- * All args are kwargs
- * Relative redirect support
- * HTTPError handling improvements
- * Improved https testing
- * Bugfixes
- 0.5.1 (2011-07-23)
- ++++++++++++++++++
- * International Domain Name Support!
- * Access headers without fetching entire body (``read()``)
- * Use lists as dicts for parameters
- * Add Forced Basic Authentication
- * Forced Basic is default authentication type
- * ``python-requests.org`` default User-Agent header
- * CaseInsensitiveDict lower-case caching
- * Response.history bugfix
- 0.5.0 (2011-06-21)
- ++++++++++++++++++
- * PATCH Support
- * Support for Proxies
- * HTTPBin Test Suite
- * Redirect Fixes
- * settings.verbose stream writing
- * Querystrings for all methods
- * URLErrors (Connection Refused, Timeout, Invalid URLs) are treated as explicity raised
- ``r.requests.get('hwe://blah'); r.raise_for_status()``
- 0.4.1 (2011-05-22)
- ++++++++++++++++++
- * Improved Redirection Handling
- * New 'allow_redirects' param for following non-GET/HEAD Redirects
- * Settings module refactoring
- 0.4.0 (2011-05-15)
- ++++++++++++++++++
- * Response.history: list of redirected responses
- * Case-Insensitive Header Dictionaries!
- * Unicode URLs
- 0.3.4 (2011-05-14)
- ++++++++++++++++++
- * Urllib2 HTTPAuthentication Recursion fix (Basic/Digest)
- * Internal Refactor
- * Bytes data upload Bugfix
- 0.3.3 (2011-05-12)
- ++++++++++++++++++
- * Request timeouts
- * Unicode url-encoded data
- * Settings context manager and module
- 0.3.2 (2011-04-15)
- ++++++++++++++++++
- * Automatic Decompression of GZip Encoded Content
- * AutoAuth Support for Tupled HTTP Auth
- 0.3.1 (2011-04-01)
- ++++++++++++++++++
- * Cookie Changes
- * Response.read()
- * Poster fix
- 0.3.0 (2011-02-25)
- ++++++++++++++++++
- * Automatic Authentication API Change
- * Smarter Query URL Parameterization
- * Allow file uploads and POST data together
- * New Authentication Manager System
- - Simpler Basic HTTP System
- - Supports all build-in urllib2 Auths
- - Allows for custom Auth Handlers
- 0.2.4 (2011-02-19)
- ++++++++++++++++++
- * Python 2.5 Support
- * PyPy-c v1.4 Support
- * Auto-Authentication tests
- * Improved Request object constructor
- 0.2.3 (2011-02-15)
- ++++++++++++++++++
- * New HTTPHandling Methods
- - Response.__nonzero__ (false if bad HTTP Status)
- - Response.ok (True if expected HTTP Status)
- - Response.error (Logged HTTPError if bad HTTP Status)
- - Response.raise_for_status() (Raises stored HTTPError)
- 0.2.2 (2011-02-14)
- ++++++++++++++++++
- * Still handles request in the event of an HTTPError. (Issue #2)
- * Eventlet and Gevent Monkeypatch support.
- * Cookie Support (Issue #1)
- 0.2.1 (2011-02-14)
- ++++++++++++++++++
- * Added file attribute to POST and PUT requests for multipart-encode file uploads.
- * Added Request.url attribute for context and redirects
- 0.2.0 (2011-02-14)
- ++++++++++++++++++
- * Birth!
- 0.0.1 (2011-02-13)
- ++++++++++++++++++
- * Frustration
- * Conception
|