Metadata-Version: 2.3
Name: project-toolbox
Version: 0.4.1
Summary: A launcher for project-toolbox
Author: Farid Smaï
Author-email: Farid Smaï <f.smai@brgm.fr>
Requires-Dist: click>=8.3.1
Requires-Python: >=3.11
Project-URL: repository, https://gitlab.com/fsmai/project-toolbox
Description-Content-Type: text/markdown

# project-toolbox


## Features

- tools are [click](https://click.palletsprojects.com/) commands
- tool calls are automatically embeded (eg `uv run ...`)
- toolboxs are plugins
  - each project can select its own set of plugins
  - a toolbox/plugin can be public (pypi) or shipped with the project
- one command (`t`) gathering all tools
  - prevent cluttering command namespace
  - completion even for tools installed in dedicated environment


## Getting started

Install the launcher globally:
```shell
uv tool install project-toolbox
```

Enable completion (bash) by adding the following to the end of your `~/.bashrc`:
```shell
eval "$(_T_COMPLETE=bash_source t)"
```
Instructions for completion with other shells [can be found here](https://click.palletsprojects.com/en/stable/shell-completion/#enabling-completion).

Manage the toolbox
```shell
t self
```

Read carefully crafted manuals guiding you through the workflow
```shell
t manual
```

Use the toolbox
```shell
# show all commands
t
# use a tool
t <command> <arg1> <arg2> ...
```
