### ZPP
Fast C++ build/run, metrics, and optimization hints with a real-time terminal UI.
[CI badge](https://github.com/yourname/zpp/actions)
### Quickstart
```bash
pipx install zpp-beta # or: pip install --user zpp-beta
zpp init
zpp main.cpp # build + run
zpp ui main.cpp # open two-pane UI
```
### Features
- Build/run defaults: `-std=c++17 -O2 -pipe -Wall -Wextra`
- Two-pane Textual UI: left code, right metrics and hints
- Rule-based hints (offline) + optional AI hints
- Bench and mem commands for performance
- Auto-install guidance for g++/clang++ on Linux/macOS/Windows
### CLI
- `zpp <file.cpp>`: build + run quickly
- `zpp build <file.cpp> [--release] [--debug] [--flags "..."]`
- `zpp run [binary | file.cpp] [--args "..."]`
- `zpp bench <file.cpp> [--repeat 10]`
- `zpp mem <file.cpp>`
- `zpp hint <file.cpp> [--ai]`
- `zpp ui <file.cpp>`
- `zpp doctor`
- `zpp install-gpp [--dry-run] [--yes]`
- `zpp init`
- `zpp config`
- `zpp selfcheck`
### Auto-update for clients
If installed via pipx:
```bash
pipx upgrade zpp-beta
```
Or use the built-in command:
```bash
zpp self-update
```
Admins can point to TestPyPI for canary:
```bash
zpp self-update --index-url https://test.pypi.org/simple/
```
### Release process
- Push to `main` publishes to TestPyPI automatically.
- Tag a release `vX.Y.Z` to publish to PyPI.
### Snippets (Hints)
Before:
```cpp
vector<int> a;
for (int i=0;i<n;i++) a.push_back(i);
```
After:
```cpp
vector<int> a;
a.reserve(n);
for (int i=0;i<n;i++) a.push_back(i);
```
Before:
```cpp
void f(std::string s);
```
After:
```cpp
void f(const std::string& s); // or std::string_view
```
Before:
```cpp
for(...) y += pow(x, 2);
```
After:
```cpp
y += x * x;
```
### Packaging
- `pyproject.toml` exposes `zpp` entrypoint
- Optional single-binary via PyInstaller
### License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "zpp-beta",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "benchmark, c++, cli, developer-tools, g++, optimization, textual",
"author": "ZPP Authors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/e0/0f/1ea28f96994582081ba74e986185493311f43ac0b3e9de534c00855de8fa/zpp_beta-0.1.4.tar.gz",
"platform": null,
"description": "### ZPP\n\nFast C++ build/run, metrics, and optimization hints with a real-time terminal UI.\n\n[CI badge](https://github.com/yourname/zpp/actions)\n\n### Quickstart\n\n```bash\npipx install zpp-beta # or: pip install --user zpp-beta\nzpp init\nzpp main.cpp # build + run\nzpp ui main.cpp # open two-pane UI\n```\n\n### Features\n- Build/run defaults: `-std=c++17 -O2 -pipe -Wall -Wextra`\n- Two-pane Textual UI: left code, right metrics and hints\n- Rule-based hints (offline) + optional AI hints\n- Bench and mem commands for performance\n- Auto-install guidance for g++/clang++ on Linux/macOS/Windows\n\n### CLI\n\n- `zpp <file.cpp>`: build + run quickly\n- `zpp build <file.cpp> [--release] [--debug] [--flags \"...\"]`\n- `zpp run [binary | file.cpp] [--args \"...\"]`\n- `zpp bench <file.cpp> [--repeat 10]`\n- `zpp mem <file.cpp>`\n- `zpp hint <file.cpp> [--ai]`\n- `zpp ui <file.cpp>`\n- `zpp doctor`\n- `zpp install-gpp [--dry-run] [--yes]`\n- `zpp init`\n- `zpp config`\n- `zpp selfcheck`\n\n### Auto-update for clients\n\nIf installed via pipx:\n```bash\npipx upgrade zpp-beta\n```\n\nOr use the built-in command:\n```bash\nzpp self-update\n```\n\nAdmins can point to TestPyPI for canary:\n```bash\nzpp self-update --index-url https://test.pypi.org/simple/\n```\n\n### Release process\n\n- Push to `main` publishes to TestPyPI automatically.\n- Tag a release `vX.Y.Z` to publish to PyPI.\n\n### Snippets (Hints)\n\nBefore:\n```cpp\nvector<int> a;\nfor (int i=0;i<n;i++) a.push_back(i);\n```\nAfter:\n```cpp\nvector<int> a;\na.reserve(n);\nfor (int i=0;i<n;i++) a.push_back(i);\n```\n\nBefore:\n```cpp\nvoid f(std::string s);\n```\nAfter:\n```cpp\nvoid f(const std::string& s); // or std::string_view\n```\n\nBefore:\n```cpp\nfor(...) y += pow(x, 2);\n```\nAfter:\n```cpp\ny += x * x;\n```\n\n### Packaging\n\n- `pyproject.toml` exposes `zpp` entrypoint\n- Optional single-binary via PyInstaller\n\n### License\n\nMIT\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "ZPP: Zero-hassle C++ build/run, metrics, and optimization hints with a real-time terminal UI",
"version": "0.1.4",
"project_urls": null,
"split_keywords": [
"benchmark",
" c++",
" cli",
" developer-tools",
" g++",
" optimization",
" textual"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bd84e1d616425ace0e8e37f14eca693b922127aa7333b3a9cc7653111b5cffb9",
"md5": "8265dba9d5350c6d93724a1e9e57dc3c",
"sha256": "dc85207760231c446cb364d393c2cda4b5bffc565279969309ffdad7a6ee18be"
},
"downloads": -1,
"filename": "zpp_beta-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8265dba9d5350c6d93724a1e9e57dc3c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 17216,
"upload_time": "2025-09-14T15:41:50",
"upload_time_iso_8601": "2025-09-14T15:41:50.113673Z",
"url": "https://files.pythonhosted.org/packages/bd/84/e1d616425ace0e8e37f14eca693b922127aa7333b3a9cc7653111b5cffb9/zpp_beta-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e00f1ea28f96994582081ba74e986185493311f43ac0b3e9de534c00855de8fa",
"md5": "aa92ff6431f5714386e904f8cfa28de8",
"sha256": "3e4c370dd672a7be7f8e166936bd3ebc3a5167608bf22a5be4894ce92bddf8e1"
},
"downloads": -1,
"filename": "zpp_beta-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "aa92ff6431f5714386e904f8cfa28de8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 14548,
"upload_time": "2025-09-14T15:41:51",
"upload_time_iso_8601": "2025-09-14T15:41:51.461520Z",
"url": "https://files.pythonhosted.org/packages/e0/0f/1ea28f96994582081ba74e986185493311f43ac0b3e9de534c00855de8fa/zpp_beta-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-14 15:41:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "zpp-beta"
}
JSON