pyILPER command line parameters

Introduction

pyILPER supports command line parameters to carry out special actions (not for Windows).

Note: You must start pyILPER from the command line now as a module to specify command line parameters.

Use the -help parameter to see the available arguments:

python -m pyilper --help
Usage: python -m pyilper [options]

Start pyILPER with command line parameters

options:
  -h, --help             Show this help message and exit
  -v, --v                Show program version and exit
  --instance INSTANCE, 
   -instance INSTANCE    Start a pyILPER instance INSTANCE. This instance has an
                         own configuration file.
  --clean, -clean        Start pyILPER with a config file that is reset to defaults.
  --cc, -cc              Copy configuration from development to production version
                         and vice versa.
  --scale FACTOR
  -scale FACTOR          Force scaling of the pyILPER GUI for use on high-DPI displays
                         The FACTOR can take values between 1.0 and 4.0.
  -use-system-browser    Use the system default browser for the help system.
  --use-system-browser 

Starting another instance of pyILPER

The parameter -instance INSTANCE-NAME allows to start multiple independent instances of pyILPER. Each instance has its own configuration file and is identified by INSTANCE-NAME. Only letters or digits are allowed in an INSTANCE-NAME.

Reset the pyILPER configuration to default

If a pyILPER configuration has been corrupted, which can result in a crashing or misbehaving program, then the configuration can be reset to default with the -clean parameter.

Copy configuration data between beta/development and production versions

The beta and production versions of pyILPER use different configuration files. In this way a beta or production version can be tested without affecting the configuration of an installed production version. But sometimes it is required to copy the configuration data between production and beta or development versions. With the -cc option:

• The production version pulls the configuration data of a development or beta version
• A beta or development version pulls the configuration data of the production version

Note: You have to confirm the copy action. After completion, you must restart pyILPER without the -cc option.

Use the system default browser for the help system

The parameter --use-system-browser disables the loading of the PyQt5 or PySide6 web extension, which could cause compatibility problems. The system default browser is used instead for the help system.