aboutsummaryrefslogtreecommitdiffstats
path: root/docs/tools.md
blob: 10e18a05eefe22a176f5b7e44cf3ee93f5916f52 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# Documentation regarding included tools / utilities

This project includes a few Python scripts, included as utilities for convenience. All of these are
relatively small and self-contained. They should also all include usage instructions in comments at
the beginning of the scripts. Some of them are scattered around the project. These include:

 * [The example packaging script](../examples/package.py)
   - This script creates .zip files for use with the included extension manager form the example
     extension sources.
   - **Available options are:**
     - *run with no arguments in `examples` directory to create extension .zip files*
     - clean *remove generated .zip files*
   - **Note:** There is a symbolic link to this script in the `tests` directory

The other scripts are in the [tools folder](../tools/), they are:

 * [The license script](../tools/license.py)
   - This script adds the Qt license to all relevant source files.
   - Takes no options and should be run in root directory with `$ python ./tools/license.py`.

 * [PySide build helper script](../tools/pyside2_config.py)
   - This is taken verbatim from the pyside-setup project and is used to discover the pyside
     installation / setup during builds. Should not be used manually.

 * [Sanity helper script](../tools/sanity.py)
   - This script automatically corrects some annoying nags for the Qt Gerrit sanity check.
   - Takes no options and should be run in root directory with `$ python ./tools/sanity.py`.