# pybuild-xtra 🚀
**pybuild-xtra** is a streamlined configuration-driven wrapper for building and automatically publishing Python packages to PyPI using .pbs (PyBuild Specification) files.
## 📦 Features
* **Config-Driven Workflow (.pbs)** — manage versioning, package metadata, and auto-uploads via a clean TOML configuration file.
* **AI README Generation via Gemini** — automatically generates professional project documentation from a brief description.
* **One-Click PyPI Uploads** — set autoupload = true to build and deploy directly to PyPI using twine.
* **Flexible Toolchain Support** — automatically generates valid pyproject.toml or setup.py on the fly.
## 🛠 Quick Start
1. **Generate a default configuration file:**
```bash
python -m pybuild-xtra --create-pbs-file
```
Or target a specific script name:
python -m pybuild-xtra my\_script --create-pbs-file
Configure your .pbs file:
\[build]
name = "my-awesome-lib"
ai\_description = false
description = "Super fast toolkit"
version = "0.1.0"
autoupload = true
\[setup]
use = "pyproject.toml"
dependencies = \["requests"]
Build and publish:
python -m pybuild-xtra my\_script
Built with pybuild-xtra!
Metadata
Release files for pybuild-xtra 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pybuild_xtra-0.1.0.tar.gz | 4.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pybuild_xtra-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.9 kB
Release files / pybuild_xtra-0.1.0.tar.gz
| Download URL | pybuild_xtra-0.1.0.tar.gz |
|---|---|
| Size | 4.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7202d74aff555115eca6fef0fa74687e7143ca41625e100b5dc799189d77ac67
|
|
BLAKE2b-256 checksum How to use checksums |
88e54b147098f2733020616cd9ad5c9dfeb247db4b60db7327a393af78584b78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
Release files / pybuild_xtra-0.1.0-py3-none-any.whl
| Download URL | pybuild_xtra-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
edc5292c8ad016c124b7b6f0ef79f143082f18cb6790d7a47607bab499fcbd3e
|
|
BLAKE2b-256 checksum How to use checksums |
f94ac650604ed53c7e984f4ae0738e16da7dbd1c246c352bbe3ccd3b21405bbb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|