---

🎯 Why Choose KX-Publish-PyPI?

---

💻 Installation

⚡ Quick Install

pip install kx-publish-pypi

✅ Verify Installation

kx-publish-pypi --version

---

💻 Account Setup & Token Generation

1. Create PyPI Account

1. 🌐 Visit pypi.org
2. 📝 Click "Register" in the top right
3. ✉️ Fill out the registration form
4. ✅ Verify your email address

2. Create TestPyPI Account

1. 🌐 Visit test.pypi.org
2. 📝 Click "Register" in the top right
3. ✉️ Fill out the registration form
4. ✅ Verify your email address

3. Generate API Tokens

For PyPI Production:

1. 🔑 Log in to pypi.org
2. ⚙️ Go to Account Settings → API tokens
3. ➕ Click "Add API token"
4. 🏷️ Give it a name (e.g., "kx-publish-pypi")
5. 💾 Copy & Save the token (you won't see it again!)

For TestPyPI:

1. 🔑 Log in to test.pypi.org
2. ⚙️ Go to Account Settings → API tokens
3. ➕ Click "Add API token"
4. 🏷️ Give it a name (e.g., "kx-publish-pypi-test")
5. 💾 Copy & Save the token

4. Store Tokens Securely

Use the CLI to store your tokens securely:

kx-publish-pypi setup-tokens

This will prompt you to enter your TestPyPI and PyPI tokens, which will be stored in your system's keyring.

💡 Pro Tip: You can also store tokens directly during the guided workflow:

kx-publish-pypi run

---

🚀 Quick Start

🎯 Option 1: Complete Guided Workflow (Recommended)

kx-publish-pypi run

🛠️ Option 2: Individual Commands

# 🔍 Pre-flight check your package
kx-publish-pypi check

# 🔐 Setup API tokens securely
kx-publish-pypi setup-tokens

# 📈 Bump version (patch/minor/major)
kx-publish-pypi bump patch

# 🧪 Publish to TestPyPI first
kx-publish-pypi publish-test

# 🚀 Publish to production PyPI
kx-publish-pypi publish-prod

---

✨ Key Features

---

🏗️ Supported Build Backends

---

🚀 Programmatic API

from kx_publish_pypi import detect_package_version
from pathlib import Path

# Enhanced version detection
result = detect_package_version(Path("."))
if result.version_info:
    print(f"📦 Version: {result.version_info.version}")
    print(f"🔧 Method: {result.version_info.method}")

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

🐛 Found a Bug?

• 🐛 Open an Issue
• 💡 Suggest a Feature

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---