Added automated versioning

.github/workflows/lint.yml

@@ -1,9 +1,8 @@
-name: Lint
+name: Lint and tag
 
 on:
   push:
     branches:
-      - dev
       - master
     paths-ignore:
       - "**/.github/**"
@@ -27,3 +26,21 @@ jobs:
     - uses: stefanzweifel/git-auto-commit-action@v5
       with:
         commit_message: Adjusted files for isort & autopep
+
+  tag:
+    runs-on: ubuntu-latest
+    needs: lint
+    steps:        
+      - name: Git Version
+        uses: codacy/git-version@2.8.0
+        id: git_version
+        with:
+          prefix: v
+          minor-identifier: "feat:"
+          major-identifier: "breaking:"
+
+      - name: Create Tag
+        run: git tag -a v${{ steps.git_version.outputs.version }} -m "v${{ steps.git_version.outputs.version }}"
+
+      - name: Push Tag
+        run: git push origin v${{ steps.git_version.outputs.version }}

.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to pypi
+
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.build.txt
+
+    - name: Build and publish
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        user: __token__
+        password: ${{ secrets.PYPI_API_TOKEN }}

README.md

@@ -1,2 +1,9 @@
 # creyPY
 My collection of Python and FastAPI shortcuts etc.
+
+
+# Release
+
+``` rm -rf dist build creyPY.egg-info && python setup.py sdist bdist_wheel ```
+
+``` twine upload dist/* ```

creyPY/const/__init__.py

@@ -1,2 +1,3 @@
+from .groups import *  # noqa
 from .i18n import *  # noqa
 from .stripe import *  # noqa

creyPY/const/groups.py

@@ -0,0 +1,10 @@
+import enum
+
+
+class GroupMode(str, enum.Enum):
+    Minute = "1m"
+    Hour = "1h"
+    Day = "1d"
+    Week = "7d"
+    Month = "1mo"
+    Year = "1y"

creyPY/fastapi/__init__.py

@@ -0,0 +1,5 @@
+from .app import *  # noqa
+from .crud import *  # noqa
+from .models import *  # noqa
+from .pagination import *  # noqa
+from .schemas import *  # noqa

creyPY/fastapi/app.py

@@ -0,0 +1,23 @@
+import re
+
+from fastapi.routing import APIRoute
+
+
+# Swagger operation ID config
+def generate_unique_id(route: APIRoute) -> str:
+    op_id = re.sub(r"{.*?}", "", route.path_format)  # remove path parameters
+    operation_id = re.sub(r"\W", "_", op_id.replace("//", "/"))[
+        1:
+    ]  # replace non-alphanumeric characters with underscores
+    assert route.methods
+    # if the route doesn't end with an underscore we should add one
+    if operation_id[-1] != "_":
+        operation_id += "_"
+    # If get method and no {} in the path, it should be called list
+    if "GET" in route.methods and "{" not in route.path_format:
+        operation_id = operation_id + "list"
+    else:
+        operation_id = (
+            operation_id + list(route.methods)[0].lower()
+        )  # add first (and only) method to operation_id
+    return operation_id

creyPY/fastapi/crud.py

@@ -0,0 +1,58 @@
+from typing import Type, TypeVar
+from uuid import UUID
+
+from fastapi import HTTPException
+from pydantic import BaseModel
+from sqlalchemy.orm import Session
+
+from .models.base import Base
+
+T = TypeVar("T", bound=Base)
+
+
+def get_object_or_404(db_class: Type[T], id: UUID | str, db: Session, expunge: bool = False) -> T:
+    obj = db.query(db_class).filter(db_class.id == id).one_or_none()
+    if obj is None:
+        raise HTTPException(status_code=404, detail="The object does not exist.")
+    if expunge:
+        db.expunge(obj)
+    return obj
+
+
+def create_obj_from_data(
+    data: BaseModel, model: Type[T], db: Session, additonal_data={}, exclude={}
+) -> T:
+    obj = model(**data.model_dump(exclude=exclude) | additonal_data)
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_obj_from_data(
+    data: BaseModel,
+    model: Type[T],
+    id: UUID | str,
+    db: Session,
+    partial: bool = False,
+    ignore_fields=[],
+    additional_data={},
+    exclude={},
+) -> T:
+    obj = get_object_or_404(model, id, db)
+    data_dict = data.model_dump(exclude_unset=not partial, exclude=exclude)
+    data_dict.update(additional_data)  # merge additional_data into data_dict
+    for field in data_dict:
+        if field not in ignore_fields:
+            setattr(obj, field, data_dict[field])
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def delete_object(db_class: Type[T], id: UUID | str, db: Session) -> None:
+    obj = db.query(db_class).filter(db_class.id == id).one_or_none()
+    if obj is None:
+        raise HTTPException(status_code=404, detail="The object does not exist.")
+    db.delete(obj)
+    db.commit()

creyPY/fastapi/models/__init__.py

@@ -0,0 +1 @@
+from .base import *  # noqa

creyPY/fastapi/models/base.py

@@ -0,0 +1,25 @@
+import uuid
+from datetime import datetime
+
+from sqlalchemy import Column, DateTime, String
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.ext.declarative import declared_attr
+from sqlalchemy.orm import as_declarative
+from sqlalchemy.sql import func
+
+
+@as_declarative()
+class Base:
+    __abstract__ = True
+    # Primary key as uuid
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    created_at = Column(DateTime(timezone=True), server_default=func.now())
+    updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+    created_by_id = Column(String)
+
+    __name__: str
+
+    # Generate __tablename__ automatically
+    @declared_attr
+    def __tablename__(cls) -> str:
+        return cls.__name__.lower()

creyPY/fastapi/pagination.py

@@ -0,0 +1,69 @@
+from math import ceil
+from typing import Any, Generic, Optional, Self, Sequence, TypeVar
+
+from fastapi_pagination import Params
+from fastapi_pagination.bases import AbstractPage, AbstractParams
+from fastapi_pagination.types import GreaterEqualOne, GreaterEqualZero
+from pydantic.json_schema import SkipJsonSchema
+
+T = TypeVar("T")
+
+
+class Page(AbstractPage[T], Generic[T]):
+    results: Sequence[T]
+    page: GreaterEqualOne | SkipJsonSchema[None] = None
+    size: GreaterEqualOne | SkipJsonSchema[None] = None
+    pages: GreaterEqualZero | SkipJsonSchema[None] = None
+    total: GreaterEqualZero
+    has_next: bool | SkipJsonSchema[None] = None
+    has_prev: bool | SkipJsonSchema[None] = None
+
+    __params_type__ = Params
+
+    @classmethod
+    def create(
+        cls,
+        items: Sequence[T],
+        params: AbstractParams,
+        *,
+        total: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Self:
+        if not isinstance(params, Params):
+            raise TypeError("Page should be used with Params")
+
+        size = params.size or total or len(items)
+        page = params.page or 1
+        pages = None
+
+        if total is not None:
+            if total == 0:
+                pages = 1
+            else:
+                pages = ceil(total / size)
+
+        has_next = page < (pages or 1)
+        has_prev = page > 1
+
+        return cls(
+            total=total,
+            results=items,
+            page=page,
+            size=size,
+            pages=pages,
+            has_next=has_next,
+            has_prev=has_prev,
+        )
+
+
+# Parse response from an SDK to a PAGE
+def parse_page(response, page: int, size: int) -> Page:
+    return Page(
+        page=page,
+        size=size,
+        total=response.total,
+        results=response.results,
+        pages=response.pages or 1,
+        has_next=response.has_next,
+        has_prev=response.has_prev,
+    )

creyPY/fastapi/schemas/__init__.py

@@ -0,0 +1 @@
+from .base import *  # noqa

creyPY/fastapi/schemas/base.py

@@ -0,0 +1,15 @@
+from datetime import datetime
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict
+
+
+class BaseSchemaModelIN(BaseModel):
+    created_by_id: str
+    model_config = ConfigDict(from_attributes=True)
+
+
+class BaseSchemaModelOUT(BaseSchemaModelIN):
+    id: UUID
+    created_at: datetime
+    updated_at: datetime

requirements.txt

@@ -0,0 +1,12 @@
+annotated-types==0.6.0 # Pydantic
+pydantic==2.6.4 # Pydantic
+pydantic-core==2.16.3 # Pydantic
+typing-extensions==4.10.0 # Pydantic
+
+anyio==4.3.0 # Pagination
+fastapi==0.110.0 # Pagination
+fastapi-pagination==0.12.21 # Pagination
+sniffio==1.3.1 # Pagination
+starlette==0.36.3 # Pagination
+
+sqlalchemy==2.0.29 # SQLAlchemy

setup.py

@@ -1,8 +1,28 @@
+import subprocess
+
 from setuptools import find_packages, setup
 
+with open("requirements.txt") as f:
+    requirements = f.read().splitlines()
+
+
+def get_latest_git_tag() -> str:
+    try:
+        tag = (
+            subprocess.check_output(["git", "describe", "--tags", "--abbrev=0"])
+            .strip()
+            .decode("utf-8")
+        )
+        if tag.startswith("v"):
+            tag = tag[1:]
+    except subprocess.CalledProcessError:
+        raise RuntimeError("Unable to get latest git tag")
+    return str(tag)
+
+
 setup(
     name="creyPY",
-    version="0.0.5",
+    version=get_latest_git_tag(),
     description="My collection of Python and FastAPI shortcuts etc.",
     author="Conrad Großer",
     author_email="conrad@noah.tech",
@@ -10,4 +30,5 @@ setup(
     url="https://github.com/creyD/creyPY",
     license="MIT",
     python_requires=">=3.12",
+    install_requires=requirements,
 )