🚀 Release v0.2.1 (#15)

Author: ubmarco

README.rst

@@ -1 +1,13 @@
+needs-config-writer
+===================
+
+Sphinx-Needs can be fully configured via ``conf.py``, but can also load configuration from a
+``ubproject.toml`` file. This file can be created and updated automatically via the
+``needs-config-writer`` Sphinx extension.
+
+Many Sphinx projects want to generate a part of the Sphinx-Needs configuration automatically.
+Tools like ubCode / ubc require a declarative format to ingest configuration.
+This extension tries to bridge the gap between Sphinx's dynamic Python configuration and
+the need for a static configuration file.
+
 **Complete documentation**: https://needs-config-writer.useblocks.com

docs/changelog.rst

@@ -9,6 +9,39 @@ Changelog
    Unreleased
    ----------
 
+.. _`release:0.2.1`:
+
+0.2.1
+-----
+
+:Released: 28.10.2025
+:Full Changelog: `v0.2.0...v0.2.1 <https://github.com/useblocks/needs-config-writer/compare/0.2.0...76b32b4>`__
+
+This releases adds quality-of-life improvements and minor fixes.
+
+- 📚 Restructure docs (:pr:`10` and :pr:`11`)
+
+  A ``Motivation`` page was added to explain about problems and use-cases.
+  Also an example for complex setups was added to illustrate how this extension
+  can be used in real-world scenarios.
+
+- 🔧 Return metadata in setup (:pr:`12`)
+
+  The extension now returns metadata such as version and whether it can be run in parallel
+  in the ``setup()`` call.
+
+- 👌 New config needscfg_exclude_vars (:pr:`13`)
+
+  A new configuration option ``needscfg_exclude_vars`` was added to customize
+  which Sphinx-Needs configuration variables are excluded from the exported TOML file.
+  See :ref:`excluded_configs` for details.
+
+- ✨ Merge additional TOML files (:pr:`14``)
+
+  A new configuration option ``needscfg_merge_toml_files`` was added to specify
+  additional TOML files to merge into the exported ``ubproject.toml``.
+  This allows to combine static configuration files with the dynamically generated one.
+
 .. _`release:0.2.0`:
 
 0.2.0

needs_config_writer/__init__.py

@@ -1,6 +1,6 @@
 """Sphinx extension to write Sphinx-Needs config to ubproject.toml."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 
 def setup(app):

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "needs-config-writer"
-version = "0.2.0"
+version = "0.2.1"
 description = "Sphinx extension to write Sphinx-Needs config to ubproject.toml"
 readme = "README.rst"
 urls.Repository = "https://github.com/useblocks/needs-config-writer"