https://github.com/alunduil/template.py
You can use template.py to create a new GitHub repository. The repository will have poetry, VS Code devcontainers, and various GitHub actions ready to use.
https://github.com/alunduil/template.py
devcontainer-ready poetry python template vscode
Last synced: 2 months ago
JSON representation
You can use template.py to create a new GitHub repository. The repository will have poetry, VS Code devcontainers, and various GitHub actions ready to use.
- Host: GitHub
- URL: https://github.com/alunduil/template.py
- Owner: alunduil
- License: unlicense
- Created: 2022-11-09T09:21:17.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-07T17:06:02.000Z (2 months ago)
- Last Synced: 2025-04-07T18:22:26.382Z (2 months ago)
- Topics: devcontainer-ready, poetry, python, template, vscode
- Language: Python
- Homepage:
- Size: 616 KB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# template.py
[Homepage][repository]
By Alex Brandt
## Description
You can use template.py to create a new GitHub repository. The repository has
poetry, Visual Studio Code devcontainers, and various GitHub actions ready to use.
template.py relates to [Cookiecutter] because both are templates for
bootstrapping projects. template.py allows you to have a full development
environment with Visual Studio Code and it's "Remote Development" plugin.
[Cookiecutter] expects you to re-use your development environment for
projects.
## Terms of use
You are free to use template.py as a basis for your own projects without any
conditions. See the [LICENSE] file for details.
## Prerequisites
1. Visual Studio Code with "Remote Development" installed
1. [Shareable git credentials with the devcontainer](https://code.visualstudio.com/remote/advancedcontainers/sharing-git-credentials)
## How to use this template
1. Visit [the repository][repository]
1. Click "Use this template"
1. Follow the GitHub Docs to [Create a repo][create a repo]
1. Open Visual Studio Code
1. Open the shell prompt with `ctrl+shift+p`
1. Type "clone repository in container" and press return
1. Input the GitHub URL of your new repository
1. In the resulting terminal (Ctrl+\`), run: `poetry run initialise`
1. Resolve the generated README issue
1. Continue working on your awesome project
## Documentation
* [LICENSE]: The license governing use of template.py
## Getting help
* [GitHub Issues][issues]: Support requests, bug reports, and feature requests
## How to help
* Submit [issues] for problems or questions
* Submit [pull requests] for proposed changes
[create a repo]: https://docs.github.com/en/get-started/quickstart/create-a-repo
[issues]: https://github.com/alunduil/template.py/issues
[LICENSE]: ./LICENSE
[pull requests]: https://github.com/alunduil/template.py/pulls
[repository]: https://github.com/alunduil/template.py
[Cookiecutter]: https://github.com/cookiecutter/cookiecutter