Metadata-Version: 2.1
Name: pato-gui
Version: 3.1.0
Summary: Paulissoft Application Tools for Oracle (PATO) GUI.
Home-page: https://github.com/paulissoft/pato-gui
Author: Gert-Jan Paulissen
Author-email: paulissoft@gmail.com
License: MIT License
Description: # pato-gui
        
        ## Table of contents
        
        1. [Introduction](#introduction)
        2. [Installation](#installation)
           1. [Start a command prompt](#start-command-line-prompt)
           2. [Installing the binary Python package](#installing-from-binary-package)
           3. [Installing from source](#installing-from-source)
        3. [Usage](#usage)
           1. [Launch the GUI](#launch-the-gui)
           2. [Help](#help)
        
        ## Introduction <a name="introduction" />
        
        A Python GUI for [PATO](https://github.com/paulissoft/oracle-tools) 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](https://github.com/chriskiehl/Gooey).
        
        ## Installation <a name="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](https://docs.conda.io/projects/miniconda/en/latest/miniconda-install.html),
        that allows you to switch between several Python environments.
        
        ### Start a command prompt <a name="start-command-line-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 <a name="installing-from-binary-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 <a name="installing-from-source" />
        
        Only for die-hards having GNU `make` (usually available on Unix). Clone the Git repo [pato-gui](https://github.com/paulissoft/pato-gui) first.
        
        Go to the root folder and issue:
        
        ```
        $ make install
        ```
        
        For help:
        
        ```
        $ make help
        ```
        
        ## Usage <a name="usage" />
        
        ### Launch the GUI <a name="launch-the-gui" />
        
        ```
        $ pato-gui
        ```
        
        A graphical interface will pop up.
        
        If you know the Maven POM file already:
        
        ```
        $ pato-gui <POM file>
        ```
        
        ### Help <a name="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](https://keepachangelog.com/en/1.0.0/),
        and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
        
        - **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.1.0] - 2023-10-16
        
        ### Fixed
        
        - [pip complains about SSL not enabled for Miniconda Python.](https://github.com/paulissoft/pato-gui/issues/14)
        - [Development build does not work on Windows.](https://github.com/paulissoft/pato-gui/issues/15)
        
        ### Deprecated
        
        - [Pato GUI must run on Python 3.6 or higher.](https://github.com/paulissoft/pato-gui/issues/13)
        
        ## [3.0.1] - 2023-10-15
        
        ### Fixed
        
        - [Pato GUI must run on Python 3.6 or higher.](https://github.com/paulissoft/pato-gui/issues/13)
        
        ## [3.0.0] - 2023-10-14
        
        ### Added
        
        - [Python executables must be determined at run-time.](https://github.com/paulissoft/pato-gui/issues/11)
        
        ### Fixed
        
        - [Pato gui script does not run due to missing pythonw executable.](https://github.com/paulissoft/pato-gui/issues/10)
        
        ## [2.1.0] - 2023-09-06
        
        ### Added
        
        - [APEX seed and publish.](https://github.com/paulissoft/oracle-tools/issues/107)
        
        ### Fixed
        
        - [The GUI does not start with a message that the property db.config.dir must have been set.](https://github.com/paulissoft/pato-gui/issues/8)
        
        ## [2.0.0] - 2022-11-23
        
        ### Added
        
        - [Remove all references to Oracle Tools in documentation.](https://github.com/paulissoft/pato-gui/issues/7)
        
        ## [1.2.0] - 2022-10-13
        
        ### Added
        
        - [It must be possible to use the Maven daemon.](https://github.com/paulissoft/pato-gui/issues/6)
        
        ## [1.1.1] - 2022-07-22
        
        ### Fixed
        
        - [When you supply the database configuration directory as a relative path, the execution fails.](https://github.com/paulissoft/pato-gui/issues/5)
        
        ## [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.](https://github.com/paulissoft/pato-gui/issues/3)
        - Applied Python best practices.
        
Keywords: Oracle,PATO,GUI
Platform: UNKNOWN
Classifier: Development Status :: 6 - Mature
Classifier: Programming Language :: Python :: 3
Classifier: Natural Language :: English
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Description-Content-Type: text/markdown
Provides-Extra: test
