gn_tools - QGIS Plugin

Generated options

Plugin

Here is a list of the options you picked when creating the plugin with the cookiecutter template.

Cookiecutter option	Picked value
Plugin name	gn_tools
Plugin name slugified	gn_tools
Plugin name class (used in code)	GnTools
Plugin category	None
Plugin description short	Bienvenue dans le GéoNature du Conservatoire des Espaces Naturels de l'Isère
Plugin description long	Extension QGIS permettant de récupérer des données issue de Géonature
Plugin tags	GéoNature, api, tools
Plugin icon	default_icon.png
Plugin with processing provider	True
Author name	Colas GEIER
Author organization	Conservatoire d'espaces naturels Isère
Author email	geomatique@cen-isere.org
Minimum QGIS version	3.30
Maximum QGIS version	3.99
Support Qt6	True
Git repository URL	https://gitea.cenra-outils.org/CEN38/gn_tools
Git default branch	main
License	GPLv3
Python linter	None
CI/CD platform	None
Publish to https://plugins.qgis.org using CI/CD	False
IDE	VSCode

Tooling

This project is configured with the following tools:

• Black to format the code without any existential question
• iSort to sort the Python imports

Code rules are enforced with pre-commit hooks.

See also: contribution guidelines.

Documentation

The documentation is located in docs subfolder, written in Markdown using myst-parser, structured in two main parts, Usage and Contribution, generated using Sphinx (have a look to the configuration file) and is automatically generated through the CI and published on Pages: https://gitea.cenra-outils.org/CEN38/gn_tools/pages (see post generation steps below).

---

Next steps post generation

1. Set up development environment

Typical commands on Linux (Ubuntu).

1. If you didn't pick the git init option, initialize your local repository:

   git init
   

2. Follow the embedded documentation to set up your development environment to create virtual environment and install development dependencies.

3. Add all files to git index to prepare initial commit:

   git add -A
   

4. Run the git hooks to ensure that everything runs OK and to start developing on quality standards:

   # run all pre-commit hooks on all files
   pre-commit run -a
   # don't be shy, run it again until it's all green
   

2. Adjust URL and build the documentation locally

Note

Since it's very hard to determine which the final documentation URL will be, the templater does not set it up. You have to do it manually.

1. Have a look to the plugin's metadata.txt file: review it, complete it or fix it if needed (URLs, etc.)., especially the homepage URL which should be to your GitLab or GitHub Pages.
2. Update the base URL of custom repository in installation doc page.
3. Change the plugin's icon stored in gn_tools/resources/images
4. Follow the embedded documentation to build plugin documentation locally

3. Prepare your remote repository

1. If you did not yet, create a remote repository on your Git hosting platform (GitHub, GitLab, etc.)

2. Add the remote repository to your local repository:

   git remote add origin https://gitea.cenra-outils.org/CEN38/gn_tools
   

3. Commit changes:

   git commit -m "init(plugin): adding first files of gn_tools" -m "generated with QGIS Plugin Templater (https://oslandia.gitlab.io/qgis/template-qgis-plugin)"
   

4. Push the initial commit to the remote repository:

   git push -u origin main
   

5. Create a new release following the packaging/release guide with the tag 0.1.0-beta1 to trigger the CI/CD pipeline and publish the plugin on the official QGIS plugins repository (if you picked up the option).

---

License

Distributed under the terms of the GPLv3 license.