Photo-Composition-Designer 0.0.7__py3-none-any.whl

main.py

@@ -0,0 +1,146 @@
+#!/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
+
+import Photo_Composition_Designer.cli.cli as _force_cli_import
+import Photo_Composition_Designer.gui.gui as _force_gui_import
+
+
+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:
+        _force_cli_import.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():
+    try:
+        _force_gui_import.main()
+    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()

path_handler.py

@@ -0,0 +1,10 @@
+import sys
+from pathlib import Path
+
+
+def get_base_path() -> Path:
+    if hasattr(sys, "_MEIPASS"):
+        base = Path(sys._MEIPASS)  # beim gebauten Executable
+    else:
+        base = Path(__file__).resolve().parent.parent
+    return base

photo_composition_designer-0.0.7.dist-info/METADATA

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: Photo-Composition-Designer
+Version: 0.0.7
+Summary: Feature-rich Python project template for Photo-Composition-Designer.
+Author: pamagister
+Requires-Python: <3.12,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: astral>=3.2
+Requires-Dist: config-cli-gui>=0.2.7
+Requires-Dist: exifread>=3.5.1
+Requires-Dist: geopandas>=1.1.1
+Requires-Dist: holidays>=0.84
+Requires-Dist: matplotlib>=3.10.7
+Requires-Dist: pillow>=12.0.0
+Requires-Dist: pytz>=2025.2
+Requires-Dist: shapely>=2.1.1
+Provides-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>=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 Photo-Composition-Designer
+
+A feature-rich Python project template with with auto-generated CLI, GUI and parameterized configuration.
+
+[![Github CI Status](https://github.com/pamagister/Photo-Composition-Designer/actions/workflows/main.yml/badge.svg)](https://github.com/pamagister/Photo-Composition-Designer/actions)
+[![GitHub release](https://img.shields.io/github/v/release/pamagister/Photo-Composition-Designer)](https://github.com/pamagister/Photo-Composition-Designer/releases)
+[![Read the Docs](https://readthedocs.org/projects/Photo-Composition-Designer/badge/?version=stable)](https://Photo-Composition-Designer.readthedocs.io/en/stable/)
+[![License](https://img.shields.io/github/license/pamagister/Photo-Composition-Designer)](https://github.com/pamagister/Photo-Composition-Designer/blob/main/LICENSE)
+[![GitHub issues](https://img.shields.io/github/issues/pamagister/Photo-Composition-Designer)](https://github.com/pamagister/Photo-Composition-Designer/issues)
+[![PyPI](https://img.shields.io/pypi/v/Photo-Composition-Designer)](https://pypi.org/project/Photo-Composition-Designer/)
+[![Downloads](https://pepy.tech/badge/Photo-Composition-Designer)](https://pepy.tech/project/Photo-Composition-Designer/)
+
+
+This template provides a solid foundation for your next Python project, incorporating best practices for testing, automation, and distribution. It streamlines the development process with a comprehensive set of pre-configured tools and workflows, allowing you to focus on writing code.
+
+---
+
+## How to use this template
+
+Getting started on developing your own project based on this template
+
+> **DO NOT FORK** 
+> This project is meant to be used from **[Use this template](https://github.com/pamagister/Photo-Composition-Designer/generate)** feature.
+
+---
+
+1. **Create a new repository using GitHub template**  
+   Click on **[Use this template](https://github.com/pamagister/Photo-Composition-Designer/generate)**.
+
+2. **Give a name to your project**  
+   For example: `my-python-project`  
+   *(Hyphens may be used as project name; they are converted during renaming internally to underscores for packages.)*
+
+3. **Set write permissions**  
+   Go to: `Repository -> Settings -> Actions -> General -> Workflow permissions`  
+   Select: `Read and write permissions`, then click **Save**.
+
+4. **Trigger rename workflow**  
+   Navigate to `Actions` tab → Select **Rename Action** → Run workflow on the `main` branch.
+
+5. **Wait for the workflow to finish**
+
+6. **Clone the repository**  
+   Run:  
+   ```bash
+   git clone [your-github-url]
+   ```
+
+7. **Open the project in your IDE**
+
+8. **Install dependencies and create virtual environment**
+   Run:
+
+   ```bash
+   make install
+   ```
+
+9. **Configure your IDE**
+   Set `.venv` as the local Python virtual environment.
+
+10. **Adjust project metadata**
+    Modify `pyproject.toml` (e.g., project description, authors, license, etc.)
+
+11. **Clean up template scripts**
+    Delete the files:
+
+    * `rename_project.yml`
+    * `rename_project.sh`
+
+12. **Format your codebase**
+    Run:
+
+    ```bash
+    make fmt
+    ```
+
+    This will auto-format your files and reorder imports (based on any name changes).
+
+13. **Enable pre-commit hooks**
+    Run:
+
+    ```bash
+    uv run pre-commit install
+    ```
+
+14. **Add repository to ReadTheDocs**
+    Visit: [https://app.readthedocs.org/dashboard/import/](https://app.readthedocs.org/dashboard/import/)
+
+15. **Configure PyPI publishing**
+
+    * Generate a **PyPI API token** from your PyPI account.
+    * Go to **GitHub → Settings → Secrets and variables → Actions**.
+    * Add the secret as `PYPI_API_TOKEN`.
+
+16. **Release your first version**
+    Run:
+
+    ```bash
+    make release
+    ```
+    
+---
+
+## Feature overview
+
+* 📦 **Package Management:** Utilizes [uv](https://docs.astral.sh/uv/getting-started/), an extremely fast Python package manager, with dependencies managed in `pyproject.toml`.
+* ✅ **Code Formatting and Linting:** Pre-commit hook with the [RUFF auto-formatter](https://docs.astral.sh/ruff/) to ensure consistent code style.
+* 🧪 **Testing:** Unit testing framework with [pytest](https://docs.pytest.org/en/latest/).
+* 📊 **Code coverage reports** using [codecov](https://about.codecov.io/sign-up/)
+* 🔄 **CI/CD:**  [GitHub Actions](https://github.com/features/actions) for automated builds (Windows, macOS), unit tests, and code checks.
+* 💾 **Automated Builds:** GitHub pipeline for automatically building a Windows executable and a macOS installer.
+* 💬 **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.
+    * Automatic generation of change log using **gitchangelog** to keep a HISTORY.md file up to date.
+* 📃 **Documentation:** Configuration for publishing documentation on [Read the Docs](https://about.readthedocs.com/) using [mkdocs](https://www.mkdocs.org/) .
+* 🖼️ **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.
+* 🖥️ **Workflow Automation:** A `Makefile` is included to simplify and automate common development tasks.
+* 🛳️ **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](https://pypi.org.
+    * **[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.
+
+---
+
+## Installation
+
+Get an impression of how your own project could be installed and look like.
+
+Download from [PyPI](https://pypi.org/).
+
+💾 For more installation options see [install](getting-started/install.md).
+
+```bash
+pip install Photo-Composition-Designer
+```
+
+Run GUI from command line
+
+```bash
+Photo-Composition-Designer-gui
+```
+
+Run application from command line using CLI
+
+```bash
+python -m Photo_Composition_Designer.cli [OPTIONS] path/to/file
+```
+
+```bash
+Photo-Composition-Designer-cli [OPTIONS] path/to/file
+```
+
+---
+
+## Troubleshooting
+
+### Problems with release pipeline
+
+If you get this error below:
+```bash
+/home/runner/work/_temp/xxxx_xxx.sh: line 1: .github/release_message.sh: Permission denied
+```
+
+You have to run these commands in your IDE Terminal or the git bash and then push the changes.
+```bash
+git update-index --chmod=+x ./.github/release_message.sh
+```
+

photo_composition_designer-0.0.7.dist-info/RECORD

@@ -0,0 +1,40 @@
+__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+firewall_handler.py,sha256=qT0dInkeKHulpCQD2x3HH7_lMxz4lwdkIPxEvBSl3No,7336
+main.py,sha256=j5R0od1hnX6oBvbj6Zq1sG8gIi_e6dMxAGFChnkACx0,4240
+path_handler.py,sha256=bH0yfH3rMNO0EmdJSG3R7rnxDF3bEAlALkQNWujn3dc,242
+Photo_Composition_Designer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+Photo_Composition_Designer/__main__.py,sha256=0lpgWd0a9e4OSMh-q-xHRRcciy6LH9wY1kkdzvirHII,198
+Photo_Composition_Designer/_version.py,sha256=AV58KqMkBGaCvmPdbd3g9huyNXfIVxjw8QbCMdaeivU,704
+Photo_Composition_Designer/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+Photo_Composition_Designer/cli/__main__.py,sha256=qnGkoNNbhnvLTA24X8YTEDxRqDbNEAzgjp9Ki_JYIhs,184
+Photo_Composition_Designer/cli/cli.py,sha256=59fVRDCJMdty9QU3nseVDnzxYIdwh6Gvn__E3YzwdT0,3401
+Photo_Composition_Designer/common/Anniversaries.py,sha256=jO0HeGjffoqOg1xzSLhGgzm2JRYyAccFNpbO_z3ryok,3184
+Photo_Composition_Designer/common/Locations.py,sha256=1CKMorFmsvBjUoiC8I6djuB0b7In7UxBTfNiVPUOMSU,2676
+Photo_Composition_Designer/common/MoonPhase.py,sha256=QUVtRJ5fCz7wNDXzxBUDEUDkiii1dfZydtAyzJh0m5o,2570
+Photo_Composition_Designer/common/Photo.py,sha256=ZnOunPCRJLrTph4ZY73yQF3kb7LV8GH1t10s_YE3O8E,4341
+Photo_Composition_Designer/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+Photo_Composition_Designer/common/logging.py,sha256=sHFQaSkh8QgxfU8cC0CgEqL0XTIpU9e8nX_kGPz8Jpc,6735
+Photo_Composition_Designer/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+Photo_Composition_Designer/config/config.py,sha256=QFT-ZtwIQjMxCJlXqNLjarPjcKkED_8GUHq6ilqjjq4,8794
+Photo_Composition_Designer/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+Photo_Composition_Designer/core/base.py,sha256=CyfC688ySC4n5og1LAplM_o9jgQkGbYEquqM9hfgiJE,15755
+Photo_Composition_Designer/gui/GuiLogWriter.py,sha256=g5bCuNVMOmNhRpj92UcNaP8tKZnueAJ9FAqj3wXAYjc,3337
+Photo_Composition_Designer/gui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+Photo_Composition_Designer/gui/__main__.py,sha256=5AaiBxNCAKWcuSQFcQ_lsEQfEsXm6BA5-i5MScdf30c,184
+Photo_Composition_Designer/gui/gui.py,sha256=qchl9DPL0cS9OFDYHjopDefP8RKH6A5KkjXHOcTDHhM,21966
+Photo_Composition_Designer/image/CalendarRenderer.py,sha256=7IWzQd0D6dJSpjMdKEUOhwsDpSOc8yoRNo22Xka_4wU,11285
+Photo_Composition_Designer/image/CollageRenderer.py,sha256=aEGuImseG7rPYGG_jzLDkOsapBysHEKvCNp3rhurjLE,18387
+Photo_Composition_Designer/image/DescriptionRenderer.py,sha256=ggBQ8vojH8Ew9jVSpzRsztAbF_3lFW5FcoLddqRNaxg,2330
+Photo_Composition_Designer/image/MapRenderer.py,sha256=iN6juM36U6NRRAewWVHtq6XAQcUb6Wa02_6ygb89e18,3566
+Photo_Composition_Designer/image/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+Photo_Composition_Designer/tools/DescriptionsFileGenerator.py,sha256=oqf7UHnZXS0jxt1ldH4WMFyhj76rtGB1-wxYpKdQkrE,1602
+Photo_Composition_Designer/tools/GeoPlotter.py,sha256=C6P5Eg4TMGWKl42v3lFwdiIoVDL1VDvsNiIplipaMt8,7557
+Photo_Composition_Designer/tools/Helpers.py,sha256=Y8Rzd-AKYSMtb8nYvhJPUKsfpM5SlyDXY7J94so7kys,625
+Photo_Composition_Designer/tools/ImageDistributor.py,sha256=N0HXdEhU_tQ0pEtDG-BoVDT7YqRgwwE3zFaJP99z0Es,6215
+Photo_Composition_Designer/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+photo_composition_designer-0.0.7.dist-info/licenses/LICENSE,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
+photo_composition_designer-0.0.7.dist-info/METADATA,sha256=qtLaz5q_6TnC4aRuUyblaIe8A2to6dDyo_x328h82jo,8105
+photo_composition_designer-0.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+photo_composition_designer-0.0.7.dist-info/entry_points.txt,sha256=c16Hfm7f80Yanlj5DrAHBOhQFKdwSTpvNwpLs9SXx48,160
+photo_composition_designer-0.0.7.dist-info/top_level.txt,sha256=1xcheY5VsWVQVziMEIWiue01-lcsoAMd7ZIWWBlS3QY,71
+photo_composition_designer-0.0.7.dist-info/RECORD,,

photo_composition_designer-0.0.7.dist-info/WHEEL

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

photo_composition_designer-0.0.7.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+Photo-Composition-Designer = Photo_Composition_Designer.cli.cli:main
+Photo-Composition-Designer-gui = Photo_Composition_Designer.gui.gui:main

photo_composition_designer-0.0.7.dist-info/licenses/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

photo_composition_designer-0.0.7.dist-info/top_level.txt

@@ -0,0 +1,5 @@
+Photo_Composition_Designer
+__init__
+firewall_handler
+main
+path_handler