Release Candidate v2.0.0-rc.1
Pre-releaseπ§ Custy v2.0.0-rc.1 β Major Architecture and Workflow Release Candidate
Custy v2.0.0-rc.1 is the first release candidate for the 2.0 major release.
It consolidates the large set of changes developed after the 1.10.x line and
is intended for users and contributors who want to validate the new CLI,
configuration system, changelog generator, and release pipelines before the
stable v2.0.0 release.
The central change in Custy 2.0 is a move from a mostly monolithic Git
automation script to a structured developer-productivity platform. Commands are
now easier to discover, workflows are explicit, configuration is centralized,
and the internal architecture is substantially easier to test, debug, maintain,
and extend.
π Highlights
- A new Typer and Rich CLI with clearer help, output, progress, validation, and error guidance.
- Focused commands for initialization, validation, versioning, changelog generation, commit, tag, push, backup, and cleanup.
- Reusable
custy run dev,custy run release, andcusty run fullpipelines with explicit ordered steps. - A rebuilt, configuration-driven changelog system with Conventional Commit parsing, type/scope grouping, pending-commit support, release sorting, comparison links, and Jinja rendering.
- Determinate changelog progress that reports
Unreleasedcontent and every discovered Git tag during history collection. - A centralized
.config/custy/config.tomlschema covering CLI behavior, paths, templates, versioning, Git remotes, cleanup, logging, workflows, and detailed changelog behavior. - Improved SemVer, PEP 440, Commitizen, date, and Git-count version workflows.
- Safer Git operations, multi-remote synchronization, template backups, retention cleanup, and protected branch cleanup.
- Docker, Docker Compose, Make, GitHub Actions, GitLab CI, pre-commit, packaging, and release automation support.
- Comprehensive English and Indonesian documentation through the Devalltect documentation portal.
π» Better for Custy users
custy initcreates the configuration and templates needed by a project.custy validatechecks project readiness before release operations.- Individual commands remain available when only one operation is needed.
- Pipeline profiles provide predictable end-to-end workflows without hiding execution order.
- Global
--dry-run,--no-dry-run,--debug, and--log-levelcontrols improve safety and troubleshooting. - Dry-run keeps read-only discovery and validation available while simulating intended file, editor, Git, and remote mutations; normal diagnostic logging remains active.
- Rich terminal panels, tables, changelog progress output, and summaries make results easier to understand.
π§° Better for contributors and integrators
- CLI presentation and domain behavior are now separated under
app/cliandapp/core. - Git execution, version strategies, pipelines, changelog processing, initialization, cleanup, UI, and configuration have focused extension points.
- Smaller components and explicit interfaces make features easier to locate, test, replace, and extend.
- The test suite now covers CLI, core, integration, regression, configuration, logging, UI, and workflow behavior.
- Modular Make targets and documented architecture simplify local development and release maintenance.
π Documentation
Custy 2.0 introduces a dedicated documentation hub on the Devalltect Docs
portal. For current installation, command, configuration, workflow,
troubleshooting, user, and contributor guidance, use:
- English (default): https://devalltect00.github.io/devalltect-docs/docs/custy
- Indonesian: https://devalltect00.github.io/devalltect-docs/id/docs/custy
The portal is the primary documentation experience for the Custy 2.0 release
line. Repository-local documentation may remain useful for project history and
source-level references, but users should follow the portal for current usage
guidance.
π Changelog improvements
The changelog generator has been rebuilt around typed release and commit models.
It can clean and parse structured messages, recognize breaking changes, group
entries by type and scope, integrate a pending release commit, remove duplicate
entries, sort releases, generate comparison links, and render a consistent
CHANGELOG.md from configurable templates. A determinate progress display now
tracks Unreleased content and each discovered tag while history is collected.
During dry-run, the same collection and rendering can run without replacing the
existing changelog file.
β οΈ Upgrade notes for 1.x users
- Custy now requires Python 3.14 or newer.
- Replace
.custor.tomlwith the generated.config/custy/config.tomlconfiguration. - Review generated files under
.config/custy/templatesbefore running commit or release workflows. - Replace old
custy allusage withcusty run releaseorcusty run full. - Replace
custy commit-tag-bumpwith focused commands or an appropriatecusty runprofile. - Replace
custy cleaned-backupswithcusty cleanup backups. - Replace
custy clean-brancheswithcusty cleanup branches. - Use
custy changelog generatefor standalone changelog generation. - Run
custy --helpand each command's--helpoutput before migrating automation scripts.
π§ͺ Recommended RC validation
Please validate this release candidate in a non-production repository first:
- Install Custy v2.0.0-rc.1 in an isolated Python 3.14 environment.
- Run
custy initand review the generated configuration and templates. - Run
custy validate. - Preview the intended profile with
custy --dry-run run devorcusty --dry-run run release. - Verify version files, changelog output, commit/tag messages, remotes, cleanup rules, and configured diagnostic-log destinations before allowing side effects.
- Report migration problems or unexpected output before the stable v2.0.0 promotion.
π§ Release-candidate status
- This is a pre-release and is not yet the final production release.
- The
custy workflowbranch-policy feature remains experimental and should be used cautiously. - Container publishing names and release metadata should receive a final verification before the stable release.
- The stable v2.0.0 release may include final cleanup, documentation corrections, migration refinements, and fixes discovered during RC validation.
Thank you for testing Custy 2.0 and helping validate the new foundation before
the stable release.
Release: v2.0.0-rc.1
Stability: Release Candidate
Author: Devalltect / Rizky Fernandes
π Release Information
- Version:
2.0.0-rc.1 - Python Package Version:
2.0.0rc1 - Release Type:
rc - Project:
devalltect00/Custy - Commit: 06b88d63