ref: unify

Author: emptybutton

README.md

@@ -1,25 +1,13 @@
-# appname_kebab_case
+# app-name-kebab-case
 Что бы начать, замените в названиях и содержаниях всех файлах:
-1. `appname_kebab_case` - на название вашего приложение в [kebab-case](https://developer.mozilla.org/en-US/docs/Glossary/Kebab_case)
-2. `appname_snake_case` - на название вашего приложение в [snake_case](https://developer.mozilla.org/en-US/docs/Glossary/Snake_case)
+1. `app-name-kebab-case` - на название вашего приложение в kebab-case
+2. `app_name_snake_case` - на название вашего приложение в snake_case
+2. `app_name_description` - на описание
 
-После замените это описание на описание вашего appname_kebab_case.
+app_name_description.
 
 ## Развертывание для разработки
 ```bash
-git clone https://github.com/emptybutton/appname_kebab_case.git
-docker compose -f appname_kebab_case/deployments/dev/docker-compose.yaml up
+git clone https://github.com/emptybutton/app-name-kebab-case.git
+docker compose -f app-name-kebab-case/deployments/dev/docker-compose.yaml up
 ```
-
-В контейнере используется своё виртуальное окружение, сохранённое отдельным volume-ом, поэтому можно не пересобирать образ при изменении зависимостей.
-
-Для ide можно сделать отдельное виртуальное окружение в папке проекта:
-```bash
-uv sync --extra dev --directory appname_snake_case
-```
-
-> [!NOTE]
-> При изменении зависимостей в одном окружении необходимо синхронизировать другое с первым:
-> ```bash
-> uv sync --extra dev
-> ```

alembic.ini

@@ -3,7 +3,7 @@
 [alembic]
 # path to migration scripts
 # Use forward slashes (/) also on windows to provide an os agnostic path
-script_location = src/appname_snake_case/infrastructure/alembic
+script_location = src/app_name_snake_case/infrastructure/alembic
 
 # template used to generate migration file names; The default value is %%(rev)s_%%(slug)s
 # Uncomment the line below if you want the files to be prepended with date and time

deployments/dev/backend/Dockerfile

@@ -1,15 +1,12 @@
-FROM ghcr.io/astral-sh/uv:python3.13-alpine AS app
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim AS app
 
 WORKDIR /app
-COPY . .
 
 ENV UV_LINK_MODE copy
 ENV UV_PROJECT_ENVIRONMENT /run/app/.venv
-RUN uv sync --extra dev
+ENV UV_CACHE_DIR copy /run/app/uv
 
 ENV PYTHONPATH /app/src:/app/tests
-ENV MYPYPATH /app/src:/app/tests
-
 ENV WATCHFILES_FORCE_POLLING true
 
-ENTRYPOINT ["ash", "deployments/dev/backend/entrypoint.sh"]
+ENTRYPOINT ["bash", "deployments/dev/backend/entrypoint.sh"]

deployments/dev/backend/entrypoint.sh

@@ -1,5 +1,6 @@
-#!/bin/ash
+#!/bin/bash
 
+uv sync --extra dev
 source ${UV_PROJECT_ENVIRONMENT}/bin/activate
 alembic upgrade head
 $@

deployments/dev/docker-compose.yaml

@@ -1,13 +1,13 @@
-name: appname_kebab_case
+name: app-name-kebab-case
 
 services:
   backend:
     build:
       context: ../../
       dockerfile: deployments/dev/backend/Dockerfile
       tags:
-        - "appname_kebab_case-backend:dev"
-    container_name: appname_kebab_case-backend
+        - "app-name-kebab-case-backend:dev"
+    container_name: app-name-kebab-case-backend
     volumes:
       - ../..:/app
       - backend-data:/run/app
@@ -19,16 +19,11 @@ services:
     environment:
       JWT_SECRET: super-secret-jwt-secret
       POSTGRES_URL: postgresql+psycopg://root:root@postgres/root
-    command: appname_kebab_case-web-service
-    healthcheck:
-      test: wget backend:8000/healthcheck -q -O /dev/null
-      start_period: 1m
-      start_interval: 1s
-      interval: 5s
+    command: app-name-kebab-case-fastapi-dev
 
   postgres:
     image: postgres:16.3-alpine3.19
-    container_name: appname_kebab_case-postgres
+    container_name: app-name-kebab-case-postgres
     labels:
       deployment: dev
     volumes:

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
-name = "appname_kebab_case"
+name = "app-name-kebab-case"
 version = "0.1.0"
-description = "*description*"
+description = "app_name_description"
 authors = [
     {name = "Alexander Smolin", email = "[email protected]"}
 ]
@@ -10,6 +10,7 @@ readme = "README.md"
 classifiers = ["Private :: Do Not Upload"]
 requires-python = "==3.13.*"
 dependencies = [
+    "effectt==0.2.0",
     "uvicorn[standard]==0.30.6",
     "typenv==0.2.0",
     "dishka==1.4.2",
@@ -38,12 +39,13 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/appname_snake_case"]
+packages = ["src/app_name_snake_case"]
 
 [project.scripts]
-appname_kebab_case-web-service = "appname_snake_case.entrypoint.web_service.__main__:main"
+app-name-kebab-case-fastapi-dev = "app_name_snake_case.entrypoint.web_service.__main__:main"
 
 [tool.mypy]
+mypy_path = "$MYPY_CONFIG_FILE_DIR/src:$MYPY_CONFIG_FILE_DIR/tests"
 strict = true
 no_namespace_packages = true
 allow_redefinition = true
@@ -66,8 +68,9 @@ ignore = ["N818", "RUF009", "UP018", "PLR6301", "PLR0913", "PLW0108", "TC006"]
 lines-after-imports = 2
 
 [tool.ruff.lint.per-file-ignores]
-"src/appname_snake_case/entities/*" = ["PLR2004"]
-"src/appname_snake_case/application/*" = ["PLR0917"]
+"src/app_name_snake_case/entities/*" = ["PLR2004"]
+"src/app_name_snake_case/application/*" = ["PLR0917"]
+"src/app_name_snake_case/infrastructure/adapters/*" = ["RUF029"]
 "tests/*" = ["S101", "PLR0124", "PLR0917", "S106", "C901"]
 "*/alembic/versions/*" = ["S101"]
 "__init__.py" = ["PLC0414"]

src/appname_snake_case/__init__.py src/app_name_snake_case/__init__.pysrc/appname_snake_case/__init__.py renamed to src/app_name_snake_case/__init__.py

@@ -0,0 +1,8 @@
+from abc import ABC, abstractmethod
+
+from app_name_snake_case.entities.time.time import Time
+
+
+class Clock(ABC):
+    @abstractmethod
+    async def get_current_time(self) -> Time: ...