hezor-common 0.1.0

Common utilities for Hezor projects

Hezor Common

Common utilities for Hezor projects.

Installation

pip install hezor-common

Usage

from hezor_common import hello

print(hello())

Development

Setup

# 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)

# 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

# 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):

   # 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:

   # 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.