Skip to content

fastapi-mvc/copier-controller

Repository files navigation

Copier Controller

Copier template for scaffolding new controller upon fastapi-mvc project.

Quickstart

Using fastapi-mvc

Prerequisites:

  • fastapi-mvc
  • Git 2.27 or newer
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:

copier copy "https://github.com/fastapi-mvc/copier-controller.git" /path/to/your/new/controller

Using Nix

Prerequisites:

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 run:

./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:

./update.sh -x README.md --vcs-ref=custom_branch
# Or
nix run .#update -- -x README.md --vcs-ref=custom_branch