Poetry replaced with uv.

Author: s3rius

README.md

@@ -7,9 +7,7 @@
 
 ## Usage
 
-⚠️ [Git](https://git-scm.com/downloads), [Python](https://www.python.org/) and [Poetry](https://python-poetry.org/) must be installed and accessible ⚠️
-
-Poetry version must be greater or equal than 1.1.8. Otherwise it won't be able to install SQLAlchemy.
+⚠️ [Git](https://git-scm.com/downloads), [Python](https://www.python.org/) and [UV](https://docs.astral.sh/uv/) must be installed and accessible ⚠️
 
 <div align="center">
  <a href="https://asciinema.org/a/ig0oi0fOq1hxqnW5X49XaaHIT" target="_blank"><img src="https://asciinema.org/a/ig0oi0fOq1hxqnW5X49XaaHIT.svg" /></a>
@@ -29,7 +27,7 @@ docker-compose up --build
 
 If you want to install it from sources, try this:
 ```shell
-python3 -m pip install poetry
+python3 -m pip install uv 
 python3 -m pip install .
 python3 -m fastapi_template
 ```

fastapi_template/cli.py

@@ -699,7 +699,7 @@ def run_command(callback: Callable[[BuilderContext], None]) -> None:
     for menu in menus:
         cmd.params.extend(menu.get_cli_options())
     required_commands = {
-        "poetry": "https://python-poetry.org/docs/#installation",
+        "uv": "https://docs.astral.sh/uv/",
         "git": "https://git-scm.com/",
     }
     for prog, link in required_commands.items():

fastapi_template/template/hooks/post_gen_project.py

@@ -61,10 +61,10 @@ def init_repo():
     cprint("Git repository initialized.", "green")
     subprocess.run(["git", "add", "."], stdout=subprocess.PIPE)
     cprint("Added files to index.", "green")
-    subprocess.run(["poetry", "install", "-n"])
-    subprocess.run(["poetry", "run", "pre-commit", "install"])
+    subprocess.run(["uv", "sync"])
+    subprocess.run(["uv", "run", "pre-commit", "install"])
     cprint("pre-commit installed.", "green")
-    subprocess.run(["poetry", "run", "pre-commit", "run", "-a"])
+    subprocess.run(["uv", "run", "pre-commit", "run", "-a"])
     subprocess.run(["git", "add", "."], stdout=subprocess.PIPE)
     subprocess.run(["git", "commit", "-m", "Initial commit"], stdout=subprocess.PIPE)
 

fastapi_template/template/{{cookiecutter.project_name}}/.gitlab-ci.yml

@@ -3,23 +3,21 @@ stages:
 
 .test-template:
   stage: test
-  image: python:3.11.4-slim-bullseye
+  image: ghcr.io/astral-sh/uv:0.9.12-python3.13-bookworm-slim
   tags:
     - kubernetes-runner
     - docker-runner
   except:
     - tags
   before_script:
     - apt update && apt install -y git
-    - pip install poetry==1.8.2
-    - poetry config virtualenvs.create false
-    - poetry install
+    - uv sync
 
 black:
   extends:
     - .test-template
   script:
-    - pre-commit run black -a
+    - pre-commit run ruff-format -a
 
 ruff:
   extends:
@@ -31,5 +29,5 @@ mypy:
   extends:
     - .test-template
   script:
-    - pre-commit run ruff -a
+    - pre-commit run mypy -a
 

fastapi_template/template/{{cookiecutter.project_name}}/.pre-commit-config.yaml

@@ -5,25 +5,27 @@ repos:
     - repo: local
       hooks:
 
-          - id: black
-            name: Format with Black
-            entry: poetry run black
+          - id: ruff-format
+            name: Format with Ruff
+            entry: uv run ruff format
             language: system
-            types: [python]
+            pass_filenames: false
+            always_run: true
 
           - id: ruff
             name: Check with Ruff
-            entry: poetry run ruff
+            entry: uv run ruff
             language: system
             pass_filenames: false
             always_run: true
             args: ["check", "{{cookiecutter.project_name}}", "tests", "--fix"]
 
           - id: mypy
             name: Validate types with MyPy
-            entry: poetry run mypy
+            entry: uv run mypy
             language: system
             types: [python]
             pass_filenames: false
             args:
               - "{{cookiecutter.project_name}}"
+              - "tests"

fastapi_template/template/{{cookiecutter.project_name}}/Dockerfile

@@ -1,4 +1,10 @@
-FROM python:3.11.4-slim-bullseye AS prod
+FROM ghcr.io/astral-sh/uv:0.9.12-bookworm AS uv
+
+# -----------------------------------
+# STAGE 1: prod stage
+# Only install main dependencies
+# -----------------------------------
+FROM python:3.13-slim-bookworm AS prod
 
 {%- if cookiecutter.db_info.name == "mysql" %}
 RUN apt-get update && apt-get install -y \
@@ -15,33 +21,32 @@ RUN apt-get update && apt-get install -y \
   && rm -rf /var/lib/apt/lists/*
 {%- endif %}
 
+ENV UV_COMPILE_BYTECODE=1
+ENV UV_LINK_MODE=copy
+ENV UV_PROJECT_ENVIRONMENT=/usr/local
 
-RUN pip install poetry==1.8.2
-
-# Configuring poetry
-RUN poetry config virtualenvs.create false
-RUN poetry config cache-dir /tmp/poetry_cache
-
-# Copying requirements of a project
-COPY pyproject.toml poetry.lock /app/src/
 WORKDIR /app/src
 
-# Installing requirements
-RUN --mount=type=cache,target=/tmp/poetry_cache poetry install --only main
+RUN --mount=from=uv,source=/uv,target=/bin/uv \
+    --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --locked --no-install-project --no-dev --managed-python
 
-{%- if cookiecutter.db_info.name == "mysql" or cookiecutter.db_info.name == "postgresql" %}
-# Removing gcc
-RUN apt-get purge -y \
-  gcc \
-  && rm -rf /var/lib/apt/lists/*
-{%- endif %}
+COPY . .
 
-# Copying actuall application
-COPY . /app/src/
-RUN --mount=type=cache,target=/tmp/poetry_cache poetry install --only main
+RUN --mount=from=uv,source=/uv,target=/bin/uv \
+    --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev --managed-python
 
 CMD ["/usr/local/bin/python", "-m", "{{cookiecutter.project_name}}"]
 
+# -----------------------------------
+# STAGE 3: development build
+# Includes dev dependencies
+# -----------------------------------
 FROM prod AS dev
 
-RUN --mount=type=cache,target=/tmp/poetry_cache poetry install
+RUN --mount=from=uv,source=/uv,target=/bin/uv \
+    --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --managed-python --all-groups

fastapi_template/template/{{cookiecutter.project_name}}/README.md

@@ -2,23 +2,23 @@
 
 This project was generated using fastapi_template.
 
-## Poetry
+## UV
 
-This project uses poetry. It's a modern dependency management
+This project uses uv. It's a modern dependency management
 tool.
 
 To run the project use this set of commands:
 
 ```bash
-poetry install
-poetry run python -m {{cookiecutter.project_name}}
+uv sync --locked
+uv run -m {{cookiecutter.project_name}}
 ```
 
 This will start the server on the configured host.
 
 You can find swagger documentation at `/api/docs`.
 
-You can read more about poetry here: https://python-poetry.org/
+You can read more about uv here: https://docs.astral.sh/ruff/
 
 ## Docker
 
@@ -37,7 +37,7 @@ docker-compose -f docker-compose.yml -f deploy/docker-compose.dev.yml --project-
 
 This command exposes the web application on port 8000, mounts current directory and enables autoreload.
 
-But you have to rebuild image every time you modify `poetry.lock` or `pyproject.toml` with this command:
+But you have to rebuild image every time you modify `uv.lock` or `pyproject.toml` with this command:
 
 ```bash
 docker-compose build
@@ -122,7 +122,6 @@ pre-commit is very useful to check your code before publishing it.
 It's configured using .pre-commit-config.yaml file.
 
 By default it runs:
-* black (formats your code);
 * mypy (validates types);
 * ruff (spots possible bugs);
 

fastapi_template/template/{{cookiecutter.project_name}}/pyproject.toml

@@ -152,33 +152,39 @@ asyncpg = {version = "^0.30.0", extras = ["sa"]}
 {%- endif %}
 ]
 
-[tool.poetry.group.dev.dependencies]
-pytest = "^8"
-ruff = "^0.5.0"
-mypy = "^1.10.1"
-pre-commit = "^3.7.1"
-black = "^24.4.2"
-pytest-cov = "^5"
-anyio = "^4"
-pytest-env = "^1.1.3"
+[dependency-groups]
+dev = [
+  "pytest>=8,<9",
+  "ruff>=0.5.0,<1",
+  "mypy>=1.10.1,<2",
+  "pre-commit>=3.7.1,<4",
+  "pytest-cov>=5,<6",
+  "anyio>=4,<5",
+  "pytest-env>=1.1.3,<2",
 {%- if cookiecutter.enable_redis == "True" %}
-fakeredis = "^2.23.3"
+  "fakeredis>=2.23.3,<3",
 {%- endif %}
 {%- if cookiecutter.orm == "tortoise" %}
-asynctest = "^0.13.0"
-nest-asyncio = "^1.6.0"
+  "asynctest>=0.13.0,<1",
+  "nest-asyncio>=1.6.0,<2",
 {%- endif %}
-httpx = "^0.27.0"
+  "httpx>=0.27.0,<1",
 {%- if cookiecutter.enable_taskiq == "True" %}
-taskiq = { version = "^0", extras = ["reload"] }
+  "taskiq[reload]>=0,<1",
 {%- endif %}
+]
+
+
+[tool.uv]
+default-groups = ["dev"]
 
 [tool.isort]
 profile = "black"
 multi_line_output = 3
 src_paths = ["{{cookiecutter.project_name}}",]
 
 [tool.mypy]
+python_version = "3.12"
 strict = true
 ignore_missing_imports = true
 allow_subclassing_any = true
@@ -242,34 +248,36 @@ src_folder = "./{{cookiecutter.project_name}}"
 {%- endif %}
 
 [tool.ruff]
+target-version = "py312"
 # List of enabled rulsets.
 # See https://docs.astral.sh/ruff/rules/ for more information.
-lint.select = [
-    "E",   # Error
-    "F",   # Pyflakes
-    "W",   # Pycodestyle
-    "C90", # McCabe complexity
-    "I",   # Isort
-    "N",   # pep8-naming
-    "D",   # Pydocstyle
-    "ANN", # Pytype annotations
-    "S",   # Bandit
-    "B",   # Bugbear
-    "COM", # Commas
-    "C4",  # Comprehensions
-    "ISC", # Implicit string concat
-    "PIE", # Unnecessary code
-    "T20", # Catch prints
-    "PYI", # validate pyi files
-    "Q",   # Checks for quotes
-    "RSE", # Checks raise statements
-    "RET", # Checks return statements
-    "SLF", # Self checks
-    "SIM", # Simplificator
-    "PTH", # Pathlib checks
-    "ERA", # Checks for commented out code
-    "PL",  # PyLint checks
-    "RUF", # Specific to Ruff checks
+lint.select = [ "E",     # Error
+    "F",     # Pyflakes
+    "W",     # Pycodestyle
+    "C90",   # McCabe complexity
+    "I",     # Isort
+    "N",     # pep8-naming
+    "D",     # Pydocstyle
+    "ANN",   # Pytype annotations
+    "S",     # Bandit
+    "B",     # Bugbear
+    "COM",   # Commas
+    "C4",    # Comprehensions
+    "ISC",   # Implicit string concat
+    "PIE",   # Unnecessary code
+    "T20",   # Catch prints
+    "PYI",   # validate pyi files
+    "Q",     # Checks for quotes
+    "RSE",   # Checks raise statements
+    "RET",   # Checks return statements
+    "SLF",   # Self checks
+    "SIM",   # Simplificator
+    "PTH",   # Pathlib checks
+    "ERA",   # Checks for commented out code
+    "PL",    # PyLint checks
+    "RUF",   # Specific to Ruff checks
+	"FA102", # Future annotations
+	"UP",	 # Python updates
 ]
 lint.ignore = [
     "D105",    # Missing docstring in magic method
@@ -308,14 +316,19 @@ ignore-decorators = ["typing.overload"]
 [tool.ruff.lint.pylint]
 allow-magic-value-types = ["int", "str", "float", "bytes"]
 
+[tool.ruff.lint.flake8-bugbear]
+extend-immutable-calls = [
+  {%- if cookiecutter.enable_taskiq == "True" %}
+  "taskiq_dependencies.Depends",
+  "taskiq.TaskiqDepends",
+  {%- endif %}
+  "fastapi.Depends",
+  "fastapi.Query",
+]
 
 [fastapi-template.options]
 {%- for key, value in cookiecutter.items() %}
 {%- if not key.startswith("_") and not key == "db_info" %}
 {{key}} = "{{value}}"
 {%- endif %}
 {%- endfor %}
-
-[build-system]
-requires = ["poetry-core>=1.0.0"]
-build-backend = "poetry.core.masonry.api"

fastapi_template/tests/conftest.py

@@ -103,6 +103,6 @@ def docker_module_shutdown(
     if not project_dir.exists():
         return
     os.chdir(project_dir)
-    Path("poetry.lock").unlink(missing_ok=True)
+    Path("uv.lock").unlink(missing_ok=True)
     run_docker_compose_command("down -v")
     os.chdir(cwd)