Skip to content

Commit cc8771a

Browse files
authored
update(pyqgis-venv): ajout paragraphe sur qgis-venv-creator (#1246)
En discutant avec @nicogodet...
2 parents 74c5ecf + 5abc04f commit cc8771a

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

content/articles/2024/2024-11-25_pyqgis_environnement_dev_windows.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: "Créer un environnement virtuel Python pour le développement de plugin
33
subtitle: Protégeons notre environnement, pour nos enfants PyQGIS
44
authors:
55
- Nicolas Godet
6+
- Julien MOURA
67
categories:
78
- article
89
comments: true
@@ -87,6 +88,39 @@ Je suppose dans la suite que vous avez installé QGIS dans le répertoire `C:\OS
8788
command = C:\OSGeo4W\apps\Python312\python.exe -m venv --system-site-packages <Le chemin complet vers votre venv>
8889
```
8990
91+
### Avec l'utilitaire _qgis-venv-creator_
92+
93+
> Paragraphe ajouté en janvier 2025
94+
95+
![logo Gispo](https://cdn.geotribu.fr/img/logos-icones/entreprises_association/Gispo.webp){: .img-thumbnail-left }
96+
97+
Juste après que cet article soit publié, on découvrait [le projet create-qgis-venv](https://github.com/GispoCoding/qgis-venv-creator) de GispoCoding.
98+
99+
Il se présente comme un outil en ligne de commande (CLI) multi-plateforme. Il est recommandé de l'installer avec [pipx](https://pipx.pypa.io/stable/#on-windows) qui gère la plupart des paramètres un peu sioux et qui est compatible avec Windows. C'est désormais l'outil recommandé dans la communauté Python pour gérer les outils en ligne de commande (CLI), c'est donc une bonne occasion de s'y mettre. Une fois pipx installé, paramétré (`ensurepath`...) et une nouvelle session PowerShell lancée, l'installation se passe comme un charme :
100+
101+
```powershell title="Installation de qgis-venv-creator avec pipx"
102+
pipx install qgis-venv-creator
103+
```
104+
105+
![Installation de qgis-venv-creator avec pipx](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/pyqgis_environnement_dev_windows/powershell_pipx_qgis-venv-creator.webp){: .img-center loading=lazy }
106+
107+
L'outil qgis-venv-creator est désormais accessible depuis n'importe quelle session PowerShell avec la commande suivante :
108+
109+
```powershell title="Commande de base de qgis-venv-creator"
110+
create-qgis-venv --venv-name ".venv"
111+
```
112+
113+
L'outil a besoin d'identifier l'installation de QGIS à utiliser pour la génération de l'environnement de développement et cherche dans les emplacements par défaut (`C:\OSGeo4W` et `C:\PROGRAMFILES\QGIS X.y.z`). Mais si vous êtes quelqu'un de bien, soigneux et utilisez QGIS dans un monde professionnel, vous l'installez probablement dans un emplacement correct au regard de ce que recommande le système d'exploitation, `%PROGRAMFILES%/QGIS/X_y` par exemple. Il est possible de passer un _pattern_ pour lui indiquer où chercher :
114+
115+
```powershell title="qgis-venv-creator avec un chemin d'installation de QGIS personnalisé"
116+
create-qgis-venv --qgis-installation-search-path-pattern "C:\Program Files\QGIS\*\apps\qgis*" --venv-name ".venv"
117+
```
118+
119+
<iframe title="qgis-venv-creator demonstration" width="100%" height="400" src="https://video.osgeo.org/videos/embed/9b5806ca-d489-443f-8edc-d6be9b9a83c6" frameborder="0" allowfullscreen="" sandbox="allow-same-origin allow-scripts allow-popups allow-forms"></iframe>
120+
121+
Il suffit d'activer son environnement virtuel `.venv/Scripts/activate` et de continuer ce tutoriel !
122+
Merci Gispo !
123+
90124
----
91125

92126
## Dans VS Code

0 commit comments

Comments
 (0)