Photo-Composition-Designer 0.0.7__tar.gz → 0.0.9__tar.gz

{photo_composition_designer-0.0.7 → photo_composition_designer-0.0.9}/.idea/workspace.xml

@@ -4,9 +4,14 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="7196224b-0c6d-4df3-926f-d243fd984ba4" name="Changes" comment="improve path issue with relative paths to res/ini files">
+    <list default="true" id="7196224b-0c6d-4df3-926f-d243fd984ba4" name="Changes" comment="set up nice documentation">
       <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/Makefile" beforeDir="false" afterPath="$PROJECT_DIR$/Makefile" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/docs/index.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/index.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/Photo_Composition_Designer/cli/cli.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/Photo_Composition_Designer/cli/cli.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/Photo_Composition_Designer/common/logging.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/Photo_Composition_Designer/common/logging.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/Photo_Composition_Designer/core/base.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/Photo_Composition_Designer/core/base.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/Photo_Composition_Designer/gui/gui.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/Photo_Composition_Designer/gui/gui.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/Photo_Composition_Designer/tools/GeoPlotter.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/Photo_Composition_Designer/tools/GeoPlotter.py" afterDir="false" />
     </list>
     <list id="124f435c-cc09-40e9-9ed2-72d6742eb56b" name="NO_COMMIT" comment="" />
     <option name="SHOW_DIALOG" value="false" />
@@ -88,17 +93,17 @@
     "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
     "RunOnceActivity.git.unshallow": "true",
     "git-widget-placeholder": "main",
-    "last_opened_file_path": "/home/paul/dev/Photo-Composition-Designer",
-    "settings.editor.selected.configurable": "preferences.pluginManager"
+    "last_opened_file_path": "/home/paul/dev/Photo-Composition-Designer/docs/_static/img",
+    "settings.editor.selected.configurable": "com.android.studio.ml.bot.mainConfigurable"
   }
 }]]></component>
   <component name="RecentsManager">
     <key name="CopyFile.RECENT_KEYS">
+      <recent name="$PROJECT_DIR$/docs/_static/img" />
       <recent name="$PROJECT_DIR$" />
       <recent name="$PROJECT_DIR$/.github/workflows" />
       <recent name="$PROJECT_DIR$/images" />
       <recent name="$PROJECT_DIR$/tests" />
-      <recent name="$PROJECT_DIR$/src/Photo_Composition_Designer/config" />
     </key>
     <key name="MoveFile.RECENT_KEYS">
       <recent name="$PROJECT_DIR$" />
@@ -213,9 +218,9 @@
       <item itemvalue="Python.config-generate" />
       <item itemvalue="Python.module cli" />
       <item itemvalue="Python.module gui" />
-      <item itemvalue="Python.show_tree" />
       <item itemvalue="Python.cli" />
       <item itemvalue="Python.main" />
+      <item itemvalue="Python.show_tree" />
       <item itemvalue="Python tests.pytest in test_DescriptionsFileGenerator.py" />
       <item itemvalue="Python tests.pytest in test_cli.py" />
     </list>
@@ -232,7 +237,7 @@
   <component name="SharedIndexes">
     <attachedChunks>
       <set>
-        <option value="bundled-python-sdk-1f77c24022e5-d902c0275401-com.jetbrains.pycharm.community.sharedIndexes.bundled-PC-252.26830.99" />
+        <option value="bundled-python-sdk-7bb8055f9097-cbfc7b97e6b2-com.jetbrains.pycharm.community.sharedIndexes.bundled-PC-252.28238.29" />
       </set>
     </attachedChunks>
   </component>
@@ -581,7 +586,31 @@
       <option name="project" value="LOCAL" />
       <updated>1764495033316</updated>
     </task>
-    <option name="localTasksCounter" value="43" />
+    <task id="LOCAL-00043" summary="fix more import errors">
+      <option name="closed" value="true" />
+      <created>1764496058584</created>
+      <option name="number" value="00043" />
+      <option name="presentableId" value="LOCAL-00043" />
+      <option name="project" value="LOCAL" />
+      <updated>1764496058584</updated>
+    </task>
+    <task id="LOCAL-00044" summary="fix zip linux">
+      <option name="closed" value="true" />
+      <created>1764496556213</created>
+      <option name="number" value="00044" />
+      <option name="presentableId" value="LOCAL-00044" />
+      <option name="project" value="LOCAL" />
+      <updated>1764496556213</updated>
+    </task>
+    <task id="LOCAL-00045" summary="set up nice documentation">
+      <option name="closed" value="true" />
+      <created>1764540117905</created>
+      <option name="number" value="00045" />
+      <option name="presentableId" value="LOCAL-00045" />
+      <option name="project" value="LOCAL" />
+      <updated>1764540117905</updated>
+    </task>
+    <option name="localTasksCounter" value="46" />
     <servers />
   </component>
   <component name="Vcs.Log.Tabs.Properties">
@@ -596,9 +625,6 @@
     </option>
   </component>
   <component name="VcsManagerConfiguration">
-    <MESSAGE value="add tests for CompositionDesigner.py" />
-    <MESSAGE value="add tests for CompositionDesigner.py, fix issue with font" />
-    <MESSAGE value="* move all generators that create images to image&#10;* typings&#10;* refactorings" />
     <MESSAGE value="consistently rename core methods" />
     <MESSAGE value="only use Image.Image in CollageGenerator.py" />
     <MESSAGE value="remove unused images, restructure test" />
@@ -621,7 +647,10 @@
     <MESSAGE value="move all ini files top-level so that the user can find them immediately" />
     <MESSAGE value="add ini files individually, fix test_cli.py for windows" />
     <MESSAGE value="improve path issue with relative paths to res/ini files" />
-    <option name="LAST_COMMIT_MESSAGE" value="improve path issue with relative paths to res/ini files" />
+    <MESSAGE value="fix more import errors" />
+    <MESSAGE value="fix zip linux" />
+    <MESSAGE value="set up nice documentation" />
+    <option name="LAST_COMMIT_MESSAGE" value="set up nice documentation" />
   </component>
   <component name="XDebuggerManager">
     <breakpoint-manager>
@@ -673,12 +702,12 @@
         </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
           <url>file://$PROJECT_DIR$/src/Photo_Composition_Designer/gui/gui.py</url>
-          <line>424</line>
+          <line>442</line>
           <option name="timeStamp" value="31" />
         </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
           <url>file://$PROJECT_DIR$/src/Photo_Composition_Designer/gui/gui.py</url>
-          <line>429</line>
+          <line>447</line>
           <option name="timeStamp" value="32" />
         </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
@@ -693,12 +722,12 @@
         </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
           <url>file://$PROJECT_DIR$/src/Photo_Composition_Designer/gui/gui.py</url>
-          <line>269</line>
+          <line>278</line>
           <option name="timeStamp" value="51" />
         </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
           <url>file://$PROJECT_DIR$/src/Photo_Composition_Designer/core/base.py</url>
-          <line>51</line>
+          <line>60</line>
           <option name="timeStamp" value="53" />
         </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
@@ -716,11 +745,6 @@
           <line>110</line>
           <option name="timeStamp" value="56" />
         </line-breakpoint>
-        <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
-          <url>file://$PROJECT_DIR$/src/Photo_Composition_Designer/common/Anniversaries.py</url>
-          <line>10</line>
-          <option name="timeStamp" value="57" />
-        </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
           <url>file://$PROJECT_DIR$/scripts/show_tree.py</url>
           <line>138</line>

{photo_composition_designer-0.0.7 → photo_composition_designer-0.0.9}/HISTORY.md

@@ -2,8 +2,19 @@ Changelog
 =========
 
 
-(unreleased)
-------------
+0.0.8 (2025-12-01)
+------------------
+- Docs: Update HISTORY.md for release 0.0.8. [Paul Magister]
+- Fix test. [Paul Magister]
+- Progress bar, logger in base.py, lifecycle fixes. [Paul Magister]
+- Improved logging. [Paul Magister]
+- Update README.md from docs/index.md. [github-actions]
+- Set up nice documentation. [Paul Magister]
+
+
+0.0.7 (2025-11-30)
+------------------
+- Docs: Update HISTORY.md for release 0.0.7. [Paul Magister]
 - Remove zip function from makefile. [Paul Magister]
 
 

{photo_composition_designer-0.0.7 → photo_composition_designer-0.0.9}/Makefile

@@ -136,7 +136,7 @@ build-win: clean
 # ==========================
 
 .PHONY: build-macos
-build-macos: clean
+build-macos:
 	echo "Building macOS CLI/GUI executable"
 	uv run pyinstaller --onefile src/main.py \
 		--name $(NAME) \

photo_composition_designer-0.0.9/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: Photo-Composition-Designer
+Version: 0.0.9
+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
+
+Photo-Composition-Designer is a tool designed to automate the creation of beautiful image-based calendars. The system sorts images, generates collages, adds descriptions and maps, and formats everything into a structured calendar layout.
+
+[![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/)
+
+
+
+## 🛠️ Features
+
+* ✅ **Automated Calendar Generation** – Generates a full image-based calendar.
+* ✅ **Configurable Settings** – Modify sizes, layouts, and text via `config.yaml`.
+* ✅ **Anniversaries & Events** – Load anniversaries and special dates using `anniversaries.ini`.
+* ✅ **Location-Based Maps** – Integrate maps showing image locations using gps meta-data or image names and `locations.ini`.
+* ✅ **GUI Configuration Tool** – Easily modify configurations via a dynamic UI.
+* ✅ **Folder Management** – Automatically structures and organizes images into necessary folders.
+
+![Main GUI](_static/img/gui_main.png)
+
+---
+
+## Installation via executable:
+
+Download the latest executable:
+
+- [⬇️ Download for Windows](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/installer-win.zip)
+- [⬇️ Download for Linux](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/package-linux.zip)
+- [⬇️ Download for macOS](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/package-macos.zip)
+
+
+## Installation via pypi
+
+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
+```
+
+---
+
+
+## 🔄 Workflow
+
+### 1️⃣ **Configuring the parameters**
+You can adjust the result by setting up your own parameters like size, margins and colors.
+For more details, see [Configuration Parameters](usage/config.md).
+Modify your settings inside the `config.yaml` or using the GUI:
+- Image sizes (mm converted to pixels internally)
+- Calendar layout
+- Paths to `anniversaries.ini` and `locations.ini`
+
+### 2️⃣ **Sorting Images into Folders**
+Organize your images in the `images/` directory before running the generator.
+You can use one of the distribution methods to distribute your plain images inside this directory
+into sub-folders that represent your weekly collage content.
+
+```plaintext
+📁 images/
+├── 📁 0-Title/
+    ├── 2024-01-01_ski_trip.jpg
+├── 📁 Week 1/
+    ├── 2024-02-14_valentines_dinner in London.jpg
+```
+
+### 3️⃣ **Provide Descriptions** 🖥️
+Provide descriptions for every week to describe the events.
+You can use one single `description.txt` file that can be generated using the GUI
+or you can put individual txt files into every single weekly sub folder.
+
+### 4️⃣ **Setting up the birthday dates** 🎂📅
+Provide the birthday information of your friends and family by using the `anniversaries.ini`
+
+### **Generating the Calendar** 🖼️
+Use **Generate Composition** to generate all collages and one PDF file containing all your compositions.
+
+---
+
+If you find this app helpful, [Funding](funding/funding.md) is highly appreciated 🧡.

photo_composition_designer-0.0.9/README.md

@@ -0,0 +1,101 @@
+<!-- This README.md is auto-generated from docs/index.md -->
+
+# Welcome to Photo-Composition-Designer
+
+Photo-Composition-Designer is a tool designed to automate the creation of beautiful image-based calendars. The system sorts images, generates collages, adds descriptions and maps, and formats everything into a structured calendar layout.
+
+[![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/)
+
+
+
+## 🛠️ Features
+✅ **Automated Calendar Generation** – Generates a full image-based calendar.
+✅ **Configurable Settings** – Modify sizes, layouts, and text via `config.yaml`.
+✅ **Anniversaries & Events** – Load anniversaries and special dates using `anniversaries.ini`.
+✅ **Location-Based Maps** – Integrate maps showing image locations using gps meta-data or image names and `locations.ini`.
+✅ **GUI Configuration Tool** – Easily modify configurations via a dynamic UI.
+✅ **Folder Management** – Automatically structures and organizes images into necessary folders.
+
+![Main GUI](_static/img/gui_main.png)
+
+---
+
+## Installation via executable:
+
+Download the latest executable:
+
+- [⬇️ Download for Windows](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/installer-win.zip)
+- [⬇️ Download for Linux](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/package-linux.zip)
+- [⬇️ Download for macOS](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/package-macos.zip)
+
+
+## Installation via pypi
+
+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 Photo-Composition-Designer
+```
+
+Run GUI from command line
+
+```bash
+Photo-Composition-Designer
+```
+
+---
+
+## Configuration parameters
+
+You can adjust the result by setting up your own parameters like size, margins and colors.
+For more details, see [Configuration Parameters](usage/config.md).
+
+--- 
+
+
+## 🔄 Workflow
+
+
+### 1️⃣ **Configuring the Settings**
+Modify your settings inside the `config.yaml` or using the GUI:
+- Image sizes (mm converted to pixels internally)
+- Calendar layout
+- Paths to `anniversaries.ini` and `locations.ini`
+
+### 2️⃣ **Sorting Images into Folders**
+Organize your images in the `images/` directory before running the generator.
+You can use one of the distribution methods to distribute your plain images inside this directory
+into sub-folders that represent your weekly collage content.
+
+```plaintext
+📁 images/
+├── 📁 0-Title/
+    ├── 2024-01-01_ski_trip.jpg
+├── 📁 Week 1/
+    ├── 2024-02-14_valentines_dinner in London.jpg
+```
+
+### 3️⃣ **Provide Descriptions** 🖥️
+Provide descriptions for every week to describe the events.
+You can use one single `description.txt` file that can be generated using the GUI
+or you can put individual txt files into every single weekly sub folder.
+
+### 4️⃣ **Setting up the birthday dates** 🎂📅
+Provide the birthday information of your friends and family by using the `anniversaries.ini`
+
+### **Generating the Calendar** 🖼️
+Use **Generate Composition** to generate all collages and one PDF file containing all your compositions.
+
+---
+
+If you find this app helpful, [Funding](funding/funding.md) is highly appreciated 🧡.

{photo_composition_designer-0.0.7 → photo_composition_designer-0.0.9}/docs/getting-started/install.md

@@ -26,6 +26,7 @@ Photo-Composition-Designer-gui
 Download the latest executable:
 
 - [⬇️ Download for Windows](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/installer-win.zip)
+- [⬇️ Download for Linux](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/package-linux.zip)
 - [⬇️ Download for macOS](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/package-macos.zip)
 
 

photo_composition_designer-0.0.9/docs/index.md

@@ -0,0 +1,94 @@
+# Welcome to Photo-Composition-Designer
+
+Photo-Composition-Designer is a tool designed to automate the creation of beautiful image-based calendars. The system sorts images, generates collages, adds descriptions and maps, and formats everything into a structured calendar layout.
+
+[![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/)
+
+
+
+## 🛠️ Features
+
+* ✅ **Automated Calendar Generation** – Generates a full image-based calendar.
+* ✅ **Configurable Settings** – Modify sizes, layouts, and text via `config.yaml`.
+* ✅ **Anniversaries & Events** – Load anniversaries and special dates using `anniversaries.ini`.
+* ✅ **Location-Based Maps** – Integrate maps showing image locations using gps meta-data or image names and `locations.ini`.
+* ✅ **GUI Configuration Tool** – Easily modify configurations via a dynamic UI.
+* ✅ **Folder Management** – Automatically structures and organizes images into necessary folders.
+
+![Main GUI](_static/img/gui_main.png)
+
+---
+
+## Installation via executable:
+
+Download the latest executable:
+
+- [⬇️ Download for Windows](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/installer-win.zip)
+- [⬇️ Download for Linux](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/package-linux.zip)
+- [⬇️ Download for macOS](https://github.com/pamagister/Photo-Composition-Designer/releases/latest/download/package-macos.zip)
+
+
+## Installation via pypi
+
+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
+```
+
+---
+
+
+## 🔄 Workflow
+
+### 1️⃣ **Configuring the parameters**
+You can adjust the result by setting up your own parameters like size, margins and colors.
+For more details, see [Configuration Parameters](usage/config.md).
+Modify your settings inside the `config.yaml` or using the GUI:
+- Image sizes (mm converted to pixels internally)
+- Calendar layout
+- Paths to `anniversaries.ini` and `locations.ini`
+
+### 2️⃣ **Sorting Images into Folders**
+Organize your images in the `images/` directory before running the generator.
+You can use one of the distribution methods to distribute your plain images inside this directory
+into sub-folders that represent your weekly collage content.
+
+```plaintext
+📁 images/
+├── 📁 0-Title/
+    ├── 2024-01-01_ski_trip.jpg
+├── 📁 Week 1/
+    ├── 2024-02-14_valentines_dinner in London.jpg
+```
+
+### 3️⃣ **Provide Descriptions** 🖥️
+Provide descriptions for every week to describe the events.
+You can use one single `description.txt` file that can be generated using the GUI
+or you can put individual txt files into every single weekly sub folder.
+
+### 4️⃣ **Setting up the birthday dates** 🎂📅
+Provide the birthday information of your friends and family by using the `anniversaries.ini`
+
+### **Generating the Calendar** 🖼️
+Use **Generate Composition** to generate all collages and one PDF file containing all your compositions.
+
+---
+
+If you find this app helpful, [Funding](funding/funding.md) is highly appreciated 🧡.

{photo_composition_designer-0.0.7 → photo_composition_designer-0.0.9}/src/Photo_Composition_Designer/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.7'
-__version_tuple__ = version_tuple = (0, 0, 7)
+__version__ = version = '0.0.9'
+__version_tuple__ = version_tuple = (0, 0, 9)
 
-__commit_id__ = commit_id = 'g1f5555ec6'
+__commit_id__ = commit_id = 'gdaac21952'

{photo_composition_designer-0.0.7 → photo_composition_designer-0.0.9}/src/Photo_Composition_Designer/cli/cli.py

@@ -23,7 +23,7 @@ def validate_config(config_manager: ConfigParameterManager) -> bool:
         True if configuration is valid, False otherwise
     """
     # Initialize logging system
-    logger_manager = initialize_logging(config_manager)
+    logger_manager = initialize_logging(config_manager.app.log_level.value)
     logger = logger_manager.get_logger("Photo_Composition_Designer.cli")
 
     # Get CLI category and check required parameters
@@ -53,7 +53,7 @@ def run_main_processing(config_manager: ConfigParameterManager) -> int:
         Exit code (0 for success, non-zero for error)
     """
     # Initialize logging system
-    logger_manager = initialize_logging(config_manager)
+    logger_manager = initialize_logging(config_manager.app.log_level.value)
     logger = logger_manager.get_logger("Photo_Composition_Designer.cli")
 
     try:

{photo_composition_designer-0.0.7 → photo_composition_designer-0.0.9}/src/Photo_Composition_Designer/common/logging.py

@@ -3,7 +3,7 @@
 This module provides a unified logging setup that supports:
 - File logging with rotation
 - GUI integration via custom handler
-- Configurable log levels from config
+- Configurable log levels
 - Structured logging with consistent formatting
 """
 
@@ -12,8 +12,6 @@ import logging.handlers
 import sys
 from pathlib import Path
 
-from Photo_Composition_Designer.config.config import ConfigParameterManager
-
 
 class GuiLogHandler(logging.Handler):
     """Custom logging handler that can write to GUI text widgets."""
@@ -39,21 +37,20 @@ class GuiLogHandler(logging.Handler):
 class LoggerManager:
     """Manages all logging configuration and handlers."""
 
-    def __init__(self, config: ConfigParameterManager):
-        self.config = config
+    def __init__(self, log_level="INFO"):
         self.logger = logging.getLogger("Photo_Composition_Designer")
         self.gui_handler = None
         self.file_handler = None
         self.console_handler = None
-        self._setup_logging()
+        self.log_level = log_level
+        self._setup_logging(log_level)
 
-    def _setup_logging(self):
+    def _setup_logging(self, log_level):
         """Configure all logging handlers and formatters."""
         # Clear any existing handlers
         self.logger.handlers.clear()
 
-        # Set log level from config
-        log_level = getattr(logging, self.config.app.log_level.value.upper())
+        # Set log level
         self.logger.setLevel(log_level)
 
         # Create formatters
@@ -141,13 +138,12 @@ class LoggerManager:
         log_level = getattr(logging, level.upper())
         self.logger.setLevel(log_level)
 
-        # Update config
-        self.config.app.log_level.value = level.upper()
+        self.log_level = level.upper()
 
     def log_config_summary(self):
         """Log current configuration summary."""
         self.logger.info("=== Configuration Summary ===")
-        self.logger.info(f"Log level: {self.config.app.log_level.value}")
+        self.logger.info(f"Log level: {self.log_level}")
         self.logger.info("==============================")
 
 
@@ -155,17 +151,17 @@ class LoggerManager:
 _logger_manager = None
 
 
-def initialize_logging(config: ConfigParameterManager) -> LoggerManager:
+def initialize_logging(log_level="INFO") -> LoggerManager:
     """Initialize the global logging system.
 
     Args:
-        config: Configuration manager instance
+        log_level: logging level
 
     Returns:
         LoggerManager instance
     """
     global _logger_manager
-    _logger_manager = LoggerManager(config)
+    _logger_manager = LoggerManager(log_level)
     return _logger_manager