https://github.com/justincampbell/use

Manage multiple profile configurations sanely
https://github.com/justincampbell/use

shell

Last synced: over 1 year ago
JSON representation

Manage multiple profile configurations sanely

• Host: GitHub
• URL: https://github.com/justincampbell/use
• Owner: justincampbell
• License: mit
• Created: 2014-03-21T23:13:04.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2015-03-31T20:11:25.000Z (about 11 years ago)
• Last Synced: 2024-04-16T00:03:46.572Z (about 2 years ago)
• Topics: shell
• Language: Shell
• Homepage:
• Size: 359 KB
• Stars: 7
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# use [![Build Status](https://travis-ci.org/justincampbell/use.svg?branch=master)](https://travis-ci.org/justincampbell/use)

`use` is a utility for managing project- or client-specific profile configurations. For example, maybe you have some AWS credentials for yourself, and some for work, and maybe some more for that friend you helped with that one startup thing. `use` lets you manage these environment-level credentials and configurations sanely.

# Installation

## [Homebrew](http://brew.sh)

    brew tap justincampbell/formulae

    brew install use

## Package

    wget -O use-latest.tar.gz https://github.com/justincampbell/use/archive/latest.tar.gz use

    tar -zxvf use-latest.tar.gz

    cd use-latest/

    make install

# Setup

Add the following to your `~/.profile`:

    source /usr/local/share/use/use.sh

Create a folder in `~/.use`, and then add folders inside for each client:

    ~

      .use/

        me/

        my_company/

Then in each folder, create a `.profile` file to be sourced when you `use` that profile.

    # ~/.use/me/.profile

    export FOG_DIRECTORY=myname

# Usage

    use name # name is the directory ~/.use/name

You can also `use` nothing, which essentially resets your current session:

    use # Same as above, but skip loading a named config.

When you `use foo`, the `$USE` environment variable will be exported with "foo", so it can be used in a `PS1` or `PROMPT_COMMAND`:

    use_prefix() {

      if [[ $USE != "" ]]; then

        echo -n "($USE) "

      fi

    }

    export PS1='$(use_prefix)\W$ '

# Examples

## AWS Configuration

```sh

# ~/.use/my_company/.profile

export AWS_ACCESS_KEY_ID=abc123

export AWS_SECRET_ACCESS_KEY=abc123

```