python-base-toolkit 0.0.3__tar.gz → 0.0.5__tar.gz

python_base_toolkit-0.0.5/CI/Tasks/default.yml

@@ -0,0 +1,14 @@
+version: "3"
+
+tasks:
+  default:
+    cmds:
+      - echo "VENV_SITE_PACKAGES is set to - {{.VENV_SITE_PACKAGES}}"
+      - echo "Available tasks:"
+      - task --list
+
+  check_env:
+    desc: "Print environment variables"
+    cmds:
+        - echo "Environment Variables:"
+        - env | sort

python_base_toolkit-0.0.5/CI/Tasks/dependencies.yml

@@ -0,0 +1,31 @@
+version: "3"
+
+tasks:
+  pip_update:
+    desc: "Update all Python dependencies"
+    cmds:
+      - echo "Updating Python dependencies..."
+      - pip install --upgrade -r requirements.txt
+      - echo "Dependencies updated."
+
+  update_uv:
+    desc: "Install or update UV binary"
+    cmds:
+      - |
+        if command -v uv > /dev/null 2>&1; then
+            echo "UV is already installed at $(command -v uv), updating..."
+            uv update || echo "Automatic update failed. Please update manually."
+        else
+            echo "UV not found. Pleasing install UV."
+        fi
+
+  poetry_update:
+    desc: "Update all Python dependencies using Poetry"
+    cmds:
+      - |
+        if command -v poetry > /dev/null 2>&1; then
+          echo "Updating dependencies via Poetry..."
+          poetry update
+        else
+          echo "Poetry is not installed. Please install poetry'"
+        fi

python_base_toolkit-0.0.5/CI/Tasks/deploy.yml

@@ -0,0 +1,28 @@
+version: "3"
+
+tasks:
+  clean:
+    desc: "Clean build artifacts"
+    cmds:
+      - echo "cleaning..."
+      - rm -rf dist/
+      - rm -rf build/
+      - rm -rf *.egg-info
+      - echo "cleaned."
+
+  build:
+    desc: "Build the package"
+    cmds:
+      - echo "building..."
+      - task clean
+      - twine build .
+      - echo "built."
+
+  deploy:
+      desc: "Deploy the package to PyPI"
+      cmds:
+          - echo "deploying..."
+          - task build
+          - twine upload dist/*
+          - echo "deployed."
+          - task clean

python_base_toolkit-0.0.5/CI/Tasks/docker.yml

@@ -0,0 +1,64 @@
+version: "3"
+
+tasks:
+  docker_build:
+    desc: "Build Docker image for the project"
+    params:
+      IMAGE_NAME:
+        default: "myproject:latest"
+    cmds:
+      - echo "Building Docker image {{.IMAGE_NAME}}..."
+      - docker build -t {{.IMAGE_NAME}} .
+      - echo "Docker image built - {{.IMAGE_NAME}}"
+
+  docker_run:
+    desc: "Run Docker container"
+    params:
+      IMAGE_NAME:
+        default: "myproject:latest"
+      CONTAINER_NAME:
+        default: "myproject_container"
+      PORT:
+        default: "8000"
+    cmds:
+      - echo "Running Docker container {{.CONTAINER_NAME}}..."
+      - docker run -d --name {{.CONTAINER_NAME}} -p {{.PORT}}:{{.PORT}} {{.IMAGE_NAME}}
+      - echo "Container {{.CONTAINER_NAME}} is running on port {{.PORT}}"
+
+  docker_clean_all:
+    desc: "Remove old Docker containers and images"
+    cmds:
+      - echo "Stopping all running containers..."
+      - docker ps -q | xargs -r docker stop
+      - echo "Removing all containers..."
+      - docker ps -aq | xargs -r docker rm
+      - echo "Removing all images..."
+      - docker images -q | xargs -r docker rmi
+      - echo "Docker cleanup completed."
+
+  docker_clean_project:
+    desc: "Clean Docker resources for a specific project"
+    params:
+      PROJECT_NAME:
+        default: "myapp"
+    cmds:
+      - echo "Stopping and removing containers for project {{.PROJECT_NAME}}..."
+      - docker ps -aq --filter "name={{.PROJECT_NAME}}" | xargs -r docker stop
+      - docker ps -aq --filter "name={{.PROJECT_NAME}}" | xargs -r docker rm
+      - echo "Removing images for project {{.PROJECT_NAME}}..."
+      - docker images {{.PROJECT_NAME}}* -q | xargs -r docker rmi
+      - echo "Removing volumes for project {{.PROJECT_NAME}}..."
+      - docker volume ls -q --filter "name={{.PROJECT_NAME}}" | xargs -r docker volume rm
+      - echo "Project cleanup completed."
+
+  docker_clean_old:
+    desc: "Clean old/inactive Docker containers and images"
+    params:
+      AGE_HOURS:
+        default: "720"
+    cmds:
+      - echo "Cleaning containers inactive for more than {{.AGE_HOURS}} hours..."
+      - docker ps -aq --filter "status=exited" --filter "until={{.AGE_HOURS}}h" | xargs -r docker rm
+      - echo "Cleaning images older than {{.AGE_HOURS}} hours..."
+      - docker images -q --filter "until={{.AGE_HOURS}}h" | xargs -r docker rmi
+      - echo "Old resources cleanup completed."

python_base_toolkit-0.0.5/CI/Tasks/install.yml

@@ -0,0 +1,59 @@
+version: "3"
+
+tasks:
+  uv_bin:  # for CI ; command -v uv is the basic command to find uv if exists in PATH
+    desc: "Find the path to UV"
+    silent: true  # do not print the command output unless needed
+    cmds:
+      - |
+        if command -v uv > /dev/null 2>&1; then
+            command -v uv
+        elif [ -x "$HOME/.local/bin/uv" ]; then
+            echo "$HOME/.local/bin/uv"
+        elif [ -x "/usr/local/bin/uv" ]; then
+            echo "/usr/local/bin/uv"
+        else
+            echo ""
+        fi
+
+  check_uv:
+    desc: "Check if UV is installed"
+    cmds:
+      - |
+        UV_PATH=$(task -s main:install:uv_bin)
+        if [ -n "$UV_PATH" ]; then
+          echo "UV is installed at: $UV_PATH"
+          exit 0  # success
+        else
+          echo "UV is not installed."
+          exit 1  # failure
+        fi
+
+  install_uv:
+    desc: "Install UV"
+    cmds:
+      - echo "Installing UV..."
+      - |
+        if [ -n "$(task -s main:install:uv_bin)" ]; then
+            curl -sSfL https://astral.sh/uv/install.sh | sh
+        else
+            echo "UV is already installed at $(command -v uv)"
+        fi
+      - echo "🎉 UV installed."
+
+  reinstall_uv:
+    desc: "Force reinstall UV"
+    cmds:
+      - echo "🔁 Reinstalling UV..."
+      - curl -sSfL https://astral.sh/uv/install.sh | sh
+      - echo "🎉 UV reinstalled!"
+
+  install_dependencies:
+    desc: Install all dependencies.
+    deps:
+      - install-uv
+    cmds:
+      - task: clean
+      - pwd
+      - rm uv.lock || true
+      - "{{.UV_BIN}} sync"

python_base_toolkit-0.0.5/CI/Tasks/lint.yml

@@ -0,0 +1,12 @@
+version: "3"
+
+tasks:
+  pre_commit:
+    desc: Pre-commit all files.
+    cmds:
+      - |
+        echo "Running pre-commit hooks on all files..."
+        set -a
+        source .env
+        set +a
+        "{{.UV_BIN}}" run pre-commit run --all-files

python_base_toolkit-0.0.5/CI/Tasks/main.yml

@@ -0,0 +1,28 @@
+version: "3"
+
+vars:
+  VENV_SITE_PACKAGES:
+    sh: "python -c 'import os, site; print(os.path.abspath(site.getsitepackages()[0]))'"
+
+
+includes:
+  vars: vars.yml
+  default: default.yml
+  dependencies: dependencies.yml
+  deploy: deploy.yml
+  docker: docker.yml
+  install: install.yml
+  lint: lint.yml
+
+tasks:
+  default:
+    cmds:
+      - echo "VENV_SITE_PACKAGES is set to - {{.VENV_SITE_PACKAGES}}"
+      - echo "Available tasks:"
+      - task --list
+
+  env:
+    desc: "Print environment variables"
+    cmds:
+      - echo "Environment Variables:"
+      - env | sort

python_base_toolkit-0.0.5/CI/Tasks/vars.yml

@@ -0,0 +1,38 @@
+version: "3"
+
+vars:
+  OS:
+    sh: echo {{OS}}
+
+  UV_BIN:  # Dynamically detect uv binary location
+    sh: |
+      if command -v uv >/dev/null 2>&1; then
+        command -v uv
+      elif [ -x "/root/.local/bin/uv" ]; then
+        echo "/root/.local/bin/uv"
+      elif [ -x "$HOME/.local/bin/uv" ]; then
+        echo "$HOME/.local/bin/uv"
+      else
+        echo "/root/.local/bin/uv"
+      fi
+
+  VENV_PYTHON_PATH:
+      sh: |
+        find "$VIRTUAL_ENV/lib" -maxdepth 1 -type d -name "python*" | head -n1
+  DOT_VENV_PYTHON_PATH:
+    sh: |
+      find "$VIRTUAL_ENV/lib" -maxdepth 1 -type d -name "python*" | head -n1 | sed 's|^.*/\.venv/|.venv/|'
+  VENV_SITE_PACKAGES:
+    sh: "python -c 'import os, site; print(os.path.abspath(site.getsitepackages()[0]))'"
+
+  GIT_BRANCH:
+      sh: git branch --show-current
+  GIT_COMMIT_HASH:
+      sh: git rev-parse --short HEAD
+
+tasks:
+  print-vars:
+    desc: "Print all task variables - command: task print-vars --verbose"
+    cmds:
+      - |
+        echo {{.OS}}

{python_base_toolkit-0.0.3 → python_base_toolkit-0.0.5}/MANIFEST.in

@@ -1,4 +1,5 @@
 include requirements.txt
 include README.md
 include LICENSE
-include scripts
+include CI/Tasks/*
+include Taskfile.yml

{python_base_toolkit-0.0.3/python_base_toolkit.egg-info → python_base_toolkit-0.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-base-toolkit
-Version: 0.0.3
+Version: 0.0.5
 Summary: A Python package for managing pytest plugins.
 Author: Avi Zaguri
 License: MIT
@@ -16,6 +16,7 @@ Classifier: Topic :: System :: Logging
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: build>=1.3.0
 Requires-Dist: colorlog>=6.10.1
 Requires-Dist: custom-python-logger>=2.0.10
 Requires-Dist: pandas>=2.3.3
@@ -27,6 +28,7 @@ Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: requests>=2.32.5
 Requires-Dist: setuptools>=80.9.0
 Requires-Dist: tqdm>=4.67.1
+Requires-Dist: twine>=6.2.0
 Requires-Dist: wheel>=0.45.1
 Dynamic: license-file
 
@@ -70,6 +72,9 @@ pip install python-toolkit
   - shorten_url
   - venv_details
 
+- Tasks Pack
+  - ...
+
 ---
 
 ## 🤝 Contributing

{python_base_toolkit-0.0.3 → python_base_toolkit-0.0.5}/README.md

@@ -38,6 +38,9 @@ pip install python-toolkit
   - shorten_url
   - venv_details
 
+- Tasks Pack
+  - ...
+
 ---
 
 ## 🤝 Contributing

python_base_toolkit-0.0.5/Taskfile.yml

@@ -0,0 +1,4 @@
+version: "3"
+
+includes:
+  main: CI/Tasks/main.yml

{python_base_toolkit-0.0.3 → python_base_toolkit-0.0.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-base-toolkit"
-version = "0.0.3"
+version = "0.0.5"
 description = "A Python package for managing pytest plugins."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -21,6 +21,7 @@ classifiers = [
 ]
 
 dependencies = [
+    "build>=1.3.0",
     "colorlog>=6.10.1",
     "custom-python-logger>=2.0.10",
     "pandas>=2.3.3",
@@ -32,6 +33,7 @@ dependencies = [
     "requests>=2.32.5",
     "setuptools>=80.9.0",
     "tqdm>=4.67.1",
+    "twine>=6.2.0",
     "wheel>=0.45.1",
 ]
 

python_base_toolkit-0.0.5/python_base_toolkit/base_structures/base_enum.py

@@ -0,0 +1,54 @@
+import json
+from enum import Enum, StrEnum
+from typing import Any, TypeVar
+
+E = TypeVar("E", bound=Enum)
+
+
+class EnumMixin:
+    def __str__(self: E) -> str:
+        return str(self.value)
+
+    def __repr__(self: E) -> str:
+        return str(self.value)
+        # return f"<{self.__class__.__name__}.{self.name}: {self.value}>"
+
+    @classmethod
+    def to_list(cls: type[E]) -> list[Any]:
+        return [c.value for c in cls]
+
+    @classmethod
+    def to_dict(cls: type[E]) -> dict:
+        return {member.name: member.value for member in cls}
+
+    @classmethod
+    def names(cls: type[E]) -> list[str]:
+        return [c.name for c in cls]
+
+    @classmethod
+    def values(cls: type[E]) -> list[Any]:
+        return [c.value for c in cls]
+
+    @classmethod
+    def from_value(cls: type[E], value: Any) -> list[E]:
+        return [member for member in cls if value in member.value]
+
+    @classmethod
+    def has_name(cls: type[E], name: str) -> bool:
+        return any(member.name == name for member in cls)
+
+    @classmethod
+    def has_value(cls: type[E], value: Any) -> bool:
+        return any(member.value == value for member in cls)
+
+    @classmethod
+    def to_json(cls) -> str:
+        return json.dumps(cls.to_dict())
+
+
+class BaseEnum(EnumMixin, Enum):
+    pass
+
+
+class BaseStrEnum(EnumMixin, StrEnum):
+    pass

python_base_toolkit-0.0.5/python_base_toolkit/scripts/remove_build_files.py

@@ -0,0 +1,23 @@
+import shutil
+
+from python_base_toolkit.utils.path_utils import get_project_path_by_file
+
+
+def clean_build_artifacts() -> None:
+    ignore_dirs = {".git", ".github", ".venv", "__pycache__", ".idea", ".config"}
+    build_dirs = ["build", "dist"]
+    egg_info_suffix = ".egg-info"
+
+    root_project_path = get_project_path_by_file()
+    for p in root_project_path.iterdir():
+        if p.name in ignore_dirs:
+            continue
+
+        if p.is_dir() and p.name.endswith(egg_info_suffix):
+            shutil.rmtree(p, ignore_errors=True)
+        elif p.is_dir() and p.name in build_dirs:
+            shutil.rmtree(p, ignore_errors=True)
+
+
+if __name__ == "__main__":
+    clean_build_artifacts()

{python_base_toolkit-0.0.3 → python_base_toolkit-0.0.5/python_base_toolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-base-toolkit
-Version: 0.0.3
+Version: 0.0.5
 Summary: A Python package for managing pytest plugins.
 Author: Avi Zaguri
 License: MIT
@@ -16,6 +16,7 @@ Classifier: Topic :: System :: Logging
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: build>=1.3.0
 Requires-Dist: colorlog>=6.10.1
 Requires-Dist: custom-python-logger>=2.0.10
 Requires-Dist: pandas>=2.3.3
@@ -27,6 +28,7 @@ Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: requests>=2.32.5
 Requires-Dist: setuptools>=80.9.0
 Requires-Dist: tqdm>=4.67.1
+Requires-Dist: twine>=6.2.0
 Requires-Dist: wheel>=0.45.1
 Dynamic: license-file
 
@@ -70,6 +72,9 @@ pip install python-toolkit
   - shorten_url
   - venv_details
 
+- Tasks Pack
+  - ...
+
 ---
 
 ## 🤝 Contributing

{python_base_toolkit-0.0.3 → python_base_toolkit-0.0.5}/python_base_toolkit.egg-info/SOURCES.txt

@@ -1,13 +1,24 @@
 LICENSE
 MANIFEST.in
 README.md
+Taskfile.yml
 pyproject.toml
+CI/Tasks/default.yml
+CI/Tasks/dependencies.yml
+CI/Tasks/deploy.yml
+CI/Tasks/docker.yml
+CI/Tasks/install.yml
+CI/Tasks/lint.yml
+CI/Tasks/main.yml
+CI/Tasks/vars.yml
 python_base_toolkit/__init__.py
 python_base_toolkit.egg-info/PKG-INFO
 python_base_toolkit.egg-info/SOURCES.txt
 python_base_toolkit.egg-info/dependency_links.txt
 python_base_toolkit.egg-info/requires.txt
 python_base_toolkit.egg-info/top_level.txt
+python_base_toolkit/base_structures/__init__.py
+python_base_toolkit/base_structures/base_enum.py
 python_base_toolkit/consts/__init__.py
 python_base_toolkit/consts/operating_system.py
 python_base_toolkit/consts/units/__init__.py
@@ -18,6 +29,8 @@ python_base_toolkit/decorators/telemetry.py
 python_base_toolkit/decorators/timer.py
 python_base_toolkit/instances/__init__.py
 python_base_toolkit/instances/instance_manager.py
+python_base_toolkit/scripts/__init__.py
+python_base_toolkit/scripts/remove_build_files.py
 python_base_toolkit/utils/__init__.py
 python_base_toolkit/utils/data_serialization.py
 python_base_toolkit/utils/date_time.py

{python_base_toolkit-0.0.3 → python_base_toolkit-0.0.5}/python_base_toolkit.egg-info/requires.txt

@@ -1,3 +1,4 @@
+build>=1.3.0
 colorlog>=6.10.1
 custom-python-logger>=2.0.10
 pandas>=2.3.3
@@ -9,4 +10,5 @@ pyyaml>=6.0.3
 requests>=2.32.5
 setuptools>=80.9.0
 tqdm>=4.67.1
+twine>=6.2.0
 wheel>=0.45.1