randpal 0.1.0__tar.gz

randpal-0.1.0/.github/workflows/publish-version.yaml

@@ -0,0 +1,68 @@
+name: Publish new package version
+
+on:
+  push:
+    # On version pushes
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  verify-checks:
+    uses: ./.github/workflows/quality-assurance.yaml
+
+  publish:
+    name: Build and publish Python Package
+    needs: verify-checks
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v4
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          activate-environment: true
+          enable-cache: true
+
+      - name: Synchronise dependencies
+        run: |
+          uv pip install hatchling hatch-vcs
+
+      - name: Verify release version
+        shell: bash
+        run: |
+          VERSION="$(hatchling version)"
+          if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "::error::Expected a pure release version, got: $VERSION"
+            exit 1
+          fi
+          echo "VERSION=$VERSION" >> $GITHUB_ENV
+
+      - name: Build package
+        run: |
+          uv build
+
+      - name: Publish package to PyPI
+        env:
+          # TIP: Create PYPI_TOKEN secret in your GitHub repository
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          uv publish
+
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          VERSION: ${{ env.VERSION }}
+        run: |
+          gh release create "v$VERSION" \
+            --generate-notes \
+            --verify-tag

randpal-0.1.0/.github/workflows/quality-assurance.yaml

@@ -0,0 +1,107 @@
+name: Run quality assurance checks
+
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - ready_for_review
+
+  push:
+    branches:
+      - master
+
+  workflow_call:
+
+jobs:
+  lint-and-format:
+    name: Lint and check formatting
+    if: github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check formatting
+        uses: astral-sh/ruff-action@v4.1.0
+        with:
+          version-file: uv.lock
+          args: format --check --diff
+
+      - name: Check linting
+        run: |
+          ruff check --output-format=github
+
+  type-checking:
+    name: Static type checking
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          activate-environment: true
+          enable-cache: true
+
+      - name: Synchronise dependencies
+        run: |
+          uv sync --locked --all-extras --all-groups --dev
+
+      - name: Check with Pyright
+        uses: jakebailey/pyright-action@v2
+        with:
+          version: latest
+          annotate: all
+
+  runtime-tests:
+    name: Run tests
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          activate-environment: true
+          enable-cache: true
+
+      - name: Synchronise dependencies
+        run: |
+          uv sync --locked --all-extras --no-dev --group tests
+
+      - name: Run Pytest
+        run: |
+            pytest --doctest-modules

randpal-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

randpal-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

randpal-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: randpal
+Version: 0.1.0
+Summary: Convenient CLI wrapper around Python random module.
+Author-email: Soucelover <mr.ktotov@gmail.com>
+Requires-Python: >=3.14

randpal-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "randpal"
+description = "Convenient CLI wrapper around Python random module."
+readme = "README.md"
+authors = [
+    { name = "Soucelover", email = "mr.ktotov@gmail.com" }
+]
+dynamic = ["version"]
+
+# ===================
+# Requirements (deps)
+# ===================
+requires-python = ">=3.14"
+dependencies = []
+
+# ============
+# Build System
+# ============
+[project.scripts]
+randpal = "randpal.__main__:main"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"

randpal-0.1.0/src/randpal/__init__.py

@@ -0,0 +1,2 @@
+def main() -> None:
+    print("Hello from randpal!")

randpal-0.1.0/src/randpal/__main__.py

@@ -0,0 +1,43 @@
+import argparse
+import random
+
+VERBOSE_MODE = True
+
+
+def command_int(args: argparse.Namespace) -> None:
+    if VERBOSE_MODE:
+        print("Random number is ", end="")  # noqa: T201
+
+    print(random.randint(args.a, args.b), end="\n\n")  # noqa: T201
+
+
+def command_choose(args: argparse.Namespace) -> None:
+    if VERBOSE_MODE:
+        print("Random chosen item is ", end="")  # noqa: T201
+
+    print(random.choice(args.item), end="\n\n")  # noqa: T201
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser()
+    commands = parser.add_subparsers(required=True)
+
+    com_int = commands.add_parser("int")
+    com_int.add_argument("a", type=int)
+    com_int.add_argument("b", type=int)
+    com_int.set_defaults(command=command_int)
+
+    com_choose = commands.add_parser("choose")
+    com_choose.add_argument("item", nargs="+")
+    com_choose.set_defaults(command=command_choose)
+
+    return parser.parse_args()
+
+
+def main() -> None:
+    args = parse_args()
+    args.command(args)
+
+
+if __name__ == "__main__":
+    main()

randpal-0.1.0/uv.lock

@@ -0,0 +1,7 @@
+version = 1
+revision = 3
+requires-python = ">=3.14"
+
+[[package]]
+name = "randpal"
+source = { editable = "." }