From 08f66a99b17e59355e2aeaf2d37244b18b69f6e1 Mon Sep 17 00:00:00 2001 From: Kenneth Reitz Date: Sun, 23 Dec 2012 02:13:31 -0500 Subject: [PATCH] semantic versioning --- docs/dev/philosophy.rst | 10 ++++++++-- 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 0569e38..a740221 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 `_. 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 6931147..c301456 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 `_. -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 `_. +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. -- 2.7.4