diff --git a/docs/macos/python/pip.md b/docs/macos/python/pip.md index a94ec6c..c220a2f 100644 --- a/docs/macos/python/pip.md +++ b/docs/macos/python/pip.md @@ -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 +$ 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 +``` + + + #### Informations sur un module: ```bash -$ pip show +$ pip3 show -$ 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 .pybundle -r export_liste_pip.txt +$ pip3 bundle .pybundle -r export_liste_pip.txt # et importer les lib -$ pip install .pybundle +$ pip3 install .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 +$ pip3 install --upgrade -$ pip install --user --upgrade mkdocs-material +$ pip3 install -U django ``` - - -### Chercher un module: - ```bash -$ pip search +$ pip3 install --user --upgrade -$ 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 + +$ 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] ``` diff --git a/docs/macos/python/python3.md b/docs/macos/python/python3.md index a00180c..c99091f 100644 --- a/docs/macos/python/python3.md +++ b/docs/macos/python/python3.md @@ -126,6 +126,22 @@ tornado==6.0.3 +#### Rechercher un module + +[PyPI - the Python Package Index](https://pypi.python.org/pypi) + +```bash +$ 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 Il faut installer Mkdocs avec pip dans --user @@ -163,12 +179,6 @@ $ pip install --user mkdocs-material -#### Rechercher un module - -[PyPI - the Python Package Index](https://pypi.python.org/pypi) - - - #### Problème à l'installation Erreur lors de l’install de python3 avec Homebrew: