https://github.com/fastapi-mvc/copier-controller
Copier template for scaffolding new controller upon fastapi-mvc project
https://github.com/fastapi-mvc/copier-controller
copier-template scaffolding
Last synced: about 1 month ago
JSON representation
Copier template for scaffolding new controller upon fastapi-mvc project
- Host: GitHub
- URL: https://github.com/fastapi-mvc/copier-controller
- Owner: fastapi-mvc
- License: mit
- Created: 2022-10-06T19:18:17.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T14:39:51.000Z (over 1 year ago)
- Last Synced: 2025-01-10T16:14:00.989Z (9 months ago)
- Topics: copier-template, scaffolding
- Language: Nix
- Homepage: https://github.com/fastapi-mvc/fastapi-mvc
- Size: 43.9 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
## Copier Controller
Copier template for scaffolding new controller upon [fastapi-mvc](https://github.com/fastapi-mvc/fastapi-mvc) project.
## Quickstart
### Using fastapi-mvc
Prerequisites:
* fastapi-mvc
* Git 2.27 or newer
```shell
git clone "https://github.com/fastapi-mvc/copier-controller.git"
FMVC_PATH="$PWD:$FMVC_PATH" fastapi-mvc generate controller /path/to/your/new/controller
```
### Using copier
To use this template outside `fastapi-mvc`:
Prerequisites:
* Python 3.8 or later [How to install python](https://docs.python-guide.org/starting/installation)
* Git 2.27 or newer
* copier 6.2.0 or later
```shell
copier copy "https://github.com/fastapi-mvc/copier-controller.git" /path/to/your/new/controller
```
## Using Nix
Prerequisites:
* Nix 2.8.x or later installed [How to install Nix](https://nixos.org/download.html)
```shell
nix develop
copier copy "https://github.com/fastapi-mvc/copier-controller.git" /path/to/your/new/controller
```
## Updating
To update your generator with the changes from the [upstream](https://github.com/fastapi-mvc/copier-generator) run:
```shell
./update.sh
# Or
nix run .#update
```
This action will not update/override your template and its configuration, but rather generators common files:
* Nix expression files
* `README.md`
* dotfiles
* `LICENSE`
List of excluded files/paths:
* `template/**`
* `copier.yml`
* `*.py`
* `CHANGELOG.md`
Lastly, you can pass extra copier CLI options should you choose:
```shell
./update.sh -x README.md --vcs-ref=custom_branch
# Or
nix run .#update -- -x README.md --vcs-ref=custom_branch
```