Upgrade sphinxcontrib-towncrier to 0.2.0a0

[uranusjr]

See sphinx-contrib/sphinxcontrib-towncrier#44. Let’s see if this works.

[uranusjr]

Hmm, it seems like the “Unreleased as on” part is rendered wrong. @webknjaz Do you think this is an issue with pip’s usage or the plugin?

This is how pip does it:

pip/docs/html/news.rst

Lines 1 to 12 in e6a65fc

	=========
	Changelog
	=========
	.. attention::
	Major and minor releases of pip also include changes listed within
	prior beta releases.
	.. towncrier-draft-entries:: |release|, unreleased as on
	.. pip-news-include:: ../../NEWS.rst

The incorrect result: https://pip--9805.org.readthedocs.build/en/9805/news/

Expected result (from the main branch): https://pip.pypa.io/en/latest/news/

[webknjaz]

Yes, this is weird. OTOH the only thing that changed functionally is try/except when calling a private function to get the config... Probably needs investigation.

[webknjaz]

And since the extension basically dumps towncrier --draft ... output, I wonder if it's towncrier that now does something differently...

[webknjaz]

I wonder if it's towncrier that now does something differently...

Yep, I just confirmed that towncrier no longer prints out the title.

[webknjaz]

This was what I thought: they started passing {{ top_line }} into the Jinja2 template context instead of rendering themselves and since pip's template does not have it — nothing is rendered there.

Ref: twisted/towncrier#276.

@uranusjr this will fix the problem

diff --git a/tools/news/template.rst b/tools/news/template.rst
index 7ea90573d..d17faa414 100644
--- a/tools/news/template.rst
+++ b/tools/news/template.rst
@@ -1,3 +1,5 @@
+{{ top_line }}
+
 {% for section in sections %}
 {% set underline = "-" %}
 {% if section %}

Extension-wise, we could probably add a check for the top_line presence in the template and issue a warning but that's about it...

[uranusjr]

That seems to work (I added a couple of extra newline controls for cosmetics).

[webknjaz]

Yeah, I tested on your branch locally before posting that diff :)

[webknjaz]

@uranusjr I overlooked one thing — it appears that your change adding -}} breaks the title now: https://pip--9805.org.readthedocs.build/en/9805/news/#changelog

[webknjaz]

So that Towncrier regression makes normal and draft runs produce different outputs: twisted/towncrier#105. Possible fix: twisted/towncrier#303.