Divers/mkdocs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update pip3

Browse Source
This commit is contained in:
Bruno 21
2020-03-13 10:30:44 +01:00
parent a0f1ee3159
commit fe309fab69
2 changed files with 207 additions and 108 deletions
Download Patch File Download Diff File Expand all files Collapse all files

293
docs/macos/python/pip.md
View File

@@ -1,14 +1,22 @@
# Installer pip (python 2):
# pip
## Installation:
### Installer pip (python 2):
[:fa-link: https://apple.stackexchange.com/questions/209572/how-to-use-pip-after-the-os-x-el-capitan-upgrade](https://apple.stackexchange.com/questions/209572/how-to-use-pip-after-the-os-x-el-capitan-upgrade)
### Documentation pip:
##### Documentation pip:
[:fa-link: https://pip.pypa.io/en/stable/](https://pip.pypa.io/en/stable/)
### Installer pip:
### Installer pip3 (python 3):
#### Installer pip:
```bash
$ sudo easy_install pip
@@ -16,25 +24,21 @@ $ sudo easy_install pip
Pour [Python 3](python3.md), **pip** est installé d'origine.
### Version courrante de pip:
#### Version courrante de pip:
```bash
$ pip --version
pip 9.0.1 from /Library/Python/2.7/site-packages/pip-9.0.1-py2.7.egg (python 2.7)
$ pip3 --version
pip 20.0.2 from /usr/local/lib/python3.7/site-packages/pip (python 3.7)
```
### Mettre à jour pip:
#### Mettre à jour pip:
```bash
$ sudo pip install --upgrade pip
```
```bash
$ pip install --user --upgrade pip
$ pip3 install --user --upgrade pip
```
!!! attention
@@ -42,7 +46,7 @@ $ pip install --user --upgrade pip
### Cache:
#### Cache:
Linux and Unix
@@ -62,37 +66,135 @@ Windows
%LocalAppData%\pip\Cache
```
pip peut installer en ignorant le cache:
```bash
pip --no-cache-dir install mkdocs
$ pip3 --no-cache-dir install mkdocs
```
### Installer des modules:
## Environnement virtuel:
#### Installer un module pour l'utilisateur courant (mkdocs):
```bash
$ pip install --user mkdocs
# Création de l'environnement virtuel
$ python3 -m venv mkdocs_env
# Mise-à-jour
$ mkdocs_env/bin/pip3 install -U pip setuptools
# Installation de mkdocs
$ mkdocs_env/bin/pip3 install mkdocs
# Installation du thème
$ mkdocs_env/bin/pip3 install mkdocs-material pymdown-extensions pygments
# Installation des plugins
$ mkdocs_env/bin/pip3 install mkdocs-pdf-export-plugin mkdocs-minify-plugin
# Installation du plugin depuis les sources
$ mkdocs_env/bin/pip3 install mkdocs-pdf-export-plugin-0.5.5.tar.gz
# Mise-à-jour
$ mkdocs_env/bin/pip3 install -U mkdocs
# Mise-à-jour de l'environnement virtuel
$ python3 -m venv --upgrade mkdocs_env
```
```bash
~/Documents/mydocs master*
# Création d'un nouveau projet
$ ~/Documents/mkdocs_env/bin/mkdocs new
# Démarrage de mkdocs
$ ~/Documents/mkdocs_env/bin/mkdocs serve
INFO - Building documentation...
INFO - Cleaning site directory
```
L'activation n'est pas obligatoire, elle simplifie juste les chemins.
```bash
~/Documents/mydocs master*
$ source ~/Documents/mkdocs_env/bin/activate
~/Documents/mydocs master*
mkdocs_env ❯ mkdocs serve
~/Documents/mydocs master*
mkdocs_env ❯ deactivate
```
## Modules:
#### Installer des modules (depuis [PyPi](https://pypi.org)):
##### Installer un module:
```bash
$ pip3 install django
```
Les modules sont ici:
`/Users/bruno/Library/Python/2.7/bin`
`/usr/local/lib/python3.7/site-packages`
`/usr/local/lib/python3.8/site-packages`
#### Désinstaller un module:
##### Installer un module pour l'utilisateur courant (mkdocs):
```bash
$ pip uninstall <module>
$ pip3 install --user mkdocs
```
Les modules sont ici:
`/Users/bruno/Library/Python/3.7/lib/python/site-packages`
#### Installer des modules (depuis une archive):
```bash
$ pip3 install mkdocs-pdf-export-plugin-0.5.5.tar.gz
```
#### Installer des modules (depuis les sources):
```bash
~/Downloads/
$ cd mkdocs-pdf-export-plugin-0.5.5
~/Downloads/mkdocs-pdf-export-plugin-0.5.5
$ pip3 install .
```
#### Installer des modules (depuis un [VCS](https://pip.pypa.io/en/latest/reference/pip_install/#vcs-support)):
```bash
$ pip3 install -e git+https://github.com/zhaoterryy/mkdocs-pdf-export-plugin.git#egg=mkdocs-pdf-export-plugin
# avec un commit
$ pip3 install -e git+https://github.com/zhaoterryy/mkdocs-pdf-export-plugin.git@7c6c82c96490a84b4bd617e21977259f60dd5007#egg=mkdocs-pdf-export-plugin
# avec un tag
$ pip3 install -e git+https://github.com/zhaoterryy/mkdocs-pdf-export-plugin.git@v0.5.3#egg=mkdocs-pdf-export-plugin
$ pip3 install -e "git+ssh://git.example.com/MyProject#egg=MyProject"
```
#### Requirements files:
[*requirements.txt*](https://pip.pypa.io/en/stable/reference/pip_install/#requirements-file-format) est une liste de modules à installer.
```bash
$ pip3 install -r requirements.txt
$ pip3 freeze > requirements.txt
$ pip3 install -r requirements.txt
```
#### Installer une version précise d'un module:
@@ -119,12 +221,20 @@ $ pip3 install 'tornado~=4.5.2'
#### Désinstaller un module:
```bash
$ pip3 uninstall <module>
```
#### Informations sur un module:
```bash
$ pip show <module>
$ pip3 show <module>
$ pip show mkdocs
$ pip3 show mkdocs
Name: mkdocs
Version: 0.17.2
Summary: Project documentation with Markdown.
@@ -141,7 +251,7 @@ Requires: tornado, PyYAML, click, Markdown, Jinja2, livereload
#### Installer une liste de modules requis:
```bash
$ pip install -r requirements.txt
$ pip3 install -r requirements.txt
```
@@ -151,7 +261,7 @@ $ pip install -r requirements.txt
```bash
# --format=columns (par defaut)
$ pip list --format=columns
$ pip3 list
Package Version
@@ -180,23 +290,21 @@ Django==2.1.7
$ pip3 freeze > export_liste_pip.txt
# puis l'importer sur une autre machine
$ pip install -r export_liste_pip.txt
$ pip3 install -r export_liste_pip.txt
# Ou créer un bundle
$ pip bundle <nom_du_bundle>.pybundle -r export_liste_pip.txt
$ pip3 bundle <nom_du_bundle>.pybundle -r export_liste_pip.txt
# et importer les lib
$ pip install <nom_du_bundle>.pybundle
$ pip3 install <nom_du_bundle>.pybundle
```
### Mise-à-jour:
#### Liste des modules mis-à-jour:
```bash
$ pip list --outdated --format=columns
$ pip3 list --outdated
Package Version Latest Type
@@ -243,101 +351,82 @@ $ pip3 list --outdated --format=json
#### Mettre à jour un module:
```bash
$ pip install --user --upgrade <module>
$ pip3 install --upgrade <module>
$ pip install --user --upgrade mkdocs-material
$ pip3 install -U django
```
### Chercher un module:
```bash
$ pip search <module>
$ pip3 install --user --upgrade <module>
$ pip search markdown
aberdeen (0.4.0) - Conversion from markdown files to database entries to use as the backend of a blog
python-academicmarkdown (0.9.0) - A markdown preparser for academic writing
odoo8-addon-web-widget-text-markdown (8.0.1.0.0.99.dev7) - web_widget_text_markdown
lektor-markdown-admonition (0.1) - Adds basic admonition tag support to Markdown.
$ pip3 install --user -U mkdocs-material
```
### Montrer les dépendances d'un module:
#### Chercher un module:
```bash
$ pip3 search <module>
$ pip3 search mkdocs-pdf-export-plugin
mkdocs-pdf-export-plugin (0.5.5) - An MkDocs plugin to export content pages as PDF files
INSTALLED: 0.5.5 (latest)
mkdocs-mk2pdf-plugin (0.1.5) - An MkDocs plugin to export content pages as PDF files
INSTALLED: 0.1.5 (latest)
mkdocs-autolinks-plugin (0.2.0) - An MkDocs plugin
mkdocs-with-pdf (0.1.0) - Generate a single PDF file from MkDocs repository
mkdocs-toc-sidebar-plugin (0.1.0) - An MkDocs plugin
mkdocs-tooltipster-links-plugin (0.1.0) - An MkDocs plugin
```
## Dépendances:
#### Montrer les dépendances d'un module:
```bash
$ pip3 show mkdocs | grep Requires
Requires: tornado, Markdown, click, PyYAML, Jinja2, livereload
Requires: click, Markdown, PyYAML, Jinja2, tornado, lunr, livereload
```
### Modules:
#### Yolk:
```bash
$ pip3 install yolk3k
```
Montrer les dépendances:
```bash
$ yolk -d mkdocs
mkdocs 0.17.3
PyYAML>=3.10
tornado<5.0,>=4.1
Jinja2>=2.7.1
click>=3.3
Markdown>=2.3.1
livereload>=2.5.1
```
Montrer les M-à-J disponibles:
```bash
$ yolk -U
tornado 4.5.3 (5.0)
```
Listes des modules installés:
```bash
$ yolk -l
Babel - 2.5.3 - active development (/usr/local/lib/python3.6/site packages)
Django - 2.0.3 - active development (/usr/local/lib/python3.6/site-packages)
```
#### pipdeptree:
Savoir quel module requiert tel module:
Savoir quel module requiert tel module (dépendances inverses):
```bash
$ pipdeptree -r -p mkdocs
mkdocs==0.17.3
- mkdocs-material==2.7.0 [requires: mkdocs>=0.17.1]
mkdocs==1.1
- mkdocs-material==4.6.3 [requires: mkdocs>=1.0]
- mkdocs-minify-plugin==0.2.3 [requires: mkdocs>=1.0.4]
- mkdocs-mk2pdf-plugin==0.1.5 [requires: mkdocs>=0.17]
- mkdocs-pdf-export-plugin==0.5.5 [requires: mkdocs>=0.17]
- mkdocs-windmill==1.0.4 [requires: mkdocs]
- mkpdfs-mkdocs==1.0.1 [requires: mkdocs>=0.17]
```
Montrer les dépendances:
```bash
$ pipdeptree -p mkdocs
mkdocs==0.17.3
- click [required: >=3.3, installed: 6.7]
- Jinja2 [required: >=2.7.1, installed: 2.10]
- MarkupSafe [required: >=0.23, installed: 1.0]
- livereload [required: >=2.5.1, installed: 2.5.1]
- six [required: Any, installed: 1.11.0]
- tornado [required: Any, installed: 4.5.3]
- Markdown [required: >=2.3.1, installed: 2.6.11]
- PyYAML [required: >=3.10, installed: 3.12]
- tornado [required: <5.0,>=4.1, installed: 4.5.3]
mkdocs==1.1
- click [required: >=3.3, installed: 7.1]
- Jinja2 [required: >=2.10.1, installed: 2.11.1]
- MarkupSafe [required: >=0.23, installed: 1.1.1]
- livereload [required: >=2.5.1, installed: 2.6.1]
- six [required: Any, installed: 1.14.0]
- tornado [required: Any, installed: 6.0.4]
- lunr [required: ==0.5.6, installed: 0.5.6]
- future [required: >=0.16.0, installed: 0.18.2]
- six [required: >=1.11.0, installed: 1.14.0]
- Markdown [required: >=3.2.1, installed: 3.2.1]
- setuptools [required: >=36, installed: 46.0.0]
- PyYAML [required: >=3.10, installed: 5.3]
- tornado [required: >=5.0, installed: 6.0.4]
```