Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kyan001/pyconfigmanager
https://github.com/kyan001/pyconfigmanager
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kyan001/pyconfigmanager
- Owner: kyan001
- License: bsd-3-clause
- Created: 2024-02-28T08:45:25.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-08-16T19:04:57.000Z (5 months ago)
- Last Synced: 2024-09-17T23:14:15.605Z (4 months ago)
- Language: Python
- Size: 24.4 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Config Manager (cmgr)
[CHANGELOG](CHANGELOG.md)
[cmgr](https://github.com/kyan001/PyConfigManager) is a command-line tool to manage configurations and packages. It's designed to be simple and easy to use. It's written in Python and can be installed via pip and pipx.
## Get Started
```sh
pip install cmgr # Install cmgr
cmgr # Run cmgr. Detect all `cmgr.toml` under current folder.
```
## Installation
```sh
# using pip
pip install --user cmgr # install cmgr
pip install --upgrade cmgr # upgrade cmgr
pip uninstall cmgr # uninstall cmgr
# using pipx
pipx install cmgr # install cmgr
pipx upgrade cmgr # upgrade cmgr
pipx uninstall cmgr # uninstall cmgr
```
## Usage
```sh
# Shell
cmgr --help # Command-line help message.
cmgr --version # Show version information.
cmgr # Run cgmr. Will looking for all cmgr.toml under current folder.
cmgr -p/--profile '/path/to/root/cmgr.toml' # Run cmgr with specific profile.
cmgr -r/--root '/path/to/root/' # Run cmgr with specific root folder.
cmgr -n/--name 'my-cmgr.toml' # Run cmgr with specific profile's filename.
# Install package
cmgr install ping3 # Install a package named ping3. Using default package manager.
cmgr install ping3 -c/--command 'ping3' # Use specific command to detect if the package is installed before install.
cmgr install ping3 -m/--manager 'pip' # Use specific package manager to install the package.
# Copy configuration
cmgr config "bash.conf" "~/.bashrc" # Copy `./bash.conf` to `~/.bashrc`.
cmgr config "bash.conf" "~/.bashrc" -n/--name "BASH" # Copy `bash.conf` to `~/` as `.bashrc` with specific name in output.
```
## Profile
* A cmgr profile example: [cmgr-example.toml](cmgr-example.toml)
* A minimal cmgr profile: [cmgr-minimal.toml](cmgr-minimal.toml)