python-template-project 0.1.0__py3-none-any.whl → 0.1.15__py3-none-any.whl

main.py

@@ -0,0 +1,153 @@
+#!/usr/bin/env python3
+"""
+Unified entry point for CLI and GUI application.
+Automatically detects whether to run CLI or GUI based on how the application is started.
+"""
+
+import os
+import sys
+
+
+def is_console_attached():
+    """
+    Check if the application is running in a console environment.
+    Returns True if launched from console, False if launched via double-click.
+    """
+    try:
+        # On Windows, check if we have a console attached
+        if os.name == "nt":
+            import ctypes
+
+            kernel32 = ctypes.windll.kernel32
+            # GetConsoleWindow returns 0 if no console is attached
+            console_window = kernel32.GetConsoleWindow()
+            if console_window == 0:
+                return False
+
+            # Check if the console was created by this process
+            # (indicates double-click launch with console auto-created)
+            process_list = kernel32.GetConsoleProcessList(None, 0)
+            if process_list <= 1:
+                return False
+
+            return True
+        else:
+            # On Unix-like systems (macOS, Linux), check multiple indicators
+            # Check if stdout is a terminal
+            if not sys.stdout.isatty():
+                return False
+
+            # Additional check for macOS: Check if we're running in a .app bundle
+            if sys.platform == "darwin":
+                # If we're in a .app bundle, we're likely launched via double-click
+                executable_path = sys.executable
+                if ".app/" in executable_path:
+                    # We're in an app bundle, check if we have a real terminal
+                    # by checking if TERM environment variable is set
+                    return os.environ.get("TERM") is not None
+
+            return True
+    except Exception as ex:
+        # Fallback: assume GUI if we can't determine
+        print(ex)
+        return False
+
+
+def has_command_line_args():
+    """Check if command line arguments (beyond script name) are provided."""
+    return len(sys.argv) > 1
+
+
+def main():
+    """Main entry point that decides between CLI and GUI."""
+
+    # Force CLI mode if command line arguments are provided
+    if has_command_line_args():
+        run_cli()
+        return
+
+    # Check if we're in a console environment
+    if is_console_attached():
+        # We're in a console - offer choice or default to CLI
+        print("Python Template Project")
+        print("=" * 50)
+        print("Detected console environment.")
+        print("Options:")
+        print("  1. Run CLI interface (default)")
+        print("  2. Run GUI interface")
+        print("  3. Show help")
+        print()
+
+        try:
+            choice = input("Select option [1]: ").strip()
+            if choice == "2":
+                run_gui()
+            elif choice == "3":
+                show_help()
+            else:
+                run_cli()
+        except (KeyboardInterrupt, EOFError):
+            print("\nExiting...")
+            sys.exit(0)
+    else:
+        # Launched via double-click - start GUI
+        run_gui()
+
+
+def run_cli():
+    """Launch the CLI interface."""
+    try:
+        from python_template_project.cli.cli import main as cli_main
+
+        cli_main()
+    except ImportError as e:
+        print(f"Error importing CLI module: {e}")
+        sys.exit(1)
+    except Exception as e:
+        print(f"Error running CLI: {e}")
+        sys.exit(1)
+
+
+def run_gui():
+    """Launch the GUI interface."""
+    try:
+        from python_template_project.gui.gui import main as gui_main
+
+        gui_main()
+    except ImportError as e:
+        print(f"Error importing GUI module: {e}")
+        # If GUI fails, fallback to CLI
+        print("Falling back to CLI interface...")
+        run_cli()
+    except Exception as e:
+        print(f"Error running GUI: {e}")
+        print("Falling back to CLI interface...")
+        run_cli()
+
+
+def show_help():
+    """Show help information."""
+    print("""
+Unified Application
+
+Usage:
+  When launched from console:
+    - Without arguments: Interactive mode selection
+    - With arguments: Direct CLI mode
+
+  When launched via double-click:
+    - Automatically starts GUI interface
+
+Command Line Arguments:
+  Run with any CLI arguments to force CLI mode.
+
+Examples:
+  python main.py --help          # Shows CLI help
+  python main.py                 # Interactive mode selection
+  double-click main.exe          # Starts GUI
+
+""")
+
+
+if __name__ == "__main__":
+    main()

python_template_project/_version.py

@@ -0,0 +1,21 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = ["__version__", "__version_tuple__", "version", "version_tuple"]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = '0.1.15'
+__version_tuple__ = version_tuple = (0, 1, 15)

{python_template_project-0.1.0.dist-info → python_template_project-0.1.15.dist-info}/METADATA

@@ -1,32 +1,33 @@
 Metadata-Version: 2.4
 Name: python-template-project
-Version: 0.1.0
+Version: 0.1.15
 Summary: Feature-rich Python project template designed for robustness and ease of use.
 Author: pamagister
-License-File: LICENSE
 Requires-Python: <3.12,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: gpxpy>=1.6.2
 Requires-Dist: pydantic>=2.11.7
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: srtm-py>=0.3.7
 Provides-Extra: dev
-Requires-Dist: black>=25.1.0; extra == 'dev'
-Requires-Dist: coverage>=7.8.2; extra == 'dev'
-Requires-Dist: flake8>=7.2.0; extra == 'dev'
-Requires-Dist: gitchangelog>=3.0.4; extra == 'dev'
-Requires-Dist: isort>=6.0.1; extra == 'dev'
-Requires-Dist: mypy>=1.16.0; extra == 'dev'
-Requires-Dist: pre-commit>=4.2.0; extra == 'dev'
-Requires-Dist: pyinstaller>=5.8; extra == 'dev'
-Requires-Dist: pytest-cov>=6.1.1; extra == 'dev'
-Requires-Dist: pytest-mock>=3.14.1; extra == 'dev'
-Requires-Dist: pytest>=8.4.0; extra == 'dev'
-Requires-Dist: ruff>=0.11.13; extra == 'dev'
+Requires-Dist: pytest>=8.4.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.14.1; extra == "dev"
+Requires-Dist: coverage>=7.8.2; extra == "dev"
+Requires-Dist: flake8>=7.2.0; extra == "dev"
+Requires-Dist: black>=25.1.0; extra == "dev"
+Requires-Dist: isort>=6.0.1; extra == "dev"
+Requires-Dist: pytest-cov>=6.1.1; extra == "dev"
+Requires-Dist: mypy>=1.16.0; extra == "dev"
+Requires-Dist: gitchangelog>=3.0.4; extra == "dev"
+Requires-Dist: pyinstaller>=5.8; extra == "dev"
+Requires-Dist: pre-commit>=4.2.0; extra == "dev"
+Requires-Dist: ruff>=0.11.13; extra == "dev"
 Provides-Extra: docs
-Requires-Dist: mkdocs-awesome-nav>=2.6.1; extra == 'docs'
-Requires-Dist: mkdocs>=1.6.1; extra == 'docs'
-Requires-Dist: pygments>=2.19.1; extra == 'docs'
-Description-Content-Type: text/markdown
+Requires-Dist: mkdocs>=1.6.1; extra == "docs"
+Requires-Dist: mkdocs-awesome-nav>=2.6.1; extra == "docs"
+Requires-Dist: pygments>=2.19.1; extra == "docs"
+Dynamic: license-file
 
 # Welcome to python-template-project
 
@@ -46,17 +47,20 @@ This template provides a solid foundation for your next Python project, incorpor
 ## Feature overview
 
 * **Testing:** Unit testing setup with `pytest`.
-* **CI/CD:** GitHub Actions for automated builds (Windows, macOS), unit tests, and code checks.
-* **Code Formatting:** Pre-commit hook with the *black* auto-formatter to ensure consistent code style.
+* **CI/CD:**  [GitHub Actions](https://github.com/features/actions) for automated builds (Windows, macOS), unit tests, and code checks.
+* **Code Formatting and Linting:** Pre-commit hook with the [RUFF auto-formatter](https://docs.astral.sh/ruff/) to ensure consistent code style.
 * **Automated Builds:** GitHub pipeline for automatically building a Windows executable and a macOS installer.
-* **Package Management:** Utilizes *uv*, an extremely fast Python package manager, with dependencies managed in `pyproject.toml`.
+* **Package Management:** Utilizes [uv](https://docs.astral.sh/uv/getting-started/), an extremely fast Python package manager, with dependencies managed in `pyproject.toml`.
 * **Parameter-Driven Automation:**
     * Automatic generation of a configuration file from parameter definitions.
     * Automatic generation of a Command-Line Interface (CLI) from the same parameters.
     * Automatic generation of CLI API documentation.
-* **Documentation:** Configuration for publishing documentation on Read the Docs.
+* **Documentation:** Configuration for publishing documentation on [Read the Docs](https://about.readthedocs.com/) using [mkdocs](https://www.mkdocs.org/) .
 * **Workflow Automation:** A `Makefile` is included to simplify and automate common development tasks.
 * **Minimalist GUI:** Comes with a basic GUI based on [tkinker](https://tkdocs.com/tutorial/index.html) that includes an auto-generated settings menu based on your defined parameters.
+* **Release pipeline:** Automated releases unsing the Makefile `make release` command, which creates a new tag and pushes it to the remote repo. The `release` pipeline will automatically create a new release on GitHub and trigger a release on PyPI.
+    * **[setuptools](https://pypi.org/project/setuptools/)** is used to package the project and manage dependencies.
+    * **[setuptools-scm](https://pypi.org/project/setuptools-scm/)** is used to automatically generate the `_version.py` file from the `pyproject.toml` file.
 
 ## Getting started
 

{python_template_project-0.1.0.dist-info → python_template_project-0.1.15.dist-info}/RECORD

@@ -1,5 +1,8 @@
+__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+main.py,sha256=d6ZpnMxcPBf860gQmuYwPVJg1di6r2CR6gSvFLkAZkk,4448
 python_template_project/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 python_template_project/__main__.py,sha256=JS28LiHoU9Xo4c_RvyLBTDKHqdZRRytJLj6qyrg26mQ,195
+python_template_project/_version.py,sha256=OX-WIjJlMaFvqRmCfLtOYEOYoiov9NdOA089N36rG-g,513
 python_template_project/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 python_template_project/cli/__main__.py,sha256=qnGkoNNbhnvLTA24X8YTEDxRqDbNEAzgjp9Ki_JYIhs,184
 python_template_project/cli/cli.py,sha256=RvoYKJDjP-PYlX4m5xFnUsuHVJw_3-AgpQwOxhPAH5g,6974
@@ -11,8 +14,9 @@ python_template_project/core/logging.py,sha256=D99ZAXY9KZvmV7oVlAy3S3fuDf9G7vHvI
 python_template_project/gui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 python_template_project/gui/__main__.py,sha256=5AaiBxNCAKWcuSQFcQ_lsEQfEsXm6BA5-i5MScdf30c,184
 python_template_project/gui/gui.py,sha256=qJ9SawFywwT7ffPndTzhuLEu2KkzjBspmSccAXgUC2k,21725
-python_template_project-0.1.0.dist-info/METADATA,sha256=8bZTpByUoxmOQKW8XyTedN137uHRkBkZe4j6EtQUQZA,4808
-python_template_project-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_template_project-0.1.0.dist-info/entry_points.txt,sha256=LmgMiqxIVRdD7gkktVBBR0CR4AhkugqlgifuglkPhtI,148
-python_template_project-0.1.0.dist-info/licenses/LICENSE,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
-python_template_project-0.1.0.dist-info/RECORD,,
+python_template_project-0.1.15.dist-info/licenses/LICENSE,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
+python_template_project-0.1.15.dist-info/METADATA,sha256=N0SI3VOLkBfla0VrMu1Xj6H0EQJNJhxYwkKSSZdMmOY,5555
+python_template_project-0.1.15.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+python_template_project-0.1.15.dist-info/entry_points.txt,sha256=LmgMiqxIVRdD7gkktVBBR0CR4AhkugqlgifuglkPhtI,148
+python_template_project-0.1.15.dist-info/top_level.txt,sha256=9TFlucRiaKsVFCd9mTKCxamJW6LmFnXFXeI7WIvv4AA,38
+python_template_project-0.1.15.dist-info/RECORD,,

{python_template_project-0.1.0.dist-info → python_template_project-0.1.15.dist-info}/WHEEL

@@ -1,4 +1,5 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
+

python_template_project-0.1.15.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+__init__
+main
+python_template_project