Files
mkdocs/docs/macos/python/pipx.md
2022-03-04 17:56:50 +01:00

222 lines
5.8 KiB
Markdown

# pipx
#### Installation:
```bash
$ brew install pipx
$ pipx ensurepath
```
#### Complétions:
Ajouter à `.zshrc`:
```bash
autoload -U bashcompinit && bashcompinit
eval "$(register-python-argcomplete pipx)"
```
#### Installer un paquet:
```bash
$ pipx install soco-cli
```
Le paquet est installé dans un environnement virtuel sous `~/.local/pipx/venvs`
```bash
~/.local/pipx/venvs/soco-cli/bin
$ ls -la
Permissions Size User Group Date Modified Date Created Name
.rw-r--r-- 1,9Ki bruno staff 17 aoû 10:47 17 aoû 10:47  activate
.rw-r--r-- 867 bruno staff 17 aoû 10:47 17 aoû 10:47  activate.csh
.rw-r--r-- 2,0Ki bruno staff 17 aoû 10:47 17 aoû 10:47  activate.fish
.rw-r--r-- 8,6Ki bruno staff 17 aoû 10:47 17 aoû 10:47  Activate.ps1
.rwxr-xr-x 278 bruno staff 17 aoû 10:47 17 aoû 10:47  normalizer*
lrwxr-xr-x 9 bruno staff 17 aoû 10:47 17 aoû 10:47  python@
lrwxr-xr-x 9 bruno staff 17 aoû 10:47 17 aoû 10:47  python3@
lrwxr-xr-x 42 bruno staff 17 aoû 10:47 17 aoû 10:47  python3.9@
.rwxr-xr-x 247 bruno staff 17 aoû 10:47 17 aoû 10:47  soco*
.rwxr-xr-x 256 bruno staff 17 aoû 10:47 17 aoû 10:47  soco-discover*
.rwxr-xr-x 250 bruno staff 17 aoû 10:47 17 aoû 10:47  soco-http-api-server*
.rwxr-xr-x 247 bruno staff 17 aoû 10:47 17 aoû 10:47  sonos*
.rwxr-xr-x 256 bruno staff 17 aoû 10:47 17 aoû 10:47  sonos-discover*
.rwxr-xr-x 250 bruno staff 17 aoû 10:47 17 aoû 10:47  sonos-http-api-server*
.rwxr-xr-x 243 bruno staff 17 aoû 10:47 17 aoû 10:47  tabulate*
.rwxr-xr-x 245 bruno staff 17 aoû 10:47 17 aoû 10:47  uvicorn*
```
Les applis sont linkées dans `$HOME/.local/bin`
```bash
$ which soco
/Users/bruno/.local/bin/soco
```
```bash
$ pipx install 'glances[action,browser,cloud,cpuinfo,docker,export,folders,gpu,graph,ip,raid,snmp,web,wifi]'
```
#### Exécuter un paquet sans l'installer:
```bash
$ pipx run pycowsay Meuuuhh !
⚠️ pycowsay is already on your PATH and installed at /Users/bruno/.local/bin/pycowsay. Downloading and running anyway.
---------
< Meuuuhh ! >
---------
\ ^__^
\ (oo)\_______
(__)\ )\/\
||----w |
|| ||
```
#### Liste des paquets installés:
```bash
$ pipx list
venvs are in /Users/bruno/.local/pipx/venvs
apps are exposed on your $PATH at /Users/bruno/.local/bin
package pycowsay 0.0.0.1, Python 3.9.6
- pycowsay
package soco-cli 0.4.15, Python 3.9.6
- soco
- soco-discover
- soco-http-api-server
- sonos
- sonos-discover
- sonos-http-api-server
```
Avec les paquets additionnels:
```bash
$ pipx list --include-injected
venvs are in /Users/bruno/.local/pipx/venvs
apps are exposed on your $PATH at /Users/bruno/.local/bin
package mkdocs 1.2.2, Python 3.9.6
- mkdocs
Injected Packages:
- fontawesome-markdown 0.2.6
- mkdocs-git-revision-date-localized-plugin 0.9.2
- mkdocs-material 7.2.4
- mkdocs-material-extensions 1.0.1
- mkdocs-minify-plugin 0.4.0
- mkdocs-pdf-export-plugin 0.5.8
package pycowsay 0.0.0.1, Python 3.9.6
- pycowsay
```
#### Installer un paquet dans un environnement virtuel:
```bash
$ pipx inject mkdocs mkdocs-material mkdocs-material-extensions mkdocs-minify-plugin mkdocs-git-revision-date-localized-plugin mkdocs-pdf-export-plugin fontawesome_markdown markdown pymdown-extensions
injected package mkdocs-material into venv mkdocs
done! ✨ 🌟 ✨
injected package mkdocs-material-extensions into venv mkdocs
done! ✨ 🌟 ✨
injected package mkdocs-minify-plugin into venv mkdocs
done! ✨ 🌟 ✨
injected package mkdocs-git-revision-date-localized-plugin into venv mkdocs
done! ✨ 🌟 ✨
injected package mkdocs-pdf-export-plugin into venv mkdocs
done! ✨ 🌟 ✨
injected package fontawesome-markdown into venv mkdocs
done! ✨ 🌟 ✨
injected package markdown into venv mkdocs
done! ✨ 🌟 ✨
injected package pymdown-extensions into venv mkdocs
done! ✨ 🌟 ✨
```
#### Mise-à-jour:
```bash
$ pipx upgrade soco-cli
soco-cli is already at latest version 0.4.15 (location: /Users/bruno/.local/pipx/venvs/soco-cli)
```
Mettre également à jour les paquets additionnels:
```bash
$ pipx upgrade mkdocs --include-injected
mkdocs is already at latest version 1.2.2 (location: /Users/bruno/.local/pipx/venvs/mkdocs)
fontawesome-markdown is already at latest version 0.2.6 (location: /Users/bruno/.local/pipx/venvs/mkdocs)
mkdocs-git-revision-date-localized-plugin is already at latest version 0.9.2 (location: /Users/bruno/.local/pipx/venvs/mkdocs)
mkdocs-material is already at latest version 7.2.4 (location: /Users/bruno/.local/pipx/venvs/mkdocs)
mkdocs-material-extensions is already at latest version 1.0.1 (location: /Users/bruno/.local/pipx/venvs/mkdocs)
mkdocs-minify-plugin is already at latest version 0.4.0 (location: /Users/bruno/.local/pipx/venvs/mkdocs)
mkdocs-pdf-export-plugin is already at latest version 0.5.8 (location: /Users/bruno/.local/pipx/venvs/mkdocs)
```
```bash
$ pipx upgrade-all
Versions did not change after running 'pip upgrade' for each package 😴
```
#### Désinstaller:
```bash
$ pipx uninstall glances
uninstalled glances! ✨ 🌟 ✨
```
#### Reinstaller:
En réinstallant un paquet, on met aussi à jour sa version de Python.
```bash
$ pipx list
package pycowsay 0.0.0.1, installed using Python 3.9.6
- pycowsay
```
```bash
$ pipx reinstall pycowsay
uninstalled pycowsay! ✨ 🌟 ✨
installed package pycowsay 0.0.0.1, installed using Python 3.10.2
These apps are now globally available
- pycowsay
done! ✨ 🌟 ✨
```
#### Aide:
```bash
$ pipx --help
$ pipx <commande> --help
```
The HTML specification is maintained by the W3C.
--8<-- "includes/abbreviations.md"