pato-gui 3.0.0

Paulissoft Application Tools for Oracle (PATO) GUI.

pato-gui

Table of contents

1. Introduction
2. Installation
   1. Start a command prompt
   2. Installing the binary Python package
   3. Installing from source
3. Usage
   1. Launch the GUI
   2. Help

Introduction

A Python GUI for PATO as an alternative for the Maven command line.

First you probably need to clone PATO so you use its Maven POM files or other Maven POM files having them as parent.

This GUI would not have been possible without Gooey.

Installation

This utility needs Python 3. You can install it using the Microsoft Store (accessible via the Windows start button) or just Google download Python 3.

A Python alternative that is more cross-platform is Miniconda, that allows you to switch between several Python environments.

Start a command prompt

Needed for installating and running the PATO GUI. Please Google it if you don't know how.

First please note that the dollar sign you will see below is the command line prompt sign and not a character you have to type. The command line prompt will differ between Operating Systems.

Installing the binary Python package

$ python3 -m pip install pato-gui

Now pato-gui should be available and this command shows you the help:

$ pato-gui -h

Output:

usage: pato-gui [-h] [-d] [--db-config-dir DB_CONFIG_DIR] [file]

Setup logging

positional arguments:
  file                  The POM file

options:
  -h, --help            show this help message and exit
  -d                    Enable debugging
  --db-config-dir DB_CONFIG_DIR
                        The database configuration directory

Installing from source

Only for die-hards having GNU make (usually available on Unix). Clone the Git repo pato-gui first.

Go to the root folder and issue:

$ make install

For help:

$ make help

Usage

Launch the GUI

$ pato-gui

A graphical interface will pop up.

If you know the Maven POM file already:

$ pato-gui <POM file>

Help

From the command line:

$ pato-gui -h

And in the left top corner of the GUI screen there is a Help button.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• Added for new features.
• Changed for changes in existing functionality.
• Deprecated for soon-to-be removed features.
• Removed for now removed features.
• Fixed for any bug fixes.
• Security in case of vulnerabilities.

[Unreleased]

[3.0.0] - 2023-10-14

Added

• Python executables must be determined at run-time.

Fixed

• Pato gui script does not run due to missing pythonw executable.

[2.1.0] - 2023-09-06

Added

• APEX seed and publish.

Fixed

• The GUI does not start with a message that the property db.config.dir must have been set.

[2.0.0] - 2022-11-23

Added

• Remove all references to Oracle Tools in documentation.

[1.2.0] - 2022-10-13

Added

• It must be possible to use the Maven daemon.

[1.1.1] - 2022-07-22

Fixed

• When you supply the database configuration directory as a relative path, the execution fails.

[1.1.0] - 2021-09-10

Added

• Added actions db-info and db-code (added in oracle-tools 1.2.0).

[1.0.0] - 2021-06-04

Added

• Display information about the Java run-time and compiler.
• Applied Python best practices.