{"id":48366974,"url":"https://github.com/drakemazzy/sanctify","last_synced_at":"2026-04-05T15:00:56.107Z","repository":{"id":349344070,"uuid":"1201922328","full_name":"DrakeMazzy/sanctify","owner":"DrakeMazzy","description":"Automated semantic versioning, changelog generation, and release tool for Git repositories","archived":false,"fork":false,"pushed_at":"2026-04-05T13:46:22.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-05T14:17:36.017Z","etag":null,"topics":["changelog","ci-cd","cli","conventional-commits","devops","golang","release-automation","semver","versioning"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DrakeMazzy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-05T10:52:53.000Z","updated_at":"2026-04-05T13:46:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DrakeMazzy/sanctify","commit_stats":null,"previous_names":["drakemazzy/sanctify"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/DrakeMazzy/sanctify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrakeMazzy%2Fsanctify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrakeMazzy%2Fsanctify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrakeMazzy%2Fsanctify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrakeMazzy%2Fsanctify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DrakeMazzy","download_url":"https://codeload.github.com/DrakeMazzy/sanctify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrakeMazzy%2Fsanctify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31439442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T13:13:19.330Z","status":"ssl_error","status_checked_at":"2026-04-05T13:13:17.778Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["changelog","ci-cd","cli","conventional-commits","devops","golang","release-automation","semver","versioning"],"created_at":"2026-04-05T15:00:55.064Z","updated_at":"2026-04-05T15:00:56.099Z","avatar_url":"https://github.com/DrakeMazzy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sanctify\n\n[![Go CI](https://github.com/DrakeMazzy/sanctify/actions/workflows/ci.yml/badge.svg)](https://github.com/DrakeMazzy/sanctify/actions/workflows/ci.yml)\n[![Release](https://img.shields.io/github/v/release/DrakeMazzy/sanctify)](https://github.com/DrakeMazzy/sanctify/releases/latest)\n[![Go Version](https://img.shields.io/github/go-mod/go-version/DrakeMazzy/sanctify)](go.mod)\n[![License](https://img.shields.io/github/license/DrakeMazzy/sanctify)](LICENSE)\n\nSanctify is a minimalist Go-based tool for automating versioning, changelog generation, and software releases. It automates tagging, updates version metadata in configuration files, and pushes changes to a remote Git repository.\n\n## ⚡ Quick Start\n\n```bash\n# Install\ngo install github.com/DrakeMazzy/sanctify@latest\n\n# Run in your git repository\ncd your-project\nsanctify --dry-run   # preview the next version\nsanctify             # create release\n```\n\n## 📦 Features\n\n1.  **Automated Versioning**: Calculates the next semantic version based on commit messages using strict **Conventional Commits v1.0.0** parsing (including Scopes, Breaking indicators `!`, and Footers).\n2.  **Context-Aware Releases**: Supports different branch strategies:\n    - `main`/`master` (or specified via `--tag-branch`) → stable version (e.g., `1.2.3`).\n    - PR/Merge Requests → `-rc.N` suffix (e.g., `1.2.3-rc.42`).\n    - Development branches → `-HASH` suffix (e.g., `1.2.3-abcdef1`).\n3.  **Metadata Updates**: Automatically finds and updates versions in:\n    - **Go**: `main.go` (updates `const Version = \"...\"`)\n    - **Universal**: `VERSION` (plain text file)\n    - **Node.js**: `package.json`, `package-lock.json`\n    - **PHP/Composer**: `composer.json`\n    - **Puppet**: `metadata.json`\n    - **Ansible**: `meta/main.yml`\n    - **Terraform**: `version.tf` (searches for `version = \"...\"` or `default = \"...\"`)\n    - **Drupal**: `*.info.yml` (all files in the root)\n    - **Docker**: `Dockerfile*` (labels and environment variables)\n4.  **Changelog Generation**: Updates `CHANGELOG.md` with grouped commits (Breaking Changes, Features, Bug Fixes, Maintenance).\n5.  **CI/CD Support**: Detects PR numbers from GitHub, GitLab, Bitbucket, and Jenkins.\n6.  **Safety**: Displays help when run without parameters and works correctly outside of Git repositories (using default values).\n\n## 🔧 Installation\n\n### Homebrew (macOS / Linux)\n```bash\nbrew tap DrakeMazzy/tap\nbrew install --cask sanctify\n```\n\n\u003e **macOS note:** if the binary is blocked by Gatekeeper, run:\n\u003e ```bash\n\u003e xattr -d com.apple.quarantine $(brew --prefix)/bin/sanctify\n\u003e ```\n\n### Debian / Ubuntu\n```bash\n# Download the latest .deb from GitHub Releases\ncurl -LO https://github.com/DrakeMazzy/sanctify/releases/latest/download/sanctify_$(curl -s https://api.github.com/repos/DrakeMazzy/sanctify/releases/latest | grep tag_name | cut -d'\"' -f4 | tr -d v)_linux_amd64.deb\nsudo dpkg -i sanctify_*.deb\n```\n\n### RPM (Fedora / RHEL / CentOS)\n```bash\n# Download the latest .rpm from GitHub Releases\ncurl -LO https://github.com/DrakeMazzy/sanctify/releases/latest/download/sanctify_$(curl -s https://api.github.com/repos/DrakeMazzy/sanctify/releases/latest | grep tag_name | cut -d'\"' -f4 | tr -d v)_linux_amd64.rpm\nsudo rpm -i sanctify_*.rpm\n```\n\n### Go Install\n```bash\ngo install github.com/DrakeMazzy/sanctify@latest\n```\n\n### Direct Download\nDownload the latest pre-compiled binary for your platform from the [GitHub Releases](https://github.com/DrakeMazzy/sanctify/releases) page.\n\n### Manual Build\n```bash\ngit clone https://github.com/DrakeMazzy/sanctify.git\ncd sanctify\ngo build -o sanctify main.go\n```\n\n## 🚀 Usage\n\n### Running\n```bash\n# Help\nsanctify --help\n\n# Current version\nsanctify --version\n\n# Automated release\nsanctify\n\n# Dry run (prints version string only)\nsanctify --dry-run\n\n# Explicit context override\nsanctify --context feature\n\n# Custom tag branches\nsanctify --tag-branch production,release\n\n# Version override\nsanctify 1.2.3\n```\n\n## 🔌 CI/CD Examples\n\n### GitHub Actions\n```yaml\nname: Auto Tag\non:\n  push:\n    branches: [main]\njobs:\n  tag:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v5\n        with:\n          fetch-depth: 0\n          token: ${{ secrets.GH_PAT }}\n      - run: go run github.com/DrakeMazzy/sanctify@latest\n        env:\n          GITHUB_TOKEN: ${{ secrets.GH_PAT }}\n```\n\n### GitLab CI\n```yaml\nsanctify:\n  stage: deploy\n  image: golang:latest\n  script:\n    - go run github.com/DrakeMazzy/sanctify@latest\n  only:\n    - main\n  variables:\n    GITLAB_TOKEN: $GITLAB_RELEASE_TOKEN # Project Access Token with 'write_repository'\n```\n\n### Bitbucket Pipelines\n```yaml\npipelines:\n  branches:\n    main:\n      - step:\n          name: Sanctify Release\n          image: golang:latest\n          script:\n            - go run github.com/DrakeMazzy/sanctify@latest\n          services:\n            - docker\n          variables:\n            BITBUCKET_TOKEN: $BITBUCKET_ACCESS_TOKEN # Repository Access Token\n```\n\n## 🏗️ Architecture \u0026 Technologies\n\n- **Language**: Go 1.26.1+\n- **Libraries**: `go-git/v5`, `Masterminds/semver/v3`.\n- **License**: **CC0 1.0 Universal** (Public Domain).\n- **CI/CD**: GitHub Actions for testing and GoReleaser for automated releases.\n\n## 📝 Development Conventions\n\n- **Conventional Commits**: Follow the specification. Use `feat`, `fix`, `perf`, `docs`, `test`, `ci`, `chore`, `refactor`, `build`, `style`, `revert`.\n- **Breaking Changes**: Use `!` in the header or `BREAKING CHANGE:` in the footer.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrakemazzy%2Fsanctify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrakemazzy%2Fsanctify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrakemazzy%2Fsanctify/lists"}