https://github.com/redding/chpg
Switch between Installed Postgres.app versions
https://github.com/redding/chpg
Last synced: about 1 year ago
JSON representation
Switch between Installed Postgres.app versions
- Host: GitHub
- URL: https://github.com/redding/chpg
- Owner: redding
- License: mit
- Created: 2020-03-02T13:48:22.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-04-18T23:51:22.000Z (about 2 years ago)
- Last Synced: 2025-02-15T08:19:52.555Z (over 1 year ago)
- Language: Shell
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# chpg
Switch between installed [Postgres.app](https://postgresapp.com/) versions.
```
$ chpg @11 && pg_dump --version
$ echo '11' > ./.chpg-version && chpg @ && pg_dump --version
$ chpg @latest && pg_dump --version
$ chpg help
```
## Install
Open a terminal and run this command ([view source](http://git.io/chpg--install)):
(change PREFIX as needed; it defaults to `/usr/local`)
```
$ curl -L http://git.io/chpg--install | PREFIX=/usr/local sh
```
### Init
Add `chpg init` to your shell startup script. This installs tab completions and enables modifying the env vars.
```bash
eval "$(chpg init)"
```
### Auto Mode
(optional) If you want automatic handling, add the `--auto` flag to the init. In additon to the normal init above, `$PROMPT_COMMAND` is updated to activate any new Postgres.app version as you change directories. **Again, this is optional.**
```bash
eval "$(chpg init --auto)"
```
### Quiet Mode
By default, chpg outputs a warning saying which version/source it activates. If you want to silence these warnings, add the `--quiet` flag to the init.
```bash
eval "$(chpg init --quiet)"
```
## Usage
```
$ chpg help
```
### `.chpg-version` Files
If no explicit @ parameter is specified, chpg will look for the version in a file named `.chpg-version` in your current directory, its parent directories, or your home directory. The `.chpg-version` files are expected to contain nothing but the version requested.
```
$ echo "11" > $HOME/.chpg-version
$ cd $HOME && chpg @
$ pg_dump --version # will use /Applications/Postgres.app/Contents/Versions/11/bin/pg_dump
```
You can specify a specific version file using the `-f` option:
```
$ cd $HOME
$ echo "12" > /a/path/to/.chpg-version
$ chpg -f /a/path/to/.chpg-version
$ pg_dump --version # will use /Applications/Postgres.app/Contents/Versions/12/bin/pg_dump
```
**Note**: You can specify a "default" version file at `$HOME/.chpg/.chpg-version`. This version will be used when no other .chpg-version can be found and no command line version has been specified.
**Note**: If an `@` parameter is given, it will always override any versions specified in any `.chpg-version` files.
## Uninstall
Open a terminal and run this command ([view source](http://git.io/chpg--uninstall)):
```
$ curl -L http://git.io/chpg--uninstall | sh
```
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request