python-template-project 0.1.20__tar.gz → 0.2.0__tar.gz

{python_template_project-0.1.20 → python_template_project-0.2.0}/.github/workflows/build-macos.yml

@@ -30,7 +30,14 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Build Unified Executable and App Bundle with PyInstaller
-        run: make build-macos
+        run: |
+          make build-macos
+
+      - name: Prepare ZIP file for release
+        run: |
+          echo "Create the ZIP archive from the contents of the release folder"
+          cd release
+          zip -r ../package-macOS.zip .
 
       - name: Upload ZIP to GitHub Release
         uses: softprops/action-gh-release@v2

{python_template_project-0.1.20 → python_template_project-0.2.0}/HISTORY.md

@@ -4,6 +4,22 @@ Changelog
 
 (unreleased)
 ------------
+- Feat #33: Support kml files for input and display output files as
+  clickable links #33. [Paul Magister]
+- Feat #31: move project specific namings into makefile so that it can
+  be renamed. [Paul Magister]
+
+
+0.1.20 (2025-06-20)
+-------------------
+- Feat #31: move project specific namings into makefile so that it can
+  be renamed. [Paul Magister]
+- Feat #31: move project specific namings into makefile so that it can
+  be renamed. [Paul Magister]
+
+
+0.1.19 (2025-06-20)
+-------------------
 - Feat #31: move project specific namings into makefile so that it can
   be renamed. [Paul Magister]
 - Feat #31: try this renaming automation. [Paul Magister]

{python_template_project-0.1.20 → python_template_project-0.2.0}/Makefile

@@ -87,10 +87,6 @@ build-macos:    ## Build the macOS executable.
 	cp README.md release/
 	echo "Create usage instructions"
 
-	echo "Create the ZIP archive from the contents of the release folder"
-	cd release
-	zip -r ../package-macOS.zip .
-
 .PHONY: watch
 watch:            ## Run tests on every change.
 	ls **/**.py | entr uv run pytest -s -vvv -l --tb=long --maxfail=1 tests/
@@ -160,11 +156,15 @@ docs:             ## Build and sync the documentation.
 
 .PHONY: list
 list:            ## Show project file list (excluding ignored folders)
-	@powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/show-filelist.ps1
+	@powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/show_filelist.ps1
 
 .PHONY: tree
 tree:            ## Show project tree (excluding ignored folders)
-	@powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/show-tree.ps1
+	@powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/show_tree.ps1
+
+.PHONY: pytree
+pytree:            ## Show project tree (excluding ignored folders)
+	@uv run ./scripts/show_tree.py
 
 .PHONY: init
 init:             ## Initialize the project based on an application template.

{python_template_project-0.1.20/src/python_template_project.egg-info → python_template_project-0.2.0}/PKG-INFO

@@ -1,14 +1,16 @@
 Metadata-Version: 2.4
 Name: python-template-project
-Version: 0.1.20
+Version: 0.2.0
 Summary: Feature-rich Python project template designed for robustness and ease of use.
 Author: pamagister
 Requires-Python: <3.12,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: fastkml>=1.1.0
 Requires-Dist: gpxpy>=1.6.2
 Requires-Dist: pydantic>=2.11.7
 Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: shapely>=2.1.1
 Requires-Dist: srtm-py>=0.3.7
 Provides-Extra: dev
 Requires-Dist: pytest>=8.4.0; extra == "dev"
@@ -39,30 +41,98 @@ A feature-rich Python project template with with auto-generated CLI, GUI and par
 [![License](https://img.shields.io/github/license/pamagister/python-template-project)](https://github.com/pamagister/python-template-project/blob/main/LICENSE)
 [![GitHub issues](https://img.shields.io/github/issues/pamagister/python-template-project)](https://github.com/pamagister/python-template-project/issues)
 [![PyPI](https://img.shields.io/pypi/v/python-template-project)](https://pypi.org/project/python-template-project/)
+[![Downloads](https://pepy.tech/badge/python-template-project)](https://pepy.tech/project/python-template-project/)
 
 
 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.
 
-## Installation
+---
 
-Download from [PyPI](https://pypi.org/).
+## How to use this template
 
-💾 For more installation options see [install](getting-started/install.md).
+Getting started on developing your own project based on this template
 
-```bash
-pip install python-template-project
-```
+> **DO NOT FORK** 
+> This project is meant to be used from **[Use this template](https://github.com/pamagister/python-template-project/generate)** feature.
 
-Run GUI from command line
+---
 
-```bash
-python-template-project-gui
-```
+1. **Create a new repository using GitHub template**  
+   Click on **[Use this template](https://github.com/pamagister/python-template-project/generate)**.
 
-## How to use this template
+2. **Give a name to your project**  
+   For example: `my-python-project`  
+   *(Hyphens may ne 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**
 
-🐍 For details, see the [Getting Started](develop/01_getting_started_dev.md) guide.
+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
 
@@ -84,3 +154,49 @@ python-template-project-gui
     * **[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 python-template-project
+```
+
+Run GUI from command line
+
+```bash
+python-template-project-gui
+```
+
+Run application from command line using CLI
+
+```bash
+python -m python_template_project.cli [OPTIONS] path/to/file
+```
+
+```bash
+python-template-project-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
+```
+

{python_template_project-0.1.20 → python_template_project-0.2.0}/README.md

@@ -10,30 +10,98 @@ A feature-rich Python project template with with auto-generated CLI, GUI and par
 [![License](https://img.shields.io/github/license/pamagister/python-template-project)](https://github.com/pamagister/python-template-project/blob/main/LICENSE)
 [![GitHub issues](https://img.shields.io/github/issues/pamagister/python-template-project)](https://github.com/pamagister/python-template-project/issues)
 [![PyPI](https://img.shields.io/pypi/v/python-template-project)](https://pypi.org/project/python-template-project/)
+[![Downloads](https://pepy.tech/badge/python-template-project)](https://pepy.tech/project/python-template-project/)
 
 
 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.
 
-## Installation
+---
 
-Download from [PyPI](https://pypi.org/).
+## How to use this template
 
-💾 For more installation options see [install](docs/getting-started/install.md).
+Getting started on developing your own project based on this template
 
-```bash
-pip install python-template-project
-```
+> **DO NOT FORK** 
+> This project is meant to be used from **[Use this template](https://github.com/pamagister/python-template-project/generate)** feature.
 
-Run GUI from command line
+---
 
-```bash
-python-template-project-gui
-```
+1. **Create a new repository using GitHub template**  
+   Click on **[Use this template](https://github.com/pamagister/python-template-project/generate)**.
 
-## How to use this template
+2. **Give a name to your project**  
+   For example: `my-python-project`  
+   *(Hyphens may ne 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**
 
-🐍 For details, see the [Getting Started](docs/develop/01_getting_started_dev.md) guide.
+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
 
@@ -55,3 +123,49 @@ python-template-project-gui
     * **[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](docs/getting-started/install.md).
+
+```bash
+pip install python-template-project
+```
+
+Run GUI from command line
+
+```bash
+python-template-project-gui
+```
+
+Run application from command line using CLI
+
+```bash
+python -m python_template_project.cli [OPTIONS] path/to/file
+```
+
+```bash
+python-template-project-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
+```
+

{python_template_project-0.1.20 → python_template_project-0.2.0}/docs/index.md

@@ -8,30 +8,98 @@ A feature-rich Python project template with with auto-generated CLI, GUI and par
 [![License](https://img.shields.io/github/license/pamagister/python-template-project)](https://github.com/pamagister/python-template-project/blob/main/LICENSE)
 [![GitHub issues](https://img.shields.io/github/issues/pamagister/python-template-project)](https://github.com/pamagister/python-template-project/issues)
 [![PyPI](https://img.shields.io/pypi/v/python-template-project)](https://pypi.org/project/python-template-project/)
+[![Downloads](https://pepy.tech/badge/python-template-project)](https://pepy.tech/project/python-template-project/)
 
 
 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.
 
-## Installation
+---
 
-Download from [PyPI](https://pypi.org/).
+## How to use this template
 
-💾 For more installation options see [install](getting-started/install.md).
+Getting started on developing your own project based on this template
 
-```bash
-pip install python-template-project
-```
+> **DO NOT FORK** 
+> This project is meant to be used from **[Use this template](https://github.com/pamagister/python-template-project/generate)** feature.
 
-Run GUI from command line
+---
 
-```bash
-python-template-project-gui
-```
+1. **Create a new repository using GitHub template**  
+   Click on **[Use this template](https://github.com/pamagister/python-template-project/generate)**.
 
-## How to use this template
+2. **Give a name to your project**  
+   For example: `my-python-project`  
+   *(Hyphens may ne 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**
 
-🐍 For details, see the [Getting Started](develop/01_getting_started_dev.md) guide.
+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
 
@@ -53,3 +121,49 @@ python-template-project-gui
     * **[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 python-template-project
+```
+
+Run GUI from command line
+
+```bash
+python-template-project-gui
+```
+
+Run application from command line using CLI
+
+```bash
+python -m python_template_project.cli [OPTIONS] path/to/file
+```
+
+```bash
+python-template-project-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
+```
+

{python_template_project-0.1.20 → python_template_project-0.2.0}/docs/usage/cli.md

@@ -1,55 +1,45 @@
-# Command line interface
+# Command Line Interface
 
-Command line options
+Command line options for app
 
 ```bash
-python -m python_template_project.cli [OPTIONS] path/to/file
+python -m app [OPTIONS] input
 ```
 
----
-
-## ⚙️ CLI-Options
+## Options
 
 | Option                | Type | Description                                       | Default    | Choices       |
 |-----------------------|------|---------------------------------------------------|------------|---------------|
-| `path/to/file`        | str  | Path to input (file or folder)                    | *required* | -             |
+| `input`               | str  | Path to input (file or folder)                    | *required* | -             |
 | `--output`            | str  | Path to output destination                        | *required* | -             |
 | `--min_dist`          | int  | Maximum distance between two waypoints            | 20         | -             |
 | `--extract_waypoints` | bool | Extract starting points of each track as waypoint | True       | [True, False] |
 | `--elevation`         | bool | Include elevation data in waypoints               | True       | [True, False] |
 
 
-## 💡 Examples
-
-In the example, the following is assumed: `example.input` in the current directory
-
+## Examples
 
-### 1. Standard version (only required parameter)
-
-```bash
-python -m python_template_project.cli input
-```
 
-### 2. With verbose logging
+### 1. Basic usage
 
 ```bash
-python -m python_template_project.cli --verbose input
+python -m app input
 ```
 
-### 3. With quiet mode
+### 2. With min_dist parameter
 
 ```bash
-python -m python_template_project.cli --quiet input
+python -m app --min_dist 20 input
 ```
 
-### 4. Example with 1 Parameter(s)
+### 3. With extract_waypoints parameter
 
 ```bash
-python -m python_template_project.cli --min_dist 20 input
+python -m app --extract_waypoints True input
 ```
 
-### 5. Example with 2 Parameter(s)
+### 4. With elevation parameter
 
 ```bash
-python -m python_template_project.cli --min_dist 20 --extract_waypoints True input
+python -m app --elevation True input
 ```

{python_template_project-0.1.20 → python_template_project-0.2.0}/docs/usage/config.md

@@ -1,4 +1,4 @@
-# Config parameters
+# Configuration Parameters
 
 These parameters are available to configure the behavior of your application.
 The parameters in the cli category can be accessed via the command line interface.

{python_template_project-0.1.20 → python_template_project-0.2.0}/pyproject.toml

@@ -8,9 +8,11 @@ authors = [
 readme = "docs/index.md"
 requires-python = ">=3.10,<3.12"
 dependencies = [
+    "fastkml>=1.1.0",
     "gpxpy>=1.6.2",
     "pydantic>=2.11.7",
     "pyyaml>=6.0.2",
+    "shapely>=2.1.1",
     "srtm-py>=0.3.7",
 ]