Skip to main content

UniGo

CI Pipeline CD Pipeline 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.5.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.5.0
File Actions
snowdreamtech_unigo-0.5.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for snowdreamtech_unigo-0.5.0-py3-none-win_arm64.whl
snowdreamtech_unigo-0.5.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for snowdreamtech_unigo-0.5.0-py3-none-win_amd64.whl
snowdreamtech_unigo-0.5.0-py3-none-win32.whl Python 3 none Windows x86-32 Details for snowdreamtech_unigo-0.5.0-py3-none-win32.whl
snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_x86_64.whl
snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_s390x.whl Python 3 none Linux glibc 2.17+ IBM System/390x Details for snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_s390x.whl
snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_ppc64le.whl Python 3 none Linux glibc 2.17+ PowerPC 64-le Details for snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_ppc64le.whl
snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details for snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_i686.whl
snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_armv7l.whl Python 3 none Linux glibc 2.17+ ARMv7l Details for snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_armv7l.whl
snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_aarch64.whl
snowdreamtech_unigo-0.5.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for snowdreamtech_unigo-0.5.0-py3-none-macosx_11_0_arm64.whl
snowdreamtech_unigo-0.5.0-py3-none-macosx_10_9_x86_64.whl Python 3 none macOS 10.9+ x86-64 Details for snowdreamtech_unigo-0.5.0-py3-none-macosx_10_9_x86_64.whl

Total release size: 84.8 MB

Release files / snowdreamtech_unigo-0.5.0-py3-none-win_arm64.whl

Download URL snowdreamtech_unigo-0.5.0-py3-none-win_arm64.whl
Size 11.9 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
1259d8af08c6373969edb46b718f1d0832f349cc7ba07725cb4d9e34362ca780
BLAKE2b-256 checksum
How to use checksums
f1337a7bd2acf4446fad86d7f83f7faf9bc4076986a29b12b781358eada8569d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-win_amd64.whl

Download URL snowdreamtech_unigo-0.5.0-py3-none-win_amd64.whl
Size 12.5 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
cc83b23bee5cf25eaacd1fb6dd03f144c328c3cdbba8d0244500bc28344df27f
BLAKE2b-256 checksum
How to use checksums
94a1f1477ad0b15c1f1c6957fd7e9135f8f740bcacd783ba2ac0f89aa747f5f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-win32.whl

Download URL snowdreamtech_unigo-0.5.0-py3-none-win32.whl
Size 12.3 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
3e8b8eea8f4acd741d47bd06b752770774d5c6f5c97546ecf5f569e715caef4a
BLAKE2b-256 checksum
How to use checksums
680ed000f7d9e7c5daf44902769ed977f8379091c23e8be4bdbefb075614e322
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_x86_64.whl

Download URL snowdreamtech_unigo-0.5.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
a28dbac0c360b48ea5fa5fb73c4b2aea54136e3266583dbbee4666814de4d581
BLAKE2b-256 checksum
How to use checksums
02bc34188e671332438615f66e738d131e2f512dfd3616bcce258a1ae1335b8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_s390x.whl

Download URL snowdreamtech_unigo-0.5.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
ead7319611aef5381f0a8d120edd54368c5713ef6fbe31a02ff24a1c58e705c4
BLAKE2b-256 checksum
How to use checksums
e8f680d3f51953d655415a17b60fdc326da3b5b6cc0f41383b7fc6afc9bef7f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_ppc64le.whl

Download URL snowdreamtech_unigo-0.5.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
8df6bc2bcc0754c511af17920c2187daf6b359245044d1a980f133c9203af3e6
BLAKE2b-256 checksum
How to use checksums
db98f970ecadf860d78e87cde1f7d8bc5556fbfcf141904e391f92f6ac919cd9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_i686.whl

Download URL snowdreamtech_unigo-0.5.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
aae86fc58ac611475035f845cc79856659c5f9ed5725b6758217766abb270d27
BLAKE2b-256 checksum
How to use checksums
bf63b8c97e37a15ad47fa37e6dd7d856500487d932573f2c4268dd9a81b88425
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_armv7l.whl

Download URL snowdreamtech_unigo-0.5.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
9cbe23985c62f817db9ce7c3e604a8ad552ae144845ced9cddd04180fae5b85b
BLAKE2b-256 checksum
How to use checksums
70745a27a4c9971ead271495311af3632fdbb1c3f4e1a9afad4fee6565c1fe42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-manylinux2014_aarch64.whl

Download URL snowdreamtech_unigo-0.5.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
3a7e4546f13ee10907fde2bfe757311d0416af57137be8c020efb3ac0b016177
BLAKE2b-256 checksum
How to use checksums
525ff42d585fae9d812f2e474b95b4267205cc408fe2a576b2bb75c524721ca5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-macosx_11_0_arm64.whl

Download URL snowdreamtech_unigo-0.5.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
bb337b1fc00424aa0fc32ded68ee1fe202e6456cf0693dae46ff555f9beacb87
BLAKE2b-256 checksum
How to use checksums
3bcbf086354e16beb960c66589e54262e0f130e964a7e6e61e95718daa38d920
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / snowdreamtech_unigo-0.5.0-py3-none-macosx_10_9_x86_64.whl

Download URL snowdreamtech_unigo-0.5.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
a2dd88d80575c2ea16692d1ff5a62e2fe55d0ae932f7a4b2e9679b48d76181d4
BLAKE2b-256 checksum
How to use checksums
fb1d313511ff27c040ab621a1c2f359c1e7b7af03b955e613b0ac34402cd74bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Security for snowdreamtech-unigo 0.5.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