https://github.com/fleetingbytes/ci-starter

Kick-starts the semantic release pipeline for your Python project
https://github.com/fleetingbytes/ci-starter

Last synced: about 2 months ago
JSON representation

Kick-starts the semantic release pipeline for your Python project

• Host: GitHub
• URL: https://github.com/fleetingbytes/ci-starter
• Owner: fleetingbytes
• License: bsd-2-clause
• Created: 2025-09-07T13:05:15.000Z (9 months ago)
• Default Branch: master
• Last Pushed: 2026-04-07T03:03:08.000Z (2 months ago)
• Last Synced: 2026-04-07T05:09:54.186Z (2 months ago)
• Language: Python
• Size: 221 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ci-starter

Kickstarts the semantic release pipeline for your Python project on GitHub. It creates a configuration file _semantic-release.toml_ for python-semantic-release and a pipeline with reusable workflows in _.github/workflows_.

## Usage

### Prerequisites

You will have to do the flollowing things yourself:

- Create your project:

    - Use uv to initialize your project (must be a package)

        - Fill it with some minimally meaningful content, I recommend:

            - set version to `0.0.0`

            - project urls

            - keywords

            - classifiers

            - license

        - Add a dependency group for running tests (group shall contain at least your test runner, e.g. pytest)

    - Create tests (CI/CD pipeline would fail if no tests are found)

    - Format and check everything with ruff

    - Set up a trusted publisher for your project on pypi.org:

        - Workflow: `continuous-delivery.yml` (default workflow name)

        - Environment name: `pypi`

    - Set up a trusted publisher for your project on test.pypi.org:

        - Workflow: `continuous-delivery.yml`

        - Environment name: `testpypi`

    - Create a GitHub repository for your project

    - Add remote _origin_ and its ssh address at your local clone

### Create CI/CD Pipeline With ci-starter

Run these commands:

```text

$ ci-starter psr-config

$ ci-starter workflows

$ ci-starter update-actions

```

The psr-config command creates the _semantic-release.toml_, the second one creates the workflow files (.github/workflows/*.yml), the third one fetches the current versions of the GitHub Actions used in the workflow files and updates the workflow files accordingly.

It is your responsibility to check whether it is safe to use the suggested current versions of the GitHub Actions (beware of supply chain attacks).