{"id":22792001,"url":"https://github.com/mcbeet/bolt-library-starter","last_synced_at":"2025-03-30T17:15:41.043Z","repository":{"id":59513205,"uuid":"537215435","full_name":"mcbeet/bolt-library-starter","owner":"mcbeet","description":"Starter template for a bolt library package with regression testing","archived":false,"fork":false,"pushed_at":"2023-03-06T14:14:09.000Z","size":209,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T19:03:38.880Z","etag":null,"topics":["beet","bolt","mcfunction","minecraft","minecraft-commands"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mcbeet.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-15T21:43:57.000Z","updated_at":"2022-09-17T02:57:44.000Z","dependencies_parsed_at":"2025-02-05T18:47:48.460Z","dependency_job_id":"ffe7e821-64bd-448c-b59f-8113b87b25c0","html_url":"https://github.com/mcbeet/bolt-library-starter","commit_stats":null,"previous_names":[],"tags_count":11,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcbeet%2Fbolt-library-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcbeet%2Fbolt-library-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcbeet%2Fbolt-library-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcbeet%2Fbolt-library-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mcbeet","download_url":"https://codeload.github.com/mcbeet/bolt-library-starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246351016,"owners_count":20763232,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["beet","bolt","mcfunction","minecraft","minecraft-commands"],"created_at":"2024-12-12T03:08:51.415Z","updated_at":"2025-03-30T17:15:41.022Z","avatar_url":"https://github.com/mcbeet.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bolt-library-starter\n\n[![GitHub Actions](https://github.com/mcbeet/bolt-library-starter/workflows/CI/badge.svg)](https://github.com/mcbeet/bolt-library-starter/actions)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)\n[![Discord](https://img.shields.io/discord/900530660677156924?color=7289DA\u0026label=discord\u0026logo=discord\u0026logoColor=fff)](https://discord.gg/98MdSGMm8j)\n\n\u003e Starter template for a bolt library package with regression testing.\n\n## Features\n\n- Packaging and dependency management with [`poetry`](https://python-poetry.org/)\n- Default [`beet`](https://github.com/mcbeet/beet) plugin that mounts a library of [`bolt`](https://github.com/mcbeet/bolt) modules\n- Regression testing with [`pytest`](https://docs.pytest.org/en/stable/), [`pytest-insta`](https://github.com/vberlier/pytest-insta), and [`lectern`](https://github.com/mcbeet/lectern)\n- Continuous integration and automatic releases with [`python-semantic-release`](https://python-semantic-release.readthedocs.io/en/latest/)\n- Smart template initialization using a [one-off workflow](https://github.com/mcbeet/bolt-library-starter/blob/main/.github/workflows/template.yml)\n\n## Get started\n\nCreate a new repository from this template by clicking the [\"Use this template\"](https://github.com/mcbeet/bolt-library-starter/generate) button above. The one-off workflow should kick in and your new repository will be initialized with the correct name and details.\n\nYou can also clone or download this repository manually, and rename the package and substitute all the `fixme` by hand. Don't forget to reset the version number and remove the one-off workflow in `.github/workflows/template.yml`.\n\n## Conventional commits\n\nThe main workflow in `.github/workflows/main.yml` will take care of version bumps and releases automatically based on the [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/) specification. This means that all commit messages must be prefixed with a type, such as `feat:`, `fix:`, `docs:`, etc. The type determines the version bump that will be applied to the package.\n\nThis will save you hours of fiddling with version numbers and changelogs.\n\nTo disable this feature, remove the \"Release\" step at the end of the main workflow. Then uninstall `python-semantic-release` with `poetry remove -Gdev python-semantic-release` and remove the `[tool.semantic_release]` section in `pyproject.toml`.\n\n## Type checking\n\nThis template doesn't include a local static type checker, but if you use [Visual Studio Code](https://code.visualstudio.com/) the editor will directly report strong diagnostics thanks to the `typeCheckingMode = \"strict\"` option in `pyproject.toml`.\n\nIf you're more familiar with static typing in Python, you're encouraged to install [Pyright](https://github.com/microsoft/pyright) in the project to pin it to a specific version and run it after `pytest` in the main workflow.\n\n## Publish on PyPI\n\nTo enable automatic releases on PyPI, [create a PyPI API token](https://pypi.org/manage/account/token/) and add it to your repository secrets as `PYPI_TOKEN`. Next, add the token as an environment variable at the end of the main workflow in `.github/workflows/main.yml`.\n\n```diff\n        env:\n          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n+         PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}\n```\n\nFinally, activate PyPI upload in the `python-semantic-release` configuration in `pyproject.toml` by removing or setting the `upload_to_repository` option to `true`.\n\n---\n\nLicense - [MIT](https://github.com/mcbeet/bolt-library-starter/blob/main/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcbeet%2Fbolt-library-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcbeet%2Fbolt-library-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcbeet%2Fbolt-library-starter/lists"}