semvec/pypi-packages huggingface dataset:
lbranch 0.1.4
A Git utility that shows recently checked-out branches in chronological order and lets you quickly switch between them.
Requires Python: >=3.7
Keywords: branch, cli, developer-tools, git, git-tools, version-control

# lbranch
lbranch ("last branch") is a git utility that shows your recently checked out branches in chronological order, with an optional interactive checkout.

## Usage
```bash
# Show last 5 branches (default)
lbranch
# Show last N branches
lbranch -n 3
lbranch --number 3
# Show branches and select one to checkout
lbranch -s
lbranch --select
# Show last N branches and select one
lbranch -n 3 -s
# Color control
lbranch --no-color     # Disable colored output
lbranch --force-color  # Force colored output even in non-TTY environments
```

## Example Output
```bash
Last 5 branches:
1) feature/new-ui
2) main
3) bugfix/login
4) feature/api
5) develop
```

## Color Support
lbranch automatically detects if your terminal supports colors:
- Colors are disabled when output is not to a terminal (when piped to a file or another command)
- Colors are disabled on Windows unless running in a modern terminal (Windows Terminal, VS Code, etc.)
- You can force colors on with `--force-color` or off with `--no-color`
- lbranch respects the `NO_COLOR` and `FORCE_COLOR` environment variables

## Exit Codes
lbranch follows the standard exit codes from sysexits.h for better integration with scripts and other tools:

- 0: Success
- 64: Command line usage error (not in a git repository, invalid selection)
- 66: Cannot open input (no branch history/no commits)
- 69: Service unavailable (git command not found)
- 75: Temporary failure (branch checkout failed, retry possible)
- 130: Operation interrupted (Ctrl+C)

These follow Unix conventions where exit codes 64-78 are standardized error codes, and 128+N indicates termination by signal N.

## Requirements
- Python 3.7+
- Git

## Installation

### Using pip

You can install lbranch directly from [PyPI](https://pypi.org/project/lbranch/):

```bash
pip install lbranch
```

### Using Homebrew

You can install lbranch using [Homebrew](https://brew.sh/):

```bash
brew tap dcchuck/lbranch
brew install lbranch
```

## License
Distributed under the MIT License. See `LICENSE`