Skip to main content

UniGo

CI Pipeline CD Pipeline GitHub Pages CodeQL Multi-OS Verified Security Audit SBOM Available License: MIT Release Dependabot Enabled pre-commit GitHub Stars GitHub Issues Code Size

English | 简体中文

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 pterm for rich, colorful, and interactive terminal output.
  • Structured Logging: Built-in support for Go's standard slog package for high-performance structured logging.
  • Robust Tooling: Includes built-in commands like doctor, self-update, cache, config, and license.
  • 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/cobra and spf13/viper for powerful command parsing and configuration management.
  • UI & Logging: Integrated pterm for UI components and slog for structured event logging.
  • Database & Caching: SQLite-backed (via modernc.org/sqlite) local caching and transactional data storage.
  • Task Orchestration: Configured with UniRTM for 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

  1. Install UniRTM: Ensure unirtm is installed on your system.
  2. Initialize: unirtm run setup (bootstraps core dependencies and hooks).
  3. Install: unirtm run install (installs project dependencies).
  4. Verify: unirtm run verify (ensures everything is green).
  5. Build: go build -o unigo main.go

Available Commands

  • unigo version: Print the version number
  • unigo doctor: Check system health and diagnose issues
  • unigo self-update: Update to the latest version
  • unigo cache: Manage local cache
  • unigo config: Manage configuration
  • unigo license: Manage copyright license headers

🛠️ Operations Guide

Pre-deployment Checklist

  1. Run unirtm run verify to ensure all quality gates are green (runs formatters, linters, tests, and security audits).
  2. Ensure CHANGELOG.md is updated.

Troubleshooting

  • Problem: unirtm run verify fails 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 verify task using tools like trivy, gitleaks, and govulncheck.
  • 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

Star History Chart

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)

Table of built distributions (wheels) for snowdreamtech-unigo 0.4.0
File Actions
snowdreamtech_unigo-0.4.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for snowdreamtech_unigo-0.4.0-py3-none-win_arm64.whl
snowdreamtech_unigo-0.4.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for snowdreamtech_unigo-0.4.0-py3-none-win_amd64.whl
snowdreamtech_unigo-0.4.0-py3-none-win32.whl Python 3 none Windows x86-32 Details for snowdreamtech_unigo-0.4.0-py3-none-win32.whl
snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_x86_64.whl
snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_s390x.whl Python 3 none Linux glibc 2.17+ IBM System/390x Details for snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_s390x.whl
snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_ppc64le.whl Python 3 none Linux glibc 2.17+ PowerPC 64-le Details for snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_ppc64le.whl
snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details for snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_i686.whl
snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_armv7l.whl Python 3 none Linux glibc 2.17+ ARMv7l Details for snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_armv7l.whl
snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for snowdreamtech_unigo-0.4.0-py3-none-manylinux2014_aarch64.whl
snowdreamtech_unigo-0.4.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for snowdreamtech_unigo-0.4.0-py3-none-macosx_11_0_arm64.whl
snowdreamtech_unigo-0.4.0-py3-none-macosx_10_9_x86_64.whl Python 3 none macOS 10.9+ x86-64 Details for snowdreamtech_unigo-0.4.0-py3-none-macosx_10_9_x86_64.whl

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page