The ucm utility quickly switches multiple dev configs with a single command.
Manages: hosts file entry, Git config, Node version, Node repository, environment variables, etc.
If you work on different projects requiring different environment you can change all of your settings with a single CLI command.
Like that:
> ucm ls
Universal Configs Manager:
- personal
- work <= current
> ucm
Configured [work]:
- Git config
- user.email: [email protected]
- Node version: 10.2.1
- Node Repository: work => https://registry.work.example.com/
- Environment variables:
- HTTP_PROXY: https://proxy.work.example.com
> ucm use --name personal
Configured [personal]:
- Git config
- user.email: [email protected]
- Node version: 15.6.1
- Node Repository: npm => https://registry.npmjs.org/
- Environment variables:
- HTTP_PROXY: (none)
There is a dedicated page about available command.
- Environment variables — Originally it was planned to perform changing of env vars in a shell the UMC has been run. Unfortunately it does not look to be possible without gdb hack and this seems to be too difficult, dangerous & unstable. As an alternative we can output to console a script for setting env vars that user should copy-paste and execute manually. This is not ideal but still good enough as information is easily available & quick to use.
- Environment variables
- Git configuration
- NVM - Node Version Manager
- NRM - Node Repository Manager
Ideas & contributions are welcome on how to make it expandable.
A named configs profile can point to a file in a shared folder or URL. This way you can share configuration with your team.
> umc add --url https://example.com/my-team/.ucm.prod.yaml --name work-prod
> umc add --path //shared_folder/.ucm.test.yaml --name work-test --sync auto
ask- ask to update if changed (default)auto- auto update if changednone- do not check for updates
Can apply settings stored inside your project in a .universal-configs.yaml file.
~/projects/> ucm use --file ./some-project/.universal-configs.yaml
Configured [work]:
- Git config
- user.email: [email protected]
Configured [~/projets/some-project/.universal-configs.yaml]:
- Node version: 10.2.1
- Node Repository: work => https://registry.work.example.com/
- Environment variables:
- HTTP_PROXY: https://proxy.work.example.com
> ucm diff --file https://example.com/some-company.yaml --name personal
Compared:
- File: https://example.com/some-company.yaml
- Named: personal
╔════════════════════════╤═══════════════════╤═══════════════════╗
║ ↓ Configs / Profiles → │ some-company.yaml │ personal ║
╟────────────────────────┼───────────────────┼───────────────────╢
║ Git config │ │ ║
║ - user.email │ (none) │ [email protected] ║
╟────────────────────────┼───────────────────┼───────────────────╢
║ Enviroment vars │ │ ║
║ - HTTP_PROXY │ https://proxy │ (none) ║
╚════════════════════════╧═══════════════════╧═══════════════════╝
If you have an idea on what can be added to UCM please start a discussion first before opening an issue.
Developed in Go language so it's fast and works on any OS suported by Go.
You can install from sources or download binaries.
> go get github.com/sneat-team/universal-configs-manager
> cd universal-configs-manager
> go install cli/ucm/ucm.go
Not available yet.
Not available yet.
Contributors wanted, PRs are welcome.
There is a roadmap document that outlines plans & ideas.
To get source codes:
> git clone https://github.com/sneat-team/universal-configs-manager.git
> cd universal-configs-manager
To build an executable file run:
> go build cli/ucm/ucm.go
This will generate the ucm executable in the current directory (ucm.exe on Windows).
Here is a list of questions we've asked at StackOverflow while developing this little utility.
This project would not be possible without using free & open source.
- Developed in Go language
- https://github.com/jessevdk/go-flags - command line arguments parser
- https://github.com/go-git/go-git - for reading Git configuration files
This is free & open source utility licensed under Apache License version 2.0.