[tor-commits] [stem/master] Stem release 1.4.0
atagar at torproject.org
atagar at torproject.org
Wed May 13 15:47:19 UTC 2015
commit d298cd0f75f8bac7239630c0c22da8048ec276b9
Author: Damian Johnson <atagar at 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 at torproject.org'
__url__ = 'https://stem.torproject.org/'
More information about the tor-commits
mailing list