Download the PHP package stolt/git-user-bend without Composer
On this page you can find all versions of the php package stolt/git-user-bend. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package git-user-bend
git-user-bend
The git-user-bend CLI is a utility tool for managing the Git user configuration (i.e. name and email) of a given Git
repository. With it you can create a set of personas and easily bend them when doing company work, open source
development, or pair programming sessions.
With the in Git 2.13 introduced conditional configuration includes you can set a .gitconfig for a group of
repositories, which already might suit your needs.
Known relatives
This CLI is influenced by the Gas Ruby gem and might also contain elements of pair.
Installation
The git-user-bend CLI should be installed globally through Composer.
Make sure that the path to your global vendor binaries directory is in your $PATH. You can determine the location of
your global vendor binaries directory via composer global config bin-dir --absolute. This way the git-user-bend
executable can be located.
Since the default name of the CLI is quite a mouthful, an alias which can be placed in ~/.aliases, ~/.zshrc or the
like might come in handy. The alias shown next assumes that $COMPOSER_HOME is ~/.config/composer and not ~/.composer.
[!TIP] As of release
v1.2.1it's also possible to install and usegit-user-bendvia a PHAR file.
Usage
Run the git-user-bend whoami CLI within a Git repository (or an argumented one) and it will allow you to view the
currently used persona respectively the Git user configuration details.
The personas and their usage frequencies are stored in a JSON based global storage file called .gub.personas in
the $HOME directory of your system.
Via a .gub dotfile it's also possible to add the details of single persona directly into a project repository.
This is mostly oriented for repository maintainers working on multiple machines and with multiple personas. To keep
your email address private consider using your [email protected] email address, for details
see Setting your email in Git.
Available commands
To create a new persona the add command is available. It allows you to define an alias linked to persona details,
which are basically the username and email. Every added persona is stored in the global storage file.
To create a persona from a local .gub dotfile, local Git repository user details, or from global Git user details the
import command can be used. When a persona should be created from the Git user details its alias has to be provided.
To create a local .gub dotfile from an existing persona the export command is available.
To remove a defined persona from the global storage the retire command can be used.
To view all defined personas the personas command is at your service. Via the --edit|-e option the global storage
file called .gub.personas will be editable via the defined $EDITOR.
To bend the persona of a Git repository, the use command is there to change the Git user configuration to the aliased
user details. When using the --from-dotfile option the persona defined in a .gub dotfile is used. When an aliased
persona from the global storage should be used its alias has to be provided. When a pair should be used their aliases
have to be provided as a comma-separated list.
To reset the Git repository user to the values before, the reset command is available.
To start a pair programming session, which will be identifiable in the Git commits, the pair command merges the user
details of several personas into one pair. The email of the first persona alias in the comma-separated list will be
used for the Git user.email configuration. If the --branch|-b is provided, a new Git branch will be created to pair in.
To end a pair programming session and restore the default user.name and user.email the unpair command is available.
To check the persona, pair or respectively the Git user configuration of a repository the whoami command is a
pleasant shortcut.
Running tests
License
This library and its CLI are licensed under the MIT license. Please see LICENSE.md for more details.
Changelog
Please see CHANGELOG.md for more details.
Code of Conduct
Please see CONDUCT.md for more details.
Contributing
Please see CONTRIBUTING.md for more details.
