added changelog and workflows

Author: chenkasirer

.github/workflows/prepare-release.yml

@@ -0,0 +1,26 @@
+name: prepare release
+
+on:
+  workflow_dispatch:
+    inputs:
+      release-type:
+        description: Semantic version component to bump
+        required: true
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-pr:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: compas-dev/compas-actions/release-pr@main
+        with:
+          release-type: ${{ inputs.release-type }}
+          github-token: ${{ github.token }}

.github/workflows/release.yml

@@ -0,0 +1,64 @@
+name: release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  release:
+    name: Detect release merge
+    runs-on: ubuntu-latest
+    outputs:
+      is-release: ${{ steps.release.outputs.is-release }}
+      version: ${{ steps.release.outputs.version }}
+      tag: ${{ steps.release.outputs.tag }}
+    steps:
+      - uses: compas-dev/compas-actions/release-check@main
+        id: release
+
+  prepare:
+    needs: release
+    if: needs.release.outputs.is-release == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: compas-dev/compas-actions/prepare-release@main
+        with:
+          python-version: "3.12"
+          management-tool: uv
+
+  publish:
+    needs: [release, prepare]
+    if: needs.release.outputs.is-release == 'true'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/ghpython_componentizer
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download package distributions
+        uses: actions/download-artifact@v8.0.1
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.14.2
+
+  create-release:
+    needs: [release, publish]
+    if: needs.release.outputs.is-release == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: compas-dev/compas-actions/github-release@main
+        with:
+          github-token: ${{ github.token }}
+          tag-name: ${{ needs.release.outputs.tag }}
+          target: ${{ github.sha }}

CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Unreleased
+
+### Added
+
+* Added `build_components` and `create_ghuser_component`, to build `.ghuser` components out of source bundles from Python.
+* Added the `ghpython-componentizer` command line, also runnable as `python -m ghpython_componentizer`.
+* Added support for macOS: the command line relaunches itself with the environment Mono needs to find `libgdiplus`.
+* Added `componentizer_env` and `run_componentizer`, to build components from a process that is already running.
+
+### Changed
+
+### Removed

README.md

@@ -243,6 +243,21 @@ The test suite covers the parts that do not require a .NET runtime, so it runs o
 Linting and formatting follow the same [ruff](https://docs.astral.sh/ruff/) rules as the other
 COMPAS packages, configured in `pyproject.toml`.
 
+## Releasing
+
+Releases are prepared and published by pull request, with the shared
+[compas-actions](https://github.com/compas-dev/compas-actions).
+
+1. Describe the changes under `## Unreleased` in [CHANGELOG.md](CHANGELOG.md), as they are merged.
+1. Run the *prepare release* workflow from the Actions tab, choosing `patch`, `minor` or `major`.
+   It bumps the version, closes the changelog section and opens a `release/vX.Y.Z` pull request.
+1. Review and merge that pull request.
+
+Merging it runs the *release* workflow: it builds the distributions, publishes them to PyPI through
+[trusted publishing](https://docs.pypi.org/trusted-publishers/) and creates the tagged GitHub
+release, with the changelog section as release notes. No API token is involved: PyPI needs a
+publisher configured for this repository, the `release.yml` workflow and the `pypi` environment.
+
 ## License
 
 This package is maintained by Gramazio Kohler Research [@gramaziokohler](https://github.com/gramaziokohler)