Prepare for 0.0.5

Author: RobertoPrevato

.flake8

@@ -1,6 +1,6 @@
 [flake8]
 exclude = __pycache__,built,build,venv
-ignore = E203, E266, W503
+ignore = E203, E266, W503, E704
 max-line-length = 88
 max-complexity = 18
 select = B,C,E,F,W,T4,B9

.github/workflows/build.yml

@@ -20,7 +20,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [3.8, 3.9, "3.10", "3.11"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@v1
@@ -35,8 +35,7 @@ jobs:
 
       - name: Install dependencies
         run: |
-          pip install -e .
-          pip install isort flake8 black pytest pytest-cov
+          pip install -r dev-requirements.txt
 
       - name: Run tests
         run: |
@@ -46,7 +45,6 @@ jobs:
         run: |
           echo "Running linters"
 
-          pip install black
           flake8 .
           isort --check-only . 2>&1
           black --check . 2>&1
@@ -67,34 +65,34 @@ jobs:
           rm -rf junit
           rm -rf deps
           pip install build
-        if: matrix.python-version == 3.11
+        if: matrix.python-version == 3.12
 
       - name: Create distribution package
         run: python -m build
-        if: matrix.python-version == 3.11
+        if: matrix.python-version == 3.12
 
       - name: Upload distribution package
-        uses: actions/upload-artifact@master
+        uses: actions/upload-artifact@v4
         with:
           name: dist
           path: dist
-        if: matrix.python-version == 3.11
+        if: matrix.python-version == 3.12
 
   publish:
     runs-on: ubuntu-latest
     needs: build
     if: github.event_name == 'release'
     steps:
       - name: Download a distribution artifact
-        uses: actions/download-artifact@v2
+        uses: actions/download-artifact@v4
         with:
           name: dist
           path: dist
 
-      - name: Use Python 3.11
+      - name: Use Python 3.12
         uses: actions/setup-python@v1
         with:
-          python-version: '3.11'
+          python-version: '3.12'
 
       - name: Install dependencies
         run: |

CHANGELOG.md

@@ -5,18 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.5] - 2025-03-29
+
+- Add the `--checkout` option to the `create` command to support using specific
+  branches and tags. Example:
+  `blacksheep create my-proj2 --template mvc --checkout v1.0.2`.
+- Add support for `int` and `float` question types (to enable budget
+  validation).
+- Add missing `__init__.py` files.
+- Update dependencies, apply latest formatting from `black`.
+- Workflow maintenance.
+- Remove Python 3.8 from the build matrix, add Python 3.12 and 3.13.
+
 ## [0.0.4] - 2023-08-20 :sun_with_face:
 
-- Adds support for Git repositories cloned over SSH.
-- Adds support for Cookiecutter [directories](https://cookiecutter.readthedocs.io/en/stable/cli_options.html#cmdoption-cookiecutter-directory).
+- Add support for Git repositories cloned over SSH.
+- Add support for Cookiecutter [directories](https://cookiecutter.readthedocs.io/en/stable/cli_options.html#cmdoption-cookiecutter-directory).
 
 ## [0.0.3] - 2023-06-28 :wrench:
 
-- Adds support for conditional questions.
+- Add support for conditional questions.
 
 ## [0.0.2] - 2023-06-28 :hammer:
 
-- Corrects error when stopping a template questionary.
+- Correct error when stopping a template questionary.
 
 ## [0.0.1] - 2023-06-27 :gem:
 

README.md

@@ -8,25 +8,41 @@
 pip install blacksheep-cli
 ```
 
+```bash
+blacksheep --help
+
+blacksheep create --help
+```
+
 ## Official project templates
 
-- `api`, to scaffold Web API projects
+- `api`, to scaffold Web API projects.
 - `mvc`, to scaffold Web Apps projects with Model, View, Controller
-   architecture, including Server Side Rendering of HTML views (SSR)
+   architecture, including Server Side Rendering of HTML views (SSR).
 
 ## Creating a new project
 
 ```bash
 blacksheep create
 ```
 
+Create a project pinned to a specific tag:
+
+```bash
+blacksheep create Example --template mvc --checkout v1.0.2
+```
+
+Tags refer to the project template repository. To see the list of tags, use the
+`blacksheep templates details` and navigate to the URL of the template
+repository.
+
 ## Listing the project templates
 
 ```bash
 blacksheep templates list
 ```
 
-With details:
+See details about the templates:
 
 ```bash
 blacksheep templates details

blacksheepcli/__init__.py

@@ -3,6 +3,7 @@
 Rich click increases import times and it might be desirable to disable it (e.g. when
 running automated jobs).
 """
+
 import os
 
 _disable_rich = os.environ.get("NORICH_CLI", "").lower() in {

blacksheepcli/common/__init__.py

@@ -2,6 +2,7 @@
 Main entry point for the `cookiecutter` command, modified to support prompting the user
 with Python https://github.com/tmbo/questionary, to offer a better user experience.
 """
+
 import logging
 import os
 import sys

blacksheepcli/common/cookiemod.py

@@ -3,10 +3,43 @@
 questionary (as it gives better control and a better user experience than cookiecutter's
 built-in prompt support).
 """
+
 import json
 from pathlib import Path
 
 
+def _is_float(value):
+    try:
+        float(value)
+        return True
+    except ValueError:
+        return False
+
+
+_TYPES = {
+    "int": {
+        "validate": lambda x: x.isdigit(),
+    },
+    "float": {
+        "validate": _is_float,
+    },
+}
+
+
+def _normalize_type(item):
+    """
+    Normalize the type to support more scenarios that are not supported by Python
+    questionary.
+
+    https://questionary.readthedocs.io/en/stable/
+    """
+    type_ = item.get("type")
+
+    if type_ in _TYPES:
+        item["type"] = "text"
+        item.update(_TYPES[type_])
+
+
 def _normalize_required(item):
     required = item.get("required")
 
@@ -39,6 +72,7 @@ def _normalize_when(item):
 
 def normalize_questions(extra_context, data):
     for item in data:
+        _normalize_type(item)
         _normalize_required(item)
         _normalize_when(item)
 

blacksheepcli/common/prompts.py

@@ -40,10 +40,17 @@ def print_instructions(destination: str):
     help="Project template name.",
     required=False,
 )
+@click.option(
+    "--checkout",
+    "-c",
+    help="Optional tag or branch name to use with the project template.",
+    required=False,
+)
 def create_project(
     name: Optional[str] = None,
     destination: Optional[str] = None,
     template: Optional[str] = None,
+    checkout: Optional[str] = None,
 ):
     """
     Create a new project, with the given NAME, from a template.
@@ -52,7 +59,9 @@ def create_project(
 
         blacksheep create my-proj
 
-        blacksheep create my-proj --template basic
+        blacksheep create my-proj --template mvc
+
+        blacksheep create my-proj --template mvc --checkout v1.0.2
     """
     while not name:
         # unsafe_ask because we let Click handle user cancellation
@@ -74,7 +83,7 @@ def create_project(
     assert destination is not None
     ProjectManager().bootstrap(
         template_obj.source,
-        template_obj.tag or None,
+        checkout or template_obj.tag or None,
         template_obj.folder,
         {"project_name": name},
     )

blacksheepcli/create/cli.py

@@ -2,6 +2,7 @@
 This module provides the default implementation of TemplatesDataProvider, which uses a
 JSON file stored in a user's folder.
 """
+
 import json
 import os
 from dataclasses import asdict