From fc76e97a45843a5150b7d7329d26c24c8bc1cc99 Mon Sep 17 00:00:00 2001
From: Tyler Goodlet <jgbt@protonmail.com>
Date: Wed, 1 Sep 2021 11:27:01 -0400
Subject: [PATCH] Initial `towncrier` integration for releases

Add a small config with a manually specified version key for now.
Fix up some changelog contents from last release and bump our `setup.py`
version to an `.alpha2.dev0`.

Resolves #227
---
 NEWS.rst                 | 17 ++++++++++-------
 newsfragments/.gitignore |  1 +
 setup.py                 |  2 +-
 towncrier.toml           |  7 +++++++
 4 files changed, 19 insertions(+), 8 deletions(-)
 create mode 100644 newsfragments/.gitignore
 create mode 100644 towncrier.toml

diff --git a/NEWS.rst b/NEWS.rst
index aab68f3..afb856b 100644
--- a/NEWS.rst
+++ b/NEWS.rst
@@ -2,6 +2,8 @@
 Changelog
 =========
 
+.. towncrier release notes start
+
 tractor 0.1.0a1 (2021-08-01)
 ============================
 
@@ -9,9 +11,10 @@ Features
 --------
 - Updated our uni-directional streaming API (`#206
   <https://github.com/goodboy/tractor/pull/206>`_) to require a context
-  manager style ``async Portal.stream_from(target) as stream:`` which
-  explicitly determines when to stop a stream in the calling (aka portal
-  opening) actor much like ``async_generator.aclosing()`` enforcement.
+  manager style ``async with Portal.open_stream_from(target) as stream:``
+  which explicitly determines when to stop a stream in the calling (aka
+  portal opening) actor much like ``async_generator.aclosing()``
+  enforcement.
 
 - Improved the ``multiprocessing`` backend sub-actor reaping (`#208
   <https://github.com/goodboy/tractor/pull/208>`_) during actor nursery
@@ -36,9 +39,9 @@ Experiments and WIPs
   land by next release.
 
 - Improved "infect ``asyncio``" cross-loop task cancellation and error
-  propagation by vastly simplifying the approach.  We may end up just
-  going with a use of ``anyio`` in the medium term to avoid re-doing
-  work done by that group cross-event-loop portals.  See the
+  propagation by vastly simplifying the cross-loop-task streaming approach. 
+  We may end up just going with a use of ``anyio`` in the medium term to
+  avoid re-doing work done by their cross-event-loop portals.  See the
   ``infect_asyncio`` for details.
 
 
@@ -67,7 +70,7 @@ Trivial/Internal Changes
 - Added a new ``TransportClosed`` internal exception/signal (`#215
   <https://github.com/goodboy/tractor/pull/215>`_ for catching TCP
   channel gentle closes instead of silently falling through the message
-  handler loop via an async generator ``return```.
+  handler loop via an async generator ``return``.
 
 
 Deprecations and Removals
diff --git a/newsfragments/.gitignore b/newsfragments/.gitignore
new file mode 100644
index 0000000..f935021
--- /dev/null
+++ b/newsfragments/.gitignore
@@ -0,0 +1 @@
+!.gitignore
diff --git a/setup.py b/setup.py
index df0e8af..a7e94bf 100755
--- a/setup.py
+++ b/setup.py
@@ -24,7 +24,7 @@ with open('docs/README.rst', encoding='utf-8') as f:
 
 setup(
     name="tractor",
-    version='0.1.0a1',  # first ever alpha
+    version='0.1.0a2.dev0',  # alpha zone
     description='structured concurrrent "actors"',
     long_description=readme,
     license='GPLv3',
diff --git a/towncrier.toml b/towncrier.toml
new file mode 100644
index 0000000..b1aa8d8
--- /dev/null
+++ b/towncrier.toml
@@ -0,0 +1,7 @@
+[tool.towncrier]
+package = "tractor"
+filename = "NEWS.rst"
+directory = "newsfragments/"
+title_format = "tractor {version} ({project_date})"
+version = "0.1.0a2"
+#template = "changelog/_template.rst"