Photo-Composition-Designer 0.0.7__tar.gz

photo_composition_designer-0.0.7/.github/FUNDING.yml

@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+github: [pamagister]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: ["https://www.paypal.me/PaulDD"]

photo_composition_designer-0.0.7/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug, help wanted
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

photo_composition_designer-0.0.7/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement, question
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

photo_composition_designer-0.0.7/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+### Summary :memo:
+_Write an overview about it._
+
+### Details
+_Describe more what you did on changes._
+1. (...)
+2. (...)
+
+### Bugfixes :bug: (delete if dind't have any)
+-
+
+### Checks
+- [ ] Closed #798
+- [ ] Tested Changes
+- [ ] Stakeholder Approval

photo_composition_designer-0.0.7/.github/actions/setup-environment/action.yml

@@ -0,0 +1,31 @@
+name: Setup Environment
+
+description: Setup uv environment
+
+inputs:
+  python-version:
+    description: 'Python version to use'
+    required: true
+    default: '3.11'
+
+runs:
+  using: "composite"
+  steps:
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+      with:
+        version: "latest"
+
+    - name: Create virtual environment
+      run: uv venv .venv --python ${{ inputs.python-version }}
+      shell: bash
+
+    - name: Activate virtual environment
+      run: echo "VIRTUAL_ENV=.venv" >> $GITHUB_ENV
+      shell: bash
+
+    - name: Install dependencies
+      run: |
+        uv pip install -e .
+        uv pip install -e ".[dev]"
+      shell: bash

photo_composition_designer-0.0.7/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

photo_composition_designer-0.0.7/.github/init.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+overwrite_template_dir=0
+
+while getopts t:o flag
+do
+    case "${flag}" in
+        t) template=${OPTARG};;
+        o) overwrite_template_dir=1;;
+    esac
+done
+
+if [ -z "${template}" ]; then
+    echo "Available templates: flask"
+    read -p "Enter template name: " template
+fi
+
+repo_urlname=$(basename -s .git `git config --get remote.origin.url`)
+repo_name=$(basename -s .git `git config --get remote.origin.url` | tr '-' '_' | tr '[:upper:]' '[:lower:]')
+repo_owner=$(git config --get remote.origin.url | awk -F ':' '{print $2}' | awk -F '/' '{print $1}')
+echo "Repo name: ${repo_name}"
+echo "Repo owner: ${repo_owner}"
+echo "Repo urlname: ${repo_urlname}"
+
+if [ -f ".github/workflows/rename_project.yml" ]; then
+    .github/rename_project.sh -a "${repo_owner}" -n "${repo_name}" -u "${repo_urlname}" -d "Awesome ${repo_name} created by ${repo_owner}"
+fi
+
+function download_template {
+    rm -rf "${template_dir}"
+    mkdir -p .github/templates
+    git clone "${template_url}" "${template_dir}"
+}
+
+echo "Using template:${template}"
+template_url="https://github.com/rochacbruno/${template}-project-template"
+template_dir=".github/templates/${template}"
+if [ -d "${template_dir}" ]; then
+    # Template directory already exists
+    if [ "${overwrite_template_dir}" -eq 1 ]; then
+        # user passed -o flag, delete and re-download
+        echo "Overwriting ${template_dir}"
+        download_template
+    else
+        # Ask user if they want to overwrite
+        echo "Directory ${template_dir} already exists."
+        read -p "Do you want to overwrite it? [y/N] " -n 1 -r
+        echo 
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            echo "Overwriting ${template_dir}"
+            download_template
+        else
+            # User decided not to overwrite
+            echo "Using existing ${template_dir}"
+        fi
+    fi
+else
+    # Template directory does not exist, download it
+    echo "Downloading ${template_url}"
+    download_template
+fi
+
+echo "Applying ${template} template to this project"}
+./.github/templates/${template}/apply.sh -a "${repo_owner}" -n "${repo_name}" -u "${repo_urlname}" -d "Awesome ${repo_name} created by ${repo_owner}"
+
+# echo "Removing temporary template files"
+# rm -rf .github/templates/${template}
+
+echo "Done! review, commit and push the changes"

photo_composition_designer-0.0.7/.github/release_message.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+previous_tag=$(git tag --sort=-creatordate | sed -n 2p)
+git shortlog "${previous_tag}.." | sed 's/^./    &/'

photo_composition_designer-0.0.7/.github/rename_project.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+
+# Hilfsfunktion für Fehlermeldungen und Beenden
+function die { echo "$*" >&2; exit 1; }
+
+# parse args
+while getopts a:p:n:d: flag
+do
+    case "${flag}" in
+        a) author=${OPTARG};;
+        p) package_name=${OPTARG};; # The new internal Python package name (snake_case)
+        n) project_name=${OPTARG};; # The new external project name (kebab-case)
+        d) description=${OPTARG};;
+        *) die "Unknown Flag: $flag";;
+    esac
+done
+
+# Check whether all required arguments have been passed
+[[ -z "$author" ]] && die "Missing Argument: -a (author)"
+[[ -z "$package_name" ]] && die "Missing Argument: -p (package_name)"
+[[ -z "$project_name" ]] && die "Missing Argument: -n (project_name)"
+[[ -z "$description" ]] && die "Missing Argument: -d (description)"
+
+echo "Author: $author";
+echo "New Python Package Name (internal): $package_name";
+echo "New Project Name (external/PyPI): $project_name";
+echo "Description: $description";
+
+echo "Renaming project content..."
+
+# Old identifiers
+original_author="pamagister"
+original_project_name="python-template-project"
+original_package_name="python_template_project"
+original_description="Feature-rich Python project template designed for robustness and ease of use."
+
+# Customize all file contents first
+# Use 'git ls-files' to edit only versioned files
+# Note the order: Replace more specific with more specific first,
+# then more general ones.
+# Important: Escape special characters in the variables if they could occur in the replacements.
+# Here the variables are relatively safe as they only contain alphanumeric characters and hyphens/underscores.
+
+for filename in $(git ls-files)
+do
+    # Skip files in the .github/ directory
+    if [[ "$filename" == ".github"* ]]; then
+        echo "Skipping .github file: $filename"
+        continue
+    fi
+    # Replace the old internal package name with the new internal package name
+    sed -i "s/$original_package_name/$package_name/g" "$filename"
+    # Replace the old external project name with the new external project name
+    sed -i "s/$original_project_name/$project_name/g" "$filename"
+    # Replace the old author
+    sed -i "s/$original_author/$author/g" "$filename"
+    # Replace the old description with the new one
+    sed -i "s/$original_description/$description/g" "$filename"
+    echo "Processed: $filename"
+done
+
+# Then rename the directory
+# Check if the directory exists before renaming it
+OLD_PACKAGE_DIR="src/$original_package_name"
+NEW_PACKAGE_DIR="src/$package_name"
+
+if [ -d "$OLD_PACKAGE_DIR" ]; then
+    echo "Renaming directory: $OLD_PACKAGE_DIR to $NEW_PACKAGE_DIR"
+    mv "$OLD_PACKAGE_DIR" "$NEW_PACKAGE_DIR"
+else
+    echo "Warning: Directory $OLD_PACKAGE_DIR not found. Skipping directory rename."
+fi
+
+# Remove the template.yml to indicate that the template has been applied
+echo "Removing .github/template.yml"
+rm -f .github/template.yml
+# Remove rename_project.yml to prevent re-running the renaming script
+echo "Removing .github/workflows/rename_project.yml"
+rm -f .github/workflows/rename_project.yml
+
+echo "Project renaming complete!"

photo_composition_designer-0.0.7/.github/update_funding.py

@@ -0,0 +1,46 @@
+# scripts/update_funding.py
+from pathlib import Path
+import requests
+import sys
+
+# Define the URL of your central FUNDING.md file on GitHub
+FUNDING_REPO_URL = "https://raw.githubusercontent.com/pamagister/FUNDING/main/README.md"
+
+# Define the destination path within the current repository
+# This will create 'docs/funding/funding.md'
+DST_THIS_REPO = Path("docs/funding/funding.md")
+
+
+def update_funding_file():
+    """
+    Downloads the FUNDING.md file from the central repository
+    and saves it to the specified path within the current repository.
+    """
+    print(f"Attempting to download FUNDING.md from: {FUNDING_REPO_URL}")
+
+    try:
+        # Send a GET request to the URL
+        response = requests.get(FUNDING_REPO_URL)
+        response.raise_for_status()  # Raise an HTTPError for bad responses (4xx or 5xx)
+
+        # Ensure the parent directory (e.g., 'docs/funding/') exists
+        DST_THIS_REPO.parent.mkdir(parents=True, exist_ok=True)
+
+        # Write the content to the destination file
+        with open(DST_THIS_REPO, "wb") as f:
+            f.write(response.content)
+
+        print(f"Successfully updated FUNDING.md at: {DST_THIS_REPO}")
+
+    except requests.exceptions.RequestException as e:
+        print(f"Error downloading FUNDING.md: {e}", file=sys.stderr)
+        sys.exit(1)  # Exit with an error code
+    except IOError as e:
+        print(f"Error writing FUNDING.md to file: {e}", file=sys.stderr)
+        sys.exit(1)  # Exit with an error code
+
+
+if __name__ == "__main__":
+    # Ensure the 'requests' library is installed for this script to run.
+    # If not, install it using: pip install requests
+    update_funding_file()

photo_composition_designer-0.0.7/.github/workflows/build-linux.yml

@@ -0,0 +1,48 @@
+name: Build Linux App
+
+on:
+  push:
+    tags:
+      - '*'
+  workflow_dispatch:
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ 3.11 ]
+        os: [ ubuntu-latest ]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup Environment
+        uses: ./.github/actions/setup-environment
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Build Unified Linux Executable with PyInstaller
+        run: |
+          make build-linux
+
+      - name: Prepare ZIP file for release
+        run: |
+          echo "Create the ZIP archive from the contents of the release folder"
+          cd release
+          zip -r ../package-linux.zip .
+
+      - name: Upload ZIP to GitHub Release
+        uses: softprops/action-gh-release@v2
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          files: package-linux.zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

photo_composition_designer-0.0.7/.github/workflows/build-macos.yml

@@ -0,0 +1,48 @@
+name: Build macOS App
+
+on:
+  push:
+    tags:
+      - '*'  # Triggers for tags like 0.1 or v0.1.3
+  workflow_dispatch:  # Allows manual triggering
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ 3.11 ]
+        os: [ macos-latest ]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Setup Environment # Composite Action
+        uses: ./.github/actions/setup-environment
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Build Unified Executable and App Bundle with PyInstaller
+        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
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          files: package-macOS.zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

photo_composition_designer-0.0.7/.github/workflows/build-win.yml

@@ -0,0 +1,46 @@
+name: Build Windows EXE
+
+on:
+  push:
+    tags:
+      - '*'  # Triggers for tags like 0.1 or v0.1.3
+  workflow_dispatch:  # Allows manual triggering
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ 3.11 ]
+        os: [ windows-latest ]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Setup Environment # Composite Action
+        uses: ./.github/actions/setup-environment
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Build Unified EXE with PyInstaller
+        run: make build-win
+
+      - name: Prepare ZIP file for release
+        run: |
+          echo "  - Double-click to start GUI" >> release\USAGE.txt
+          echo "  - Run from command line for CLI options" >> release\USAGE.txt
+          powershell Compress-Archive -Path release\* -DestinationPath installer-win.zip
+
+      - name: Upload ZIP to GitHub Release
+        uses: softprops/action-gh-release@v2
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          files: installer-win.zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

photo_composition_designer-0.0.7/.github/workflows/main.yml

@@ -0,0 +1,83 @@
+# This is a basic workflow to help you get started with Actions
+
+name: CI
+
+# Controls when the workflow will run
+on:
+  # Triggers the workflow on push or pull request events but only for the main branch
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  linter:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ 3.11 ]
+        os: [ubuntu-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup Environment # Composite Action
+        uses: ./.github/actions/setup-environment
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run linter
+        run: make lint
+
+  tests_win:
+    needs: linter
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ 3.11 ]
+        os: [windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup Environment # Composite Action
+        uses: ./.github/actions/setup-environment
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: run tests
+        run: uv run pytest -s -vvvv -l --tb=long tests
+
+  tests_linux_macos:
+    needs: tests_win
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ 3.11 ]
+        os: [ ubuntu-latest, macos-latest ]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup Environment # Composite Action
+        uses: ./.github/actions/setup-environment
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run tests
+        run: make test
+
+      - name: "Upload coverage to Codecov"
+        uses: codecov/codecov-action@v5

photo_composition_designer-0.0.7/.github/workflows/release.yml

@@ -0,0 +1,58 @@
+name: Upload Python Package
+permissions:
+  contents: write
+
+# if you get a Permission denied error on executing the sh file, you have to execute:
+# git update-index --chmod=+x ./.github/release_message.sh
+
+on:
+  push:
+    # Sequence of patterns matched against refs/tags
+    tags:
+      - '*' # Push events to matching v*, i.e. v1.0, v20.15.10
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  release:
+    name: Create Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # by default, it uses a depth of 1
+          # this fetches all history so that we can read each commit
+          fetch-depth: 0
+      - name: Generate Changelog
+        run: .github/release_message.sh > release_message.md
+      - name: Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: release_message.md
+
+  deploy:
+    needs: release
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        # Use a specific Python version, e.g., 3.11, consistent with your build
+        python-version: '3.11'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        # install build for modern packaging, and twine
+        pip install build twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        # Use 'python -m build' for modern packaging
+        python -m build
+        twine upload dist/*

photo_composition_designer-0.0.7/.github/workflows/update_readme.yml

@@ -0,0 +1,28 @@
+name: Sync README with docs/index.md
+
+on:
+  push:
+    paths:
+      - "docs/index.md"
+    branches: [ main ]
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Update README.md
+        run: python scripts/update_readme.py
+      - name: Commit changes
+        run: |
+          git config user.name "github-actions"
+          git config user.email "github-actions@github.com"
+          git add README.md
+          git commit -m "Update README.md from docs/index.md" || echo "No changes"
+          git push