UniGo
UniGo is a fast, flexible, and enterprise-grade Golang CLI template inspired by UniRTM and helloworld. It provides a robust foundation for building modern command-line applications in Go, featuring beautiful terminal output, structured logging, built-in caching, and a comprehensive CI/CD pipeline.
🌟 Features
- Modern CLI Architecture: Built with Go 1.24+ and Cobra, providing a structured and extensible command-line application framework.
- Beautiful Output: Utilizes
ptermfor rich, colorful, and interactive terminal output. - Structured Logging: Built-in support for Go's standard
slogpackage for high-performance structured logging. - Robust Tooling: Includes built-in commands like
doctor,self-update,cache,config, andlicense. - Triple Guarantee Quality: 100% code purity enforced through IDE checks, Pre-commit hooks, and GitHub Actions integrated quality gates.
- Cross-Platform Ready: Runs seamlessly on macOS, Linux, and Windows.
🏗️ Architecture & Design
Overview
UniGo is engineered to solve the boilerplate problem when starting new Go CLI projects. It standardizes the development environment, architectural patterns, and automation pipelines out of the box.
Core Components
- CLI Framework: Utilizes
spf13/cobraandspf13/viperfor powerful command parsing and configuration management. - UI & Logging: Integrated
ptermfor UI components andslogfor structured event logging. - Database & Caching: SQLite-backed (via
modernc.org/sqlite) local caching and transactional data storage. - Task Orchestration: Configured with
UniRTMfor managing local development workflows (lint, test, verify).
📖 Usage Guide
Prerequisites
- Runtime: Go (>= 1.24).
- Git: Global git installation required.
- UniRTM: Required for task execution and orchestration.
Installation
Via NPM:
npm install -g @snowdreamtech/unigo
Via PyPI:
pip install snowdreamtech-unigo
Quick Start
- Install UniRTM: Ensure
unirtmis installed on your system. - Initialize:
unirtm run setup(bootstraps core dependencies and hooks). - Install:
unirtm run install(installs project dependencies). - Verify:
unirtm run verify(ensures everything is green). - Build:
go build -o unigo main.go
Available Commands
unigo version: Print the version numberunigo doctor: Check system health and diagnose issuesunigo self-update: Update to the latest versionunigo cache: Manage local cacheunigo config: Manage configurationunigo license: Manage copyright license headers
🛠️ Operations Guide
Pre-deployment Checklist
- Run
unirtm run verifyto ensure all quality gates are green (runs formatters, linters, tests, and security audits). - Ensure
CHANGELOG.mdis updated.
Troubleshooting
- Problem:
unirtm run verifyfails with test errors.- Solution: Ensure your code passes all Go unit tests. UniGo enforces strict coverage and race condition checks.
- Problem: Pre-commit hooks fail.
- Solution: The hooks often auto-fix issues (like formatting). Stage the modified files and commit again.
🔒 Security Considerations
Security Model
- Audit Logging: All critical operations and security scans are executed during the
verifytask using tools liketrivy,gitleaks, andgovulncheck. - Dependency Management: Powered by Dependabot to ensure all dependencies are kept up-to-date and secure.
🧑💻 Development Guide
Local Development Setup
git clone https://github.com/snowdreamtech/UniGo.git
cd UniGo
unirtm run setup
unirtm run install
🚀 Proxy Usage Scenarios
The GITHUB_PROXY (default: https://gh-proxy.sn0wdr1am.com/) is optimized for specific network acceleration scenarios. Misusing it for unsupported protocols (like Git) will result in errors.
| Scenario | Supported? | Example / Note |
|---|---|---|
| Release Files | ✅ Yes | .../releases/download/v1.0/tool.zip |
| Source Archives | ✅ Yes | .../archive/master.zip or .tar.gz |
| Direct File Links | ✅ Yes | .../blob/master/filename |
| Git Clone | ❌ No | Do not use for git clone or insteadOf configs. |
| Project Folders | ❌ No | Browsing/cloning via proxy is not supported. |
📄 License
This project is licensed under the MIT License. Copyright (c) 2026-present SnowdreamTech Inc. See the LICENSE file for the full license text.
Star History
Metadata
Release files for snowdreamtech-unigo 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 84.8 MB
Release files / snowdreamtech_unigo-0.4.0-py3-none-win_arm64.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-win_arm64.whl |
|---|---|
| Size | 11.9 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
6e76263e05f69622bb64f9e96a279df5b4ecbbb440adf3095a6e968a793411a9
|
|
BLAKE2b-256 checksum How to use checksums |
3d28276dc32433e3cc2a240e3061f79293f9b856e98746430eaa69ec21670e21
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-win_amd64.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-win_amd64.whl |
|---|---|
| Size | 12.5 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
2270826f1da2d6b93349e1c9f305ea6996a9c45a05d70ebad46e1812793aa409
|
|
BLAKE2b-256 checksum How to use checksums |
001a7754790574c84c29b7ab4e0b8cc477a0f4c0ceda9cb40dfbb617ff708bb4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-win32.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-win32.whl |
|---|---|
| Size | 12.3 MB |
| Tags | Python 3 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
4783900adee2946becd82d1aa895499fe83710ddc3c20657df91f2fad7b1e355
|
|
BLAKE2b-256 checksum How to use checksums |
895b2cfb10212f982f175913acf002b366e9682b95335a3452dd46b7669fc253
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_x86_64.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_x86_64.whl |
|---|---|
| Size | 6.2 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
ac773af77635f1292035feef7bf564777f9573dc5760beab6121f6c60ec244c8
|
|
BLAKE2b-256 checksum How to use checksums |
fdbc957bcda5068f86a169cddb76b2d24074c8157890fbaf45bd14e72a1244c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_s390x.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_s390x.whl |
|---|---|
| Size | 6.1 MB |
| Tags | Linux glibc 2.17+ IBM System/390x Python 3 |
|
SHA-256 checksum How to use checksums |
ed1d74fd50450ff4b5112cc1aeccc9351a48fb69b9303332169bfed1c88a8d65
|
|
BLAKE2b-256 checksum How to use checksums |
27a5e1414238bee504fca43dd803f1fab385954ef0571fb73d6c88b74f7e5608
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_ppc64le.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_ppc64le.whl |
|---|---|
| Size | 5.8 MB |
| Tags | Linux glibc 2.17+ PowerPC 64-le Python 3 |
|
SHA-256 checksum How to use checksums |
2efee0dfe0b0334761985c587f9531776a6c7e30ef815c2cbb863053ed1b8f86
|
|
BLAKE2b-256 checksum How to use checksums |
1af51479c5249b1bc4e859ff44add323cddd372b7374992b691db50a5da3a424
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_i686.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_i686.whl |
|---|---|
| Size | 6.0 MB |
| Tags | Linux glibc 2.17+ x86-32 Python 3 |
|
SHA-256 checksum How to use checksums |
844761dcd4bef24961bac03087ed4594d5a731305e40843f2a7fe9c427311bbf
|
|
BLAKE2b-256 checksum How to use checksums |
705185ef71a0f057abd0ea54a0f460724f223f1e2aa6e46bf5f1109c26a7a7de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_armv7l.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_armv7l.whl |
|---|---|
| Size | 6.0 MB |
| Tags | Linux glibc 2.17+ ARMv7l Python 3 |
|
SHA-256 checksum How to use checksums |
47c09ba39bbdad3878e12cc34d132ae8193aed67d0162d83f50e1006b31bca50
|
|
BLAKE2b-256 checksum How to use checksums |
c40709a46fec6b029b86c3d012696f1f36d5372e2eac037628177bdb1a77bd7e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_aarch64.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_aarch64.whl |
|---|---|
| Size | 5.8 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
ce9f8f53de1f2f655b5c074977f955360d29facb9aacdcf1988394cae02ef2b4
|
|
BLAKE2b-256 checksum How to use checksums |
6438867c8b36a111cea8905be4910db6d5c6888ea8a7bbd9200d6b40bdc2d2a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-macosx_11_0_arm64.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 5.9 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4f2674dbe530e8609d290386685d43d90ecc4451413fcb79a39ac808fce8d41f
|
|
BLAKE2b-256 checksum How to use checksums |
223fa6f740ad0de33169ac1cb5ed2ec4bfe9f61966c71cd6936f3b9b2e77f3af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / snowdreamtech_unigo-0.4.0-py3-none-macosx_10_9_x86_64.whl
| Download URL | snowdreamtech_unigo-0.4.0-py3-none-macosx_10_9_x86_64.whl |
|---|---|
| Size | 6.3 MB |
| Tags | Python 3 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
af3d9678a58d28d02dcdc2cb7ec3bd135c2d7eb92c572902d03812bafba210e1
|
|
BLAKE2b-256 checksum How to use checksums |
31e63a919b813cfa34416f3fabac5f25370033a008290f86cf517b2f181b00b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Security for snowdreamtech-unigo 0.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.