commit d298cd0f75f8bac7239630c0c22da8048ec276b9 Author: Damian Johnson atagar@torproject.org Date: Wed May 13 08:47:27 2015 -0700

Stem release 1.4.0 --- docs/change_log.rst | 20 +++++++++++++++----- docs/download.rst | 4 ++-- docs/index.rst | 2 +- docs/tutorials/mirror_mirror_on_the_wall.rst | 2 +- docs/tutorials/over_the_river.rst | 6 +++--- stem/__init__.py | 2 +- 6 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/docs/change_log.rst b/docs/change_log.rst index 5aa0ab1..b0b6f03 100644 --- a/docs/change_log.rst +++ b/docs/change_log.rst @@ -7,6 +7,7 @@ unreleased. For a monthly report on work being done see my `development log

* :ref:`versioning` * :ref:`unreleased` +* :ref:`Version 1.4 <version_1.4>` * :ref:`Version 1.3 <version_1.3>` * :ref:`Version 1.2 <version_1.2>` * :ref:`Version 1.1 <version_1.1>` @@ -41,13 +42,22 @@ Unreleased The following are only available within Stem's `git repository <download.html>`_.

-With this next release descriptor validation is now opt-in rather than opt-out, -and when unvalidated content is lazy-loaded. This `greatly improves our -performance +.. _version_1.4: + +Version 1.4 (May 13th, 2015) +---------------------------- + +`Stem's 1.4 release https://blog.torproject.org/blog/stem-release-14`_ brings +with it new hidden service capabilities. Most notably, `ephemeral hidden +services <tutorials/over_the_river.html#ephemeral-hidden-services>`_ and the +ability to `read hidden service descriptors +<tutorials/over_the_river.html#hidden-service-descriptors>`_. This release also +changes descriptor validation to now be opt-in rather than opt-out. When +unvalidated content is lazy-loaded, `greatly improving our performance https://lists.torproject.org/pipermail/tor-dev/2015-January/008211.html`_.

-Stem also now runs directly under both python2 and python3 without a 2to3 -conversion (:trac:`14075`). +And last, Stem also now runs directly under both python2 and python3 without a +2to3 conversion (:trac:`14075`)!

* **Controller**

diff --git a/docs/download.rst b/docs/download.rst index 4407fab..7dbef38 100644 --- a/docs/download.rst +++ b/docs/download.rst @@ -71,9 +71,9 @@ Download

Signed releases and instructions for both Python 2.x and 3.x. You can easily install from its `tarball - https://pypi.python.org/packages/source/s/stem/stem-1.3.0.tar.bz2`_ + https://pypi.python.org/packages/source/s/stem/stem-1.4.0.tar.bz2`_ (`sig - https://pypi.python.org/packages/source/s/stem/stem-1.3.0.tar.bz2.asc`_), + https://pypi.python.org/packages/source/s/stem/stem-1.4.0.tar.bz2.asc`_), or with **pip**...

:: diff --git a/docs/index.rst b/docs/index.rst index cac41ad..c00db5c 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,7 +1,7 @@ Welcome to Stem! ================

-Stem is a Python controller library for `Tor https://www.torproject.org/`_. With it you can use Tor's `control protocol https://gitweb.torproject.org/torspec.git/tree/control-spec.txt`_ to script against the Tor process, or build things such as `arm https://www.atagar.com/arm/`_. Stem's latest version is **1.3.0** (released December 21st, 2014). +Stem is a Python controller library for `Tor https://www.torproject.org/`_. With it you can use Tor's `control protocol https://gitweb.torproject.org/torspec.git/tree/control-spec.txt`_ to script against the Tor process, or build things such as `arm https://www.atagar.com/arm/`_. Stem's latest version is **1.4.0** (released May 13th, 2015).

.. Main Stem Logo Source: http://www.wpclipart.com/plants/assorted/P/plant_stem.png.html diff --git a/docs/tutorials/mirror_mirror_on_the_wall.rst b/docs/tutorials/mirror_mirror_on_the_wall.rst index ec3a9f8..bec30a7 100644 --- a/docs/tutorials/mirror_mirror_on_the_wall.rst +++ b/docs/tutorials/mirror_mirror_on_the_wall.rst @@ -31,7 +31,7 @@ Descriptor Type `Microdescriptor <../api/descriptor/microdescriptor.html>`_ Minimalistic document that just includes the information necessary for Tor clients to work. `Network Status Document <../api/descriptor/networkstatus.html>`_ Though Tor relays are decentralized, the directories that track the overall network are not. These central points are called **directory authorities**, and every hour they publish a document called a **consensus** (aka, network status document). The consensus in turn is made up of **router status entries**. `Router Status Entry <../api/descriptor/router_status_entry.html>`_ Relay information provided by the directory authorities including flags, heuristics used for relay selection, etc. -`Hidden Service Descriptor <../api/descriptor/hidden_service_descriptor.html>`_ Information pertaining to a `Hidden Service https://www.torproject.org/docs/hidden-services.html.en`_. These can only be `queried through the tor process <over_the_river.html#how-can-i-get-hidden-service-descriptors>`_. +`Hidden Service Descriptor <../api/descriptor/hidden_service_descriptor.html>`_ Information pertaining to a `Hidden Service https://www.torproject.org/docs/hidden-services.html.en`_. These can only be `queried through the tor process <over_the_river.html#hidden-service-descriptors>`_. ================================================================================ ===========

.. _where-can-i-get-the-current-descriptors: diff --git a/docs/tutorials/over_the_river.rst b/docs/tutorials/over_the_river.rst index 8381513..ed2d039 100644 --- a/docs/tutorials/over_the_river.rst +++ b/docs/tutorials/over_the_river.rst @@ -182,10 +182,10 @@ For example, with a ephemeral service our earlier example becomes as simple as.. finally: print " * Shutting down our hidden service"

-.. _how-can-i-get-hidden-service-descriptors: +.. _hidden-service-descriptors:

-How can I get hidden service descriptors? ------------------------------------------ +Hidden service descriptors +--------------------------

Like relays, hidden services publish documents about themselves called **hidden service descriptors**. These contain low level details for establishing diff --git a/stem/__init__.py b/stem/__init__.py index 92299cf..5134c2f 100644 --- a/stem/__init__.py +++ b/stem/__init__.py @@ -441,7 +441,7 @@ Library for working with the tor process. ================= =========== """

-__version__ = '1.3.0-dev' +__version__ = '1.4.0' __author__ = 'Damian Johnson' __contact__ = 'atagar@torproject.org' __url__ = 'https://stem.torproject.org/'