diff options
| author | Kenneth Reitz <me@kennethreitz.com> | 2012-12-23 02:13:31 -0500 |
|---|---|---|
| committer | Kenneth Reitz <me@kennethreitz.com> | 2012-12-23 02:13:31 -0500 |
| commit | 08f66a99b17e59355e2aeaf2d37244b18b69f6e1 (patch) | |
| tree | 6fca85c2d55f555d9ac5d51b1cf20dd404b53bfd /docs/dev | |
| parent | ab64052642f8de84873e2b449e06c96363a0afad (diff) | |
| download | python-requests-08f66a99b17e59355e2aeaf2d37244b18b69f6e1.tar.gz | |
semantic versioning
Diffstat (limited to 'docs/dev')
| -rw-r--r-- | docs/dev/philosophy.rst | 10 | ||||
| -rw-r--r-- | docs/dev/todo.rst | 31 |
2 files changed, 27 insertions, 14 deletions
diff --git a/docs/dev/philosophy.rst b/docs/dev/philosophy.rst index 0569e382..a7402218 100644 --- a/docs/dev/philosophy.rst +++ b/docs/dev/philosophy.rst @@ -12,8 +12,14 @@ Benevolent Dictator for Life Values ~~~~~~ - - Simplicity is always better than functionality. - Listen to everyone, then disregard it. - The API is all that matters. Everything else is secondary. -- Fit the 90% use-case. Ignore the nay-sayers.
\ No newline at end of file +- Fit the 90% use-case. Ignore the nay-sayers. + +Semantic Versioning +~~~~~~~~~~~~~~~~~~~ + +For many years, the open source community has been plagued with version number dystonia. Numbers vary so greatly from project to project, they are practically meaningless. + +Requests uses `Semantic Versioning <http://semver.org>`_. This specification seeks to put an end to this madness with a small set of practical guidelines for you and your colleagues to use in your next project.
\ No newline at end of file diff --git a/docs/dev/todo.rst b/docs/dev/todo.rst index 6931147a..c3014566 100644 --- a/docs/dev/todo.rst +++ b/docs/dev/todo.rst @@ -12,7 +12,7 @@ Requests is under active development, and contributions are more than welcome! #. Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to `AUTHORS <https://github.com/kennethreitz/requests/blob/master/AUTHORS.rst>`_. -Development dependencies +Development Dependencies ------------------------ You'll need to install py.test in order to run the Requests' test suite:: @@ -26,17 +26,24 @@ You'll need to install py.test in order to run the Requests' test suite:: test_requests.py ......................... 25 passed in 3.50 seconds -Versions of Python ------------------- +Runtime Environments +-------------------- -Officially (as of 26-Nov-2012), requests supports python 2.6-3.3. In the -future, support for 3.1 and 3.2 may be dropped. In general you will need to -test on at least one python 2 and one python 3 version. You can also set up -Travis CI for your own fork before you submit a pull request so that you are -assured your fork works. To use Travis CI for your fork and other projects see -their `documentation <http://about.travis-ci.org/docs/user/getting-started/>`_. +Requests currently supports the following versions of Python: -What Needs to be Done ---------------------- +- Python 2.6 +- Python 2.7 +- Python 3.1 +- Python 3.2 +- Python 3.3 +- PyPy 1.9 -- Documentation needs a roadmap. +Support for Python 3.1 and 3.2 may be dropped at any time. + +Google App Engine will never be officially supported. Pull requests for compatiblity will be accepted, as long as they don't complicate the codebase. + + +Are you crazy? +-------------- + +- SPDY support would be awesome. No C extensions. |