RubyMetric/chsrc
Chsrc
chsrc is a cross-platform command-line tool that changes package manager and software repository URLs to faster or local mirrors across Linux, macOS, Windows, and BSD. It functions as a source mirror framework, embedding a database of mirror URLs and metadata directly into its binary at build time, eliminating the need for plugins or runtime downloads.
The tool distinguishes itself through idempotent configuration patching, rewriting repository configuration files deterministically so repeated runs produce the same result and restoration is always possible. It includes a latency probe that measures TCP connection time to available mirrors and automatically selects the fastest one without user intervention, and supports scoped source changes at the project, user, or system level depending on the target's configuration capabilities.
chsrc provides a unified interface for switching software sources, listing supported targets and mirrors, restoring default upstream URLs, and applying specific mirrors from a list or custom URL. Its architecture abstracts every package manager's config format behind a single command-line interface and a common source-switching API, using platform-agnostic shell commands and file writes to modify system configuration files across operating systems.
Features
- Source Changers - Changes package manager and software repository URLs to faster mirrors across Linux, macOS, Windows, and BSD.
- Source Switchers - Switches package manager and software repository URLs to faster or local mirrors across multiple operating systems.
- Idempotent Config Patchers - Rewrites repository configuration files deterministically so repeated runs produce the same result.
- Platform-Agnostic Config Patchers - Uses shell commands and file writes to modify configuration files identically across Linux, macOS, Windows, and BSD.
- Embedded Mirror Databases - Embeds a database of mirror URLs and metadata directly into the binary at build time.
- Platform-Agnostic Config Patchers - Uses platform-agnostic shell commands and file writes to modify system configuration files across operating systems.
- Source Mirror Frameworks - Provides a framework for changing software sources that supports multiple package managers, operating systems, and mirror providers.
- Mirror Source Restorations - Restores original upstream repository URLs after mirror changes, undoing previous source modifications.
- Idempotent - Rewrites repository configuration files deterministically so repeated runs produce the same result and restoration is always possible.
- Embedded Mirror Databases - Stores mirror URLs and metadata for hundreds of software targets directly in the binary.
- Repository URL Managers - Manages repository URLs by switching to mirrors or restoring original upstream sources for various software.
- Multi-Platform Mirror Switchers - Switches package manager and software repository URLs to faster or local mirrors across operating systems and CPU architectures.
- Unified Source Abstraction Layers - Abstracts every package manager's config format behind a single command-line interface and common API.
- Mirror Latency Selectors - Measures network latency to available mirrors and automatically applies the fastest one for a given software target.
- Deterministic Config Rewriters - Rewrites repository configuration files deterministically so repeated runs produce the same result.
- Mirror - Automatically measures network latency to available mirrors and selects the fastest one for a given software target.
- Multi-Platform - Switches package manager and software repository URLs to faster or local mirrors across different operating systems.
- Multi-Platform Source Switchers - Changes package manager and software repository URLs to faster or local mirrors across multiple operating systems.
- Scoped Source Configurators - Supports per-project, per-user, and system-wide source changes by writing to different config paths or environment variables depending on the target.
- Mirror Latency Probes - Measures TCP connection time to available mirrors and automatically selects the fastest one.
- Custom Mirror Applicators - Applies a user-chosen mirror from a list of supported sources or a custom URL provided by the user.
- Mirror Source Redirection - Automatically selects the fastest mirror by measuring latency to available sources for a given target.
- Source Restorers - Restores the original upstream repository URLs for a given target, undoing any mirror changes.
- Custom Mirror Applicators - Applies a user-specified mirror URL or selects from a list of supported mirrors for any supported software target.
- Mirror List Displays - Displays all software, operating systems, and languages that can be mirrored, along with their mirror options.
- Scoped Mirror Configurations - Applies mirror changes at project, user, or system level depending on target software support.
- Scoped Source Configurators - Restricts mirror changes to the current project, the current user, or the entire system.
