hezor-common 0.1.0__tar.gz

hezor_common-0.1.0/.gitignore

@@ -0,0 +1,43 @@
+# Python-generated files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Distribution
+*.whl

hezor_common-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

hezor_common-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Silo QIAN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hezor_common-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include src/hezor_common *.py py.typed

hezor_common-0.1.0/Makefile

@@ -0,0 +1,40 @@
+.PHONY: help install build publish publish-test clean test
+
+help:
+	@echo "Hezor Common - Build & Publish Commands"
+	@echo ""
+	@echo "Usage:"
+	@echo "  make install        - Install dependencies using uv"
+	@echo "  make build          - Build the package"
+	@echo "  make publish-test   - Publish to TestPyPI"
+	@echo "  make publish        - Publish to PyPI (production)"
+	@echo "  make clean          - Clean build artifacts"
+	@echo "  make test           - Run tests (if any)"
+	@echo ""
+
+install:
+	@echo "📦 Installing dependencies..."
+	uv sync
+
+build:
+	@echo "🔨 Building package..."
+	@./scripts/build.sh
+
+publish-test:
+	@echo "🚀 Publishing to TestPyPI..."
+	@./scripts/publish.sh --test
+
+publish:
+	@echo "🚀 Publishing to PyPI..."
+	@./scripts/publish.sh
+
+clean:
+	@echo "🧹 Cleaning build artifacts..."
+	@rm -rf dist/ build/ *.egg-info
+	@find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
+	@find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
+	@echo "✅ Clean complete"
+
+test:
+	@echo "🧪 Running tests..."
+	@uv run pytest

hezor_common-0.1.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: hezor-common
+Version: 0.1.0
+Summary: Common utilities for Hezor projects
+Project-URL: Homepage, https://github.com/lennon/hezor_common
+Project-URL: Repository, https://github.com/lennon/hezor_common
+Project-URL: Issues, https://github.com/lennon/hezor_common/issues
+Author-email: Silo QIAN <qtisan@hotmail.com>
+License-File: LICENSE
+Keywords: common,hezor,utilities
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Hezor Common
+
+Common utilities for Hezor projects.
+
+## Installation
+
+```bash
+pip install hezor-common
+```
+
+## Usage
+
+```python
+from hezor_common import hello
+
+print(hello())
+```
+
+## Development
+
+### Setup
+
+```bash
+# Install uv if not already installed
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Create virtual environment and install dependencies
+uv sync
+```
+
+### Quick Commands (using Makefile)
+
+```bash
+# Show all available commands
+make help
+
+# Install dependencies
+make install
+
+# Build the package
+make build
+
+# Publish to TestPyPI (recommended for testing)
+make publish-test
+
+# Publish to PyPI (production)
+make publish
+
+# Clean build artifacts
+make clean
+```
+
+### Manual Build and Publish
+
+#### Building
+
+```bash
+# Build the package
+uv build
+
+# Or use the build script
+./scripts/build.sh
+```
+
+#### Publishing to PyPI
+
+Before publishing, you need to:
+
+1. **Register on PyPI/TestPyPI**:
+   - TestPyPI: https://test.pypi.org/account/register/
+   - PyPI: https://pypi.org/account/register/
+
+2. **Configure credentials** (recommended - using API tokens):
+   ```bash
+   # Create ~/.pypirc file
+   cat > ~/.pypirc << EOF
+   [distutils]
+   index-servers =
+       pypi
+       testpypi
+
+   [pypi]
+   username = __token__
+   password = pypi-your-api-token-here
+
+   [testpypi]
+   username = __token__
+   password = pypi-your-test-api-token-here
+   EOF
+   
+   chmod 600 ~/.pypirc
+   ```
+
+3. **Publish**:
+   ```bash
+   # Publish to TestPyPI first (recommended)
+   ./scripts/publish.sh --test
+   # Or: make publish-test
+
+   # After testing, publish to PyPI
+   ./scripts/publish.sh
+   # Or: make publish
+   ```
+
+### Project Structure
+
+```
+hezor_common/
+├── src/
+│   └── hezor_common/
+│       ├── __init__.py
+│       └── py.typed
+├── scripts/
+│   ├── build.sh
+│   ├── publish.sh
+│   └── build-and-publish.sh
+├── pyproject.toml
+├── README.md
+├── LICENSE
+├── MANIFEST.in
+├── Makefile
+└── .gitignore
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+

hezor_common-0.1.0/README.md

@@ -0,0 +1,128 @@
+# Hezor Common
+
+Common utilities for Hezor projects.
+
+## Installation
+
+```bash
+pip install hezor-common
+```
+
+## Usage
+
+```python
+from hezor_common import hello
+
+print(hello())
+```
+
+## Development
+
+### Setup
+
+```bash
+# Install uv if not already installed
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Create virtual environment and install dependencies
+uv sync
+```
+
+### Quick Commands (using Makefile)
+
+```bash
+# Show all available commands
+make help
+
+# Install dependencies
+make install
+
+# Build the package
+make build
+
+# Publish to TestPyPI (recommended for testing)
+make publish-test
+
+# Publish to PyPI (production)
+make publish
+
+# Clean build artifacts
+make clean
+```
+
+### Manual Build and Publish
+
+#### Building
+
+```bash
+# Build the package
+uv build
+
+# Or use the build script
+./scripts/build.sh
+```
+
+#### Publishing to PyPI
+
+Before publishing, you need to:
+
+1. **Register on PyPI/TestPyPI**:
+   - TestPyPI: https://test.pypi.org/account/register/
+   - PyPI: https://pypi.org/account/register/
+
+2. **Configure credentials** (recommended - using API tokens):
+   ```bash
+   # Create ~/.pypirc file
+   cat > ~/.pypirc << EOF
+   [distutils]
+   index-servers =
+       pypi
+       testpypi
+
+   [pypi]
+   username = __token__
+   password = pypi-your-api-token-here
+
+   [testpypi]
+   username = __token__
+   password = pypi-your-test-api-token-here
+   EOF
+   
+   chmod 600 ~/.pypirc
+   ```
+
+3. **Publish**:
+   ```bash
+   # Publish to TestPyPI first (recommended)
+   ./scripts/publish.sh --test
+   # Or: make publish-test
+
+   # After testing, publish to PyPI
+   ./scripts/publish.sh
+   # Or: make publish
+   ```
+
+### Project Structure
+
+```
+hezor_common/
+├── src/
+│   └── hezor_common/
+│       ├── __init__.py
+│       └── py.typed
+├── scripts/
+│   ├── build.sh
+│   ├── publish.sh
+│   └── build-and-publish.sh
+├── pyproject.toml
+├── README.md
+├── LICENSE
+├── MANIFEST.in
+├── Makefile
+└── .gitignore
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+

hezor_common-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "hezor-common"
+version = "0.1.0"
+description = "Common utilities for Hezor projects"
+readme = "README.md"
+authors = [{ name = "Silo QIAN", email = "qtisan@hotmail.com" }]
+requires-python = ">=3.12"
+dependencies = []
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+keywords = ["hezor", "common", "utilities"]
+
+[project.urls]
+Homepage = "https://github.com/lennon/hezor_common"
+Repository = "https://github.com/lennon/hezor_common"
+Issues = "https://github.com/lennon/hezor_common/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hezor_common"]

hezor_common-0.1.0/scripts/build-and-publish.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Complete build and publish script for hezor-common package
+
+set -e
+
+echo "🔄 Building and publishing hezor-common..."
+echo ""
+
+# Build
+./scripts/build.sh
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Publish to TestPyPI by default for safety
+./scripts/publish.sh --test

hezor_common-0.1.0/scripts/build.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Build script for hezor-common package
+
+set -e
+
+echo "🔨 Building hezor-common package..."
+
+# Clean previous builds
+if [ -d "dist" ]; then
+    echo "🧹 Cleaning previous builds..."
+    rm -rf dist/
+fi
+
+if [ -d "build" ]; then
+    rm -rf build/
+fi
+
+# Find and remove egg-info directories
+find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
+
+# Build the package
+echo "📦 Building package..."
+uv build
+
+echo "✅ Build completed successfully!"
+echo ""
+echo "📋 Built packages:"
+ls -lh dist/
+
+echo ""
+echo "💡 To publish to PyPI:"
+echo "   ./scripts/publish.sh"
+echo ""
+echo "💡 To publish to TestPyPI:"
+echo "   ./scripts/publish.sh --test"

hezor_common-0.1.0/scripts/publish.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+# Publish script for hezor-common package
+
+set -e
+
+TEST_PYPI=false
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --test)
+            TEST_PYPI=true
+            shift
+            ;;
+        *)
+            echo "Unknown option: $1"
+            echo "Usage: $0 [--test]"
+            exit 1
+            ;;
+    esac
+done
+
+# Check if dist directory exists
+if [ ! -d "dist" ] || [ -z "$(ls -A dist)" ]; then
+    echo "❌ No build found. Please run ./scripts/build.sh first"
+    exit 1
+fi
+
+# Install twine if not available
+if ! uv pip list | grep -q twine; then
+    echo "📦 Installing twine..."
+    uv pip install twine
+fi
+
+# Publish
+if [ "$TEST_PYPI" = true ]; then
+    echo "🚀 Publishing to TestPyPI..."
+    echo ""
+    echo "📝 You will need TestPyPI credentials."
+    echo "   Sign up at: https://test.pypi.org/account/register/"
+    echo ""
+    uv run twine upload --repository testpypi dist/*
+    echo ""
+    echo "✅ Published to TestPyPI!"
+    echo "🔗 View at: https://test.pypi.org/project/hezor-common/"
+    echo ""
+    echo "💡 To install from TestPyPI:"
+    echo "   pip install --index-url https://test.pypi.org/simple/ hezor-common"
+else
+    echo "🚀 Publishing to PyPI..."
+    echo ""
+    echo "📝 You will need PyPI credentials."
+    echo "   Sign up at: https://pypi.org/account/register/"
+    echo ""
+    echo "⚠️  This will publish to the REAL PyPI!"
+    read -p "Are you sure you want to continue? (y/N) " -n 1 -r
+    echo
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        echo "❌ Cancelled"
+        exit 1
+    fi
+    
+    uv run twine upload dist/*
+    echo ""
+    echo "✅ Published to PyPI!"
+    echo "🔗 View at: https://pypi.org/project/hezor-common/"
+    echo ""
+    echo "💡 To install:"
+    echo "   pip install hezor-common"
+fi

hezor_common-0.1.0/src/hezor_common/__init__.py

@@ -0,0 +1,11 @@
+"""Hezor Common - Common utilities for Hezor projects."""
+
+__version__ = "0.1.0"
+
+def hello() -> str:
+    """Return a greeting message."""
+    return "Hello from hezor-common!"
+
+
+__all__ = ["hello", "__version__"]
+