Enable python 3.11

.devcontainer/devcontainer.json

@@ -54,6 +54,7 @@
         "minherz.copyright-inserter",
         "redhat.vscode-yaml",
         "rodolphebarbanneau.python-docstring-highlighter",
+        "saoudrizwan.claude-dev",
         "skellock.just",
         "streetsidesoftware.code-spell-checker",
         "tamasfe.even-better-toml",

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,49 @@
+name: 🐛 Bug Report
+description: Report bugs and errors
+labels: ['bug', 'needs-triage']
+body:
+  - type: input
+    id: version
+    attributes:
+      label: Package version
+      description: Run `python -c "import zero_spinner; print(zero_spinner.__version__)"`
+      placeholder: 'e.g. 0.1.0'
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      placeholder: 'OS: macOS 15, Python: 3.12.2, uv: 0.4.0'
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: How do we trigger this bug?
+      placeholder: |
+        1. First step...
+        2. Second step...
+        3. ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What should happen?
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: What actually happens?
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error logs / traceback
+      render: shell

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,16 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions ❓
+    url: https://github.com/matteozambon89/python-zero-spinner/discussions
+    about: Ask questions or share ideas in Discussions
+issue_templates:
+  - name: 🐛 Bug Report
+    description: File a bug or unexpected behavior
+    title: 🐛 [BUG]
+    labels: ['bug', 'needs-triage']
+    body: ./ISSUE_TEMPLATE/bug_report.yml
+  - name: 🚀 Feature Request
+    description: Suggest a new feature or enhancement
+    title: 🚀 [FEATURE]
+    labels: ['enhancement', 'needs-triage']
+    body: ./ISSUE_TEMPLATE/feature_request.yml

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,37 @@
+name: 🚀 Feature Request
+description: Suggest an idea for this project
+labels: ['enhancement', 'needs-triage']
+body:
+  - type: input
+    id: version
+    attributes:
+      label: Package version
+      description: Run `python -c "import zero_spinner; print(zero_spinner.__version__)"`
+      placeholder: 'e.g. 0.1.0'
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Is your feature request related to a problem?
+      description: Please describe the problem motivating this feature.
+      placeholder: "I'd like to do X, but currently I have to Y..."
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution
+      description: What would you like to happen? Any design docs or specifications?
+      placeholder: 'Add a --spinner-type CLI flag that...'
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: What alternatives have you considered?
+      placeholder: 'Could use spinner package, but want zero deps'
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Use case, benchmarks, screenshots, etc.

.github/pull_request_template.md

@@ -0,0 +1,21 @@
+## Changes
+
+- Describe what this PR does (fix #X, add Y)
+
+## Related Issue
+
+Closes #X (if applicable)
+
+## Testing
+
+- [ ] Added/changed tests pass locally
+- [ ] `uv run pytest`
+- [ ] Linting: `uv run ruff check .`
+
+## Checklist
+
+- [ ] Code follows PEP 8 (ruff enforces)
+- [ ] Docs updated if needed
+- [ ] Version bumped in pyproject.toml if breaking
+
+**Before merging**: Rebase onto main if needed.

.github/workflows/tests.yml

@@ -5,13 +5,16 @@ on:
   pull_request:
     branches:
       - main
+  push:
+    branches:
+      - main
 
 jobs:
   tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.12, 3.13, 3.14]
+        python-version: [3.11, 3.12, 3.13, 3.14]
 
     steps:
       - name: Checkout code

.gitignore

@@ -12,6 +12,9 @@ wheels/
 # Pytest
 .pytest_cache
 
+# Ruff
+.ruff_cache
+
 # Coverage.py
 .coverage
 htmlcov

CONTRIBUTING.md

@@ -0,0 +1,19 @@
+# Contributing to python-zero-spinner
+
+Thanks for interest! This project uses uv for packaging and follows modern Python standards.
+
+## Quick Start
+
+1. Fork and clone
+2. `uv sync --all-groups` for dev env
+3. Use issue templates for bugs/features
+4. Submit PRs from feature branches
+
+## Development
+
+- Tests: `uv run pytest`
+- Lint: `uv run ruff check . --fix`
+- Type Checking: `uv run ty check`
+- Build: `uv build`
+
+See pyproject.toml for classifiers, version, and license details.

README.md

@@ -2,6 +2,8 @@
 
 A minimal, dependency-free spinner for Python CLI applications with rich customization options.
 
+[![Tests](https://github.com/matteozambon89/python-zero-spinner/actions/workflows/tests.yml/badge.svg)](https://github.com/matteozambon89/python-zero-spinner/actions/workflows/tests.yml)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/zero-spinner.svg)](https://pypi.org/project/zero-spinner/)
 [![PyPI version](https://badge.fury.io/py/zero-spinner.svg)](https://badge.fury.io/py/zero-spinner)
 [![Python Version](https://img.shields.io/pypi/pyversions/zero-spinner)](https://pypi.org/project/zero-spinner/)
 [![License](https://img.shields.io/pypi/l/zero-spinner)](LICENSE)

pyproject.toml

@@ -1,9 +1,20 @@
 [project]
 name = "zero-spinner"
-version = "0.1.0"
+version = "0.1.1"
 description = "A zero dependency spinner"
 readme = "README.md"
-requires-python = ">=3.12, <4"
+requires-python = ">=3.11, <4"
+license-files = ["LICENSE"]
+classifiers = [
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+]
 dependencies = []
 
 [dependency-groups]
@@ -30,10 +41,10 @@ include = ["yeeti*"]
 exclude = ["yeeti.examples*"]
 
 [project.urls]
-Homepage = "https://github.com/matteozambon89/zero-spinner"
-Changelog = "https://github.com/matteozambon89/zero-spinner/releases"
-Issues = "https://github.com/matteozambon89/zero-spinner/issues"
-CI = "https://github.com/matteozambon89/zero-spinner/actions"
+Homepage = "https://github.com/matteozambon89/python-zero-spinner"
+Changelog = "https://github.com/matteozambon89/python-zero-spinner/releases"
+Issues = "https://github.com/matteozambon89/python-zero-spinner/issues"
+CI = "https://github.com/matteozambon89/python-zero-spinner/actions"
 
 [tool.ruff]
 line-length = 120

src/yeeti/zero_spinner/__init__.py

@@ -2,3 +2,13 @@
 from .main import Spinner, spinner
 
 __all__ = ['Spinner', 'spinner']
+
+__version__ = '0.0.0'  # Placeholder
+
+try:
+    from importlib.metadata import version
+
+    __version__ = version(__name__)
+except ImportError:
+    # Fallback for direct imports during dev
+    pass