Photo-Composition-Designer 1.0.6__tar.gz → 1.0.7__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/build-linux.yml +2 -2
  2. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/build-macos.yml +2 -2
  3. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/build-win.yml +2 -2
  4. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/main.yml +3 -3
  5. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/release.yml +3 -3
  6. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/update_readme.yml +2 -2
  7. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.gitignore +77 -0
  8. photo_composition_designer-1.0.7/AGENTS.md +94 -0
  9. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/HISTORY.md +68 -0
  10. {photo_composition_designer-1.0.6/src/Photo_Composition_Designer.egg-info → photo_composition_designer-1.0.7}/PKG-INFO +36 -3
  11. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/README.md +35 -2
  12. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/config.yaml +2 -0
  13. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/index.md +35 -2
  14. photo_composition_designer-1.0.7/docs/usage/cli.md +60 -0
  15. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/usage/config.md +8 -7
  16. photo_composition_designer-1.0.7/images/descriptions.txt +9 -0
  17. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/_version.py +3 -3
  18. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/__init__.py +40 -0
  19. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/composition_designer_factory.py +60 -0
  20. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/composition_workflow.py +124 -0
  21. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/photo_distribution_workflow.py +74 -0
  22. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/cli.py +4 -4
  23. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/config/config.py +7 -0
  24. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/base.py +229 -0
  25. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_builder.py +139 -0
  26. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_io.py +127 -0
  27. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_layout.py +73 -0
  28. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_renderer.py +171 -0
  29. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/gui.py +36 -116
  30. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/CalendarRenderer.py +219 -76
  31. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/CollageRenderer.py +5 -1
  32. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7/src/Photo_Composition_Designer.egg-info}/PKG-INFO +36 -3
  33. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/SOURCES.txt +13 -3
  34. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/scm_file_list.json +134 -124
  35. photo_composition_designer-1.0.7/src/Photo_Composition_Designer.egg-info/scm_version.json +8 -0
  36. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_CalendarRenderer.py +25 -2
  37. photo_composition_designer-1.0.7/tests/test_CompositionDesigner.py +259 -0
  38. photo_composition_designer-1.0.7/tests/test_application_workflows.py +274 -0
  39. photo_composition_designer-1.0.7/tests/test_cli.py +44 -0
  40. photo_composition_designer-1.0.7/tests/test_composition_components.py +141 -0
  41. photo_composition_designer-1.0.6/AGENTS.md +0 -94
  42. photo_composition_designer-1.0.6/docs/usage/cli.md +0 -59
  43. photo_composition_designer-1.0.6/images/descriptions.txt +0 -9
  44. photo_composition_designer-1.0.6/src/Photo_Composition_Designer/core/base.py +0 -374
  45. photo_composition_designer-1.0.6/src/Photo_Composition_Designer.egg-info/scm_version.json +0 -8
  46. photo_composition_designer-1.0.6/tests/test_CompositionDesigner.py +0 -33
  47. photo_composition_designer-1.0.6/tests/test_cli.py +0 -49
  48. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/FUNDING.yml +0 -0
  49. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  50. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  51. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  52. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/actions/setup-environment/action.yml +0 -0
  53. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/dependabot.yml +0 -0
  54. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/init.sh +0 -0
  55. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/release_message.sh +0 -0
  56. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/rename_project.sh +0 -0
  57. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/update_funding.py +0 -0
  58. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.idea/runConfigurations/config_generate.xml +0 -0
  59. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.idea/runConfigurations/module_cli.xml +0 -0
  60. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.idea/runConfigurations/module_gui.xml +0 -0
  61. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.idea/vcs.xml +0 -0
  62. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.pre-commit-config-linux.yaml +0 -0
  63. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.pre-commit-config.yaml +0 -0
  64. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.readthedocs.yaml +0 -0
  65. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/LICENSE +0 -0
  66. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/Makefile +0 -0
  67. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/anniversaries.ini +0 -0
  68. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/.nav.yml +0 -0
  69. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/collages.png +0 -0
  70. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/favicon.png +0 -0
  71. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/gui_main.png +0 -0
  72. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/gui_settings.png +0 -0
  73. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/logo.png +0 -0
  74. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/css/custom.css +0 -0
  75. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/funding/funding.md +0 -0
  76. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/getting-started/install.md +0 -0
  77. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/getting-started/virtual-environment.md +0 -0
  78. /photo_composition_designer-1.0.6/images/title/This is a description for all photos of this calender collage page. It will be displayed in one line between the photos and the calendar items..txt → /photo_composition_designer-1.0.7/images/title/This is a description for this calender collage page.txt +0 -0
  79. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/title/image_02.jpg +0 -0
  80. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_1/description.txt +0 -0
  81. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_1/image_01.jpg +0 -0
  82. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_2/image_04.jpg +0 -0
  83. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_2/image_13.jpg +0 -0
  84. /photo_composition_designer-1.0.6/images/week_3/This is a description for all photos of this calender collage page. It will be displayed in one line between the photos and the calendar items..txt → /photo_composition_designer-1.0.7/images/week_3/This is a description for this calender collage page.txt +0 -0
  85. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_3/image_02.jpg +0 -0
  86. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_3/image_03.jpg +0 -0
  87. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_3/image_07.jpg +0 -0
  88. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_4/image_08.jpg +0 -0
  89. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_4/image_09.jpg +0 -0
  90. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_4/image_10.jpg +0 -0
  91. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_4/image_13.jpg +0 -0
  92. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/Lisbon.jpg +0 -0
  93. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/image_05.jpg +0 -0
  94. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/image_06.jpg +0 -0
  95. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/image_07.jpg +0 -0
  96. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/image_13.jpg +0 -0
  97. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/bundschatten-sheep-7039994_1920.jpg +0 -0
  98. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/falkenpost-cars-1638594_1920.jpg +0 -0
  99. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/valdemarvan2003-vietnam-8121062_1920.jpg +0 -0
  100. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/fietzfotos-london-2928889_1920.jpg +0 -0
  101. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/piper60-spanish-84795_1920.jpg +0 -0
  102. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/sippakorn-cows-4708901_1920.jpg +0 -0
  103. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/tuananhngo-street-vendor-4176310_1920.jpg +0 -0
  104. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/landscape_one_bicycle_left.jpg +0 -0
  105. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/landscape_two_persons_right.jpg +0 -0
  106. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_one_person_top.jpg +0 -0
  107. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_two_cars_bottom.jpg +0 -0
  108. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_two_persons_bottom.jpg +0 -0
  109. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/locations_de.ini +0 -0
  110. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/locations_en.ini +0 -0
  111. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/mkdocs.yml +0 -0
  112. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/pyproject.toml +0 -0
  113. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/pytest.ini +0 -0
  114. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.README.html +0 -0
  115. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.VERSION.txt +0 -0
  116. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.cpg +0 -0
  117. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.dbf +0 -0
  118. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.prj +0 -0
  119. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.shp +0 -0
  120. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.shx +0 -0
  121. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.README.html +0 -0
  122. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.VERSION.txt +0 -0
  123. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.cpg +0 -0
  124. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.dbf +0 -0
  125. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.prj +0 -0
  126. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.shp +0 -0
  127. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.shx +0 -0
  128. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/yolo/yolo26n.onnx +0 -0
  129. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/scripts/generate_config_docs.py +0 -0
  130. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/scripts/project_structure.py +0 -0
  131. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/scripts/show_filelist.py +0 -0
  132. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/scripts/update_readme.py +0 -0
  133. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/setup.cfg +0 -0
  134. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/__init__.py +0 -0
  135. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/__main__.py +0 -0
  136. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/__init__.py +0 -0
  137. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/__main__.py +0 -0
  138. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Anniversaries.py +0 -0
  139. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Locations.py +0 -0
  140. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/MoonPhase.py +0 -0
  141. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Photo.py +0 -0
  142. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/__init__.py +0 -0
  143. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/config/__init__.py +0 -0
  144. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/core/__init__.py +0 -0
  145. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/GuiLogWriter.py +0 -0
  146. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/__init__.py +0 -0
  147. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/__main__.py +0 -0
  148. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/DescriptionRenderer.py +0 -0
  149. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/MapRenderer.py +0 -0
  150. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/ObjectDetector.py +0 -0
  151. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/SmartCrop.py +0 -0
  152. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/__init__.py +0 -0
  153. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/DescriptionsFileGenerator.py +0 -0
  154. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/GeoPlotter.py +0 -0
  155. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/Helpers.py +0 -0
  156. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/ImageDistributor.py +0 -0
  157. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/__init__.py +0 -0
  158. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/dependency_links.txt +0 -0
  159. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/entry_points.txt +0 -0
  160. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/requires.txt +0 -0
  161. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/top_level.txt +0 -0
  162. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/__init__.py +0 -0
  163. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/firewall_handler.py +0 -0
  164. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/main.py +0 -0
  165. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/path_handler.py +0 -0
  166. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/template.yml.url +0 -0
  167. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/TestHelper.py +0 -0
  168. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/__init__.py +0 -0
  169. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_CollageRenderer.py +0 -0
  170. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_DescriptionRenderer.py +0 -0
  171. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_DescriptionsFileGenerator.py +0 -0
  172. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_GeoPlotter.py +0 -0
  173. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_ImageDistributor.py +0 -0
  174. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_Locations.py +0 -0
  175. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_MapRenderer.py +0 -0
  176. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_MoonPhase.py +0 -0
  177. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_ObjectDetector.py +0 -0
  178. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_Photo.py +0 -0
  179. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_SmartCrop.py +0 -0
  180. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_anniversaries.py +0 -0
  181. {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/uv.lock +0 -0
@@ -17,10 +17,10 @@ jobs:
17
17
 
18
18
  steps:
19
19
  - name: Checkout repository
20
- uses: actions/checkout@v4
20
+ uses: actions/checkout@v6
21
21
 
22
22
  - name: Set up Python
23
- uses: actions/setup-python@v5
23
+ uses: actions/setup-python@v6
24
24
  with:
25
25
  python-version: ${{ matrix.python-version }}
26
26
 
@@ -17,10 +17,10 @@ jobs:
17
17
 
18
18
  steps:
19
19
  - name: Checkout repository
20
- uses: actions/checkout@v4
20
+ uses: actions/checkout@v6
21
21
 
22
22
  - name: Set up Python
23
- uses: actions/setup-python@v5
23
+ uses: actions/setup-python@v6
24
24
  with:
25
25
  python-version: '3.11'
26
26
 
@@ -16,10 +16,10 @@ jobs:
16
16
  runs-on: ${{ matrix.os }}
17
17
  steps:
18
18
  - name: Checkout repository
19
- uses: actions/checkout@v4
19
+ uses: actions/checkout@v6
20
20
 
21
21
  - name: Set up Python
22
- uses: actions/setup-python@v5
22
+ uses: actions/setup-python@v6
23
23
  with:
24
24
  python-version: '3.11'
25
25
 
@@ -22,7 +22,7 @@ jobs:
22
22
  os: [ubuntu-latest]
23
23
  runs-on: ${{ matrix.os }}
24
24
  steps:
25
- - uses: actions/checkout@v4
25
+ - uses: actions/checkout@v6
26
26
  - uses: actions/setup-python@v5
27
27
  with:
28
28
  python-version: ${{ matrix.python-version }}
@@ -44,7 +44,7 @@ jobs:
44
44
  os: [windows-latest]
45
45
  runs-on: ${{ matrix.os }}
46
46
  steps:
47
- - uses: actions/checkout@v4
47
+ - uses: actions/checkout@v6
48
48
  - uses: actions/setup-python@v5
49
49
  with:
50
50
  python-version: ${{ matrix.python-version }}
@@ -66,7 +66,7 @@ jobs:
66
66
  os: [ ubuntu-latest, macos-latest ]
67
67
  runs-on: ${{ matrix.os }}
68
68
  steps:
69
- - uses: actions/checkout@v4
69
+ - uses: actions/checkout@v6
70
70
  - uses: actions/setup-python@v5
71
71
  with:
72
72
  python-version: ${{ matrix.python-version }}
@@ -21,7 +21,7 @@ jobs:
21
21
  permissions:
22
22
  contents: write
23
23
  steps:
24
- - uses: actions/checkout@v4
24
+ - uses: actions/checkout@v6
25
25
  with:
26
26
  # by default, it uses a depth of 1
27
27
  # this fetches all history so that we can read each commit
@@ -37,9 +37,9 @@ jobs:
37
37
  needs: release
38
38
  runs-on: ubuntu-latest
39
39
  steps:
40
- - uses: actions/checkout@v4
40
+ - uses: actions/checkout@v6
41
41
  - name: Set up Python
42
- uses: actions/setup-python@v4
42
+ uses: actions/setup-python@v6
43
43
  with:
44
44
  # Use a specific Python version, e.g., 3.11, consistent with your build
45
45
  python-version: '3.11'
@@ -12,9 +12,9 @@ jobs:
12
12
  sync:
13
13
  runs-on: ubuntu-latest
14
14
  steps:
15
- - uses: actions/checkout@v4
15
+ - uses: actions/checkout@v6
16
16
  - name: Set up Python
17
- uses: actions/setup-python@v5
17
+ uses: actions/setup-python@v6
18
18
  with:
19
19
  python-version: "3.11"
20
20
  - name: Update README.md
@@ -203,3 +203,80 @@ cython_debug/
203
203
  /release/Photo-Composition-Designer.exe
204
204
  /release/README.md
205
205
  /temp/*
206
+ /collages/output.pdf
207
+ /collages/title.jpg
208
+ /collages/week_1.jpg
209
+ /collages/week_2.jpg
210
+ /collages/week_3.jpg
211
+ /collages/week_4.jpg
212
+ /collages/week_5.jpg
213
+ /collages/week_6_testimages_3.jpg
214
+ /collages/week_7_testimages_4.jpg
215
+ /collages/week_8_testimages_5.jpg
216
+ /.codebase-memory/.gitattributes
217
+ /.codebase-memory/artifact.json
218
+ /.codebase-memory/graph.db.zst
219
+ /logs/config_cli_gui.log.1
220
+ /logs/config_cli_gui.log.2
221
+ /logs/config_cli_gui.log.3
222
+ /logs/config_cli_gui.log.4
223
+ /release/collages/collage_title.jpg
224
+ /release/collages/collage_week_1.jpg
225
+ /release/collages/collage_week_2.jpg
226
+ /release/collages/collage_week_3.jpg
227
+ /release/collages/collage_week_4.jpg
228
+ /release/collages/collage_week_5.jpg
229
+ /release/collages/output.pdf
230
+ /release/docs/_static/img/favicon.png
231
+ /release/docs/_static/img/logo.png
232
+ /release/docs/css/custom.css
233
+ /release/docs/develop/contributing.md
234
+ /release/docs/develop/make_windows.md
235
+ /release/docs/develop/naming_convention.md
236
+ /release/docs/develop/pypi_release.md
237
+ /release/docs/funding/funding.md
238
+ /release/docs/getting-started/install.md
239
+ /release/docs/getting-started/virtual-environment.md
240
+ /release/docs/usage/cli.md
241
+ /release/docs/usage/config.md
242
+ /release/docs/.nav.yml
243
+ /release/docs/index.md
244
+ /release/images/title/image_02.jpg
245
+ /release/images/title/This is a description for all photos of this calender collage page. It will be displayed in one line between the photos and the calendar items..txt
246
+ /release/images/week_1/description.txt
247
+ /release/images/week_1/image_01.jpg
248
+ /release/images/week_2/image_04.jpg
249
+ /release/images/week_2/image_13.jpg
250
+ /release/images/week_3/image_02.jpg
251
+ /release/images/week_3/image_03.jpg
252
+ /release/images/week_3/image_07.jpg
253
+ /release/images/week_3/This is a description for all photos of this calender collage page. It will be displayed in one line between the photos and the calendar items..txt
254
+ /release/images/week_4/image_08.jpg
255
+ /release/images/week_4/image_09.jpg
256
+ /release/images/week_4/image_10.jpg
257
+ /release/images/week_4/image_13.jpg
258
+ /release/images/week_5/image_05.jpg
259
+ /release/images/week_5/image_06.jpg
260
+ /release/images/week_5/image_07.jpg
261
+ /release/images/week_5/image_13.jpg
262
+ /release/images/week_5/Lisbon.jpg
263
+ /release/images/descriptions.txt
264
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.cpg
265
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.dbf
266
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.prj
267
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.README.html
268
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.shp
269
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.shx
270
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.VERSION.txt
271
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.cpg
272
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.dbf
273
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.prj
274
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.README.html
275
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.shp
276
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.shx
277
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.VERSION.txt
278
+ /release/anniversaries.ini
279
+ /release/locations_de.ini
280
+ /release/locations_en.ini
281
+ /release/Photo-Composition-Designer
282
+ /tests/logs/
@@ -0,0 +1,94 @@
1
+ # AGENTS.md
2
+
3
+ ## Core Principles
4
+
5
+ - **Think before coding.** Identify the goal, assumptions, constraints, and success criteria before implementation. If ambiguity materially affects the solution, ask before proceeding. Point out simpler alternatives and relevant trade-offs.
6
+ - **Simplicity first.** Implement the simplest solution that fully meets the requirements. Avoid speculative features, unnecessary abstractions, premature optimization, and unrequested configurability.
7
+ - **Surgical changes.** Modify only what the task requires. Preserve existing conventions and avoid unrelated refactoring. Remove only dead code made obsolete by your changes; report unrelated issues without fixing them.
8
+ - **Correctness over cleverness.** Prioritize clarity, maintainability, reliability, and measurable performance. Optimize algorithms, memory usage, and runtime where justified by actual requirements. Use vectorization or parallelization when beneficial.
9
+
10
+ ## Workflow
11
+
12
+ 1. **Inspect** the relevant code, project structure, configuration, dependencies, and existing tests before making changes.
13
+ 2. **Plan** briefly for nontrivial tasks. Define concrete, verifiable success criteria.
14
+ 3. **Implement** the smallest complete solution, following existing project conventions.
15
+ 4. **Verify** changes with relevant tests, formatting, linting, and type checking. Fix issues introduced by the changes.
16
+ 5. **Report** what changed, which checks passed, and any remaining limitations.
17
+
18
+ Do not claim that checks passed unless they were actually executed. If verification is impossible, explain why.
19
+
20
+ ## Python Code Quality
21
+
22
+ - Follow PEP 8 and the existing project style. Use 4 spaces for indentation and keep lines within 100 characters where practical.
23
+ - Use descriptive names, `snake_case` for functions and variables, `PascalCase` for classes, and `UPPER_CASE` for constants.
24
+ - Add type hints to all function signatures. Avoid `Any` unless genuinely necessary.
25
+ - Write docstrings for public functions, classes, and methods. Document parameters, return values, and raised exceptions where relevant.
26
+ - Prefer small, focused functions and classes with clear responsibilities. Limit function parameters to five where practical; use early returns to reduce nesting.
27
+ - Never use mutable default arguments. Use `is` for comparisons with `None`, `True`, and `False`.
28
+ - Prefer f-strings, context managers, and explicit imports. Avoid wildcard imports and redundant comments.
29
+ - Handle errors explicitly. Catch specific exceptions, provide meaningful context, and never silently suppress unexpected failures.
30
+ - Use dataclasses for simple data containers and composition over inheritance where appropriate.
31
+ - Never use emoji or emoji-like Unicode characters in code, comments, or documentation unless explicitly required for tests or functionality.
32
+
33
+ ## Dependencies and Tooling
34
+
35
+ - Use `uv` for dependency management and virtual environments when available or when initializing a project.
36
+ - Declare and manage dependencies in `pyproject.toml`. Avoid unnecessary dependencies and preserve existing project tooling.
37
+ - Prefer established project commands and configuration over introducing new tools or conventions.
38
+ - Use `ruff` for formatting and linting and `mypy` for static type checking when configured or appropriate.
39
+ - Use `pytest` for tests. Add or update tests for new behavior, bug fixes, and meaningful edge cases. Mock external dependencies where appropriate.
40
+ - Never introduce tooling or dependencies solely for marginal benefits.
41
+
42
+ ## Testing and Delivery
43
+
44
+ Before completing a task, run the relevant checks available in the repository. Prefer existing commands, such as:
45
+
46
+ ```bash
47
+ make fmt
48
+ make lint
49
+ make test
50
+ ```
51
+
52
+ These documentation artifacts are generated by the command
53
+
54
+ ```bash
55
+ make syncdocs
56
+ ```
57
+
58
+ which triggers
59
+ ```bash
60
+ @uv run ./scripts/generate_config_docs.py
61
+ @uv run ./scripts/update_readme.py
62
+ @uv run ./.github/update_funding.py
63
+ ```
64
+
65
+ ```text
66
+ Generated: config.yaml
67
+ Generated: docs/usage/config.md
68
+ Generated: docs/usage/cli.md
69
+ Generated: README.md updated from docs/index.md
70
+ Generated: docs/funding/funding.md
71
+ ```
72
+
73
+ Never edit these artifacts directly. If you want e.g. the CLI.md or config.yaml/md
74
+ you have to adjust the **ConfigCategory** Classes that are passed into the **ConfigManager** class
75
+ and then run `make syncdocs`
76
+
77
+ Run only commands that exist and are appropriate for the task. Check the project configuration for additional requirements, including type checking.
78
+
79
+ - Test bug fixes with regression tests whenever practical.
80
+ - Test boundary conditions and failure cases where relevant.
81
+ - Keep tests deterministic and independent of external services unless integration testing explicitly requires them.
82
+ - Use mock only if really required. Implement "Tests with Teeth"
83
+ - Do not weaken or remove tests merely to make them pass.
84
+
85
+ ## Decision Rules
86
+
87
+ - Do not assume when uncertainty matters. State assumptions and ask concise clarifying questions when necessary.
88
+ - Do not add features, abstractions, error handling, or configuration without a concrete need.
89
+ - Do not refactor unrelated code or reformat entire files unnecessarily.
90
+ - When multiple solutions are viable, prefer the simplest maintainable option that fits the existing architecture.
91
+ - If requirements conflict with existing behavior, security, correctness, or maintainability, explain the conflict before making consequential changes.
92
+ - Treat repository instructions and established project conventions as authoritative unless they conflict with explicit user requirements or higher-priority instructions.
93
+
94
+ **Guiding principle:** Make the smallest correct change, keep the code maintainable, and verify the result.
@@ -4,6 +4,74 @@ Changelog
4
4
 
5
5
  (unreleased)
6
6
  ------------
7
+ - Update AGENTS.md. [Paul Magister]
8
+ - Vibe-coding session: [Paul Magister]
9
+
10
+ CompositionDesigner verwendet jetzt den CompositionFileOperations-Vertrag. Die Application-Factory bündelt den Aufbau der Datei- und Renderer-Kollaboratoren und injiziert sie; direkte Konstruktion bleibt als Kompatibilitätspfad erhalten. Echte Integrationstests rendern temporäre Fotos und prüfen JPEG- und PDF-Ausgaben. Außerdem löscht der CLI-Test keine projektweiten Collagen mehr.
11
+ - Vibe-coding session: [Paul Magister]
12
+
13
+ Die erste große Verbesserung ist umgesetzt: CLI und GUI erstellen Composition-Workflows jetzt über einen gemeinsamen CompositionApplicationFactory. Auch Vorschauen verwenden dieselbe Designer-Factory; sie nutzen die Seitengröße des bestehenden Designers, statt dafür einen zusätzlichen Designer zu erzeugen. Die GUI greift für Verzeichnisse und Cache-Steuerung über den Workflow zu. Fortschritt wird typisiert beim Erzeugen übergeben; leere Verarbeitungsläufe lösen keinen GUI-Fehler mehr aus.
14
+ - Vibe-coding session: [Paul Magister]
15
+
16
+ Die Renderer-Abhängigkeiten werden jetzt im neuen CompositionRendererBuilder aufgebaut und als typisierte CompositionRenderComponents an CompositionDesigner übergeben. Bestehende Aufrufe bleiben kompatibel; Tests können die Komponenten gezielt injizieren. In TODO.md habe ich den bereits vorhandenen Schnitt als erledigt markiert, die nächsten Architekturthemen priorisiert und „tests with teeth“ ergänzt.
17
+ - Vibe-coding session: [Paul Magister]
18
+
19
+ CompositionDesigner ist jetzt in fokussierte Komponenten aufgeteilt: CompositionLayout berechnet Maße und Beschreibungsoptionen, CompositionPageRenderer rendert die Seite und CompositionIO übernimmt Fotoeingabe sowie Bild-/PDF-Ausgabe. Die Designer-Klasse koordiniert diese Aufgaben weiter; bei der Stapelverarbeitung werden Fotoordner nur noch einmal aufgelistet.
20
+ - Vibe-coding session: [Paul Magister]
21
+
22
+ Die erste Architekturverbesserung ist umgesetzt: MainGui delegiert Kompositionsmodi, Vorschau-Erstellung und Fotoverteilung jetzt an UI-unabhängige Dienste im neuen Paket src/Photo_Composition_Designer/application/. Tkinter, Hintergrundthreads und Fortschrittsanzeige bleiben in der GUI; das bisherige Verhalten der Abläufe bleibt erhalten.
23
+ - Fix text color: Only red text if holiday. [Paul Magister]
24
+ - #5 vertical calendar: first approach. [Paul Magister]
25
+ - #5 vertical calendar: first approach. [Paul Magister]
26
+ - Add tests for new flag feature. [Paul Magister]
27
+ - Merge pull request #2 from
28
+ pamagister/dependabot/github_actions/actions/setup-python-6. [Paul
29
+ Magister]
30
+
31
+ Bump actions/setup-python from 4 to 6
32
+ - Merge branch 'main' into dependabot/github_actions/actions/setup-
33
+ python-6. [Paul Magister]
34
+ - Bump actions/setup-python from 4 to 6. [dependabot[bot]]
35
+
36
+ Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4 to 6.
37
+ - [Release notes](https://github.com/actions/setup-python/releases)
38
+ - [Commits](https://github.com/actions/setup-python/compare/v4...v6)
39
+
40
+ ---
41
+ updated-dependencies:
42
+ - dependency-name: actions/setup-python
43
+ dependency-version: '6'
44
+ dependency-type: direct:production
45
+ update-type: version-update:semver-major
46
+ ...
47
+ - #4 fix filename length. [Paul Magister]
48
+ - Introduce flags in description: - `[no-calendar]` — prevents a
49
+ calendar from being generated for this photo. - `[no-description]` —
50
+ suppresses the generated photo description. [Paul Magister]
51
+ - Merge pull request #3 from
52
+ pamagister/dependabot/github_actions/actions/checkout-6. [Paul
53
+ Magister]
54
+
55
+ Bump actions/checkout from 4 to 6
56
+ - Bump actions/checkout from 4 to 6. [dependabot[bot]]
57
+
58
+ Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 6.
59
+ - [Release notes](https://github.com/actions/checkout/releases)
60
+ - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
61
+ - [Commits](https://github.com/actions/checkout/compare/v4...v6)
62
+
63
+ ---
64
+ updated-dependencies:
65
+ - dependency-name: actions/checkout
66
+ dependency-version: '6'
67
+ dependency-type: direct:production
68
+ update-type: version-update:semver-major
69
+ ...
70
+
71
+
72
+ 1.0.6 (2026-06-25)
73
+ ------------------
74
+ - Docs: Update HISTORY.md for release 1.0.6. [Paul Magister]
7
75
  - Fix gui: no duplicated button frame. [Paul Magister]
8
76
  - Add documentation for new feature, fix links in README.md, new images.
9
77
  [Paul Magister]
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: Photo-Composition-Designer
3
- Version: 1.0.6
3
+ Version: 1.0.7
4
4
  Summary: Feature-rich Python project template for Photo-Composition-Designer.
5
5
  Author: pamagister
6
6
  Requires-Python: <4.0,>=3.11
@@ -80,9 +80,10 @@ Download the latest executable:
80
80
 
81
81
  Get an impression of how your own project could be installed and look like.
82
82
 
83
- Download from [PyPI](https://pypi.org/).
83
+ Download from [PyPI](https://pypi.org/). For more installation options see [install](getting-started/install.md).
84
84
 
85
- 💾 For more installation options see [install](getting-started/install.md).
85
+ <details open>
86
+ <summary>💡 Details PyPI Installation</summary>
86
87
 
87
88
  ```bash
88
89
  pip install Photo-Composition-Designer
@@ -98,6 +99,9 @@ Run GUI from command line
98
99
  Photo-Composition-Designer-gui
99
100
  ```
100
101
 
102
+ </details>
103
+
104
+
101
105
  ---
102
106
 
103
107
 
@@ -120,6 +124,9 @@ Organize your images in the `images/` directory before running the generator.
120
124
  You can use one of the distribution methods to distribute your plain images inside this directory
121
125
  into sub-folders that represent your weekly collage content.
122
126
 
127
+ <details open>
128
+ <summary>💡 Details Photo Directory Structure</summary>
129
+
123
130
  ```plaintext
124
131
  📁 images/
125
132
  ├── 📁 title/
@@ -136,15 +143,38 @@ into sub-folders that represent your weekly collage content.
136
143
 
137
144
  ```
138
145
 
146
+ </details>
147
+
148
+
139
149
  ### 3️⃣ **Provide Descriptions** 🖥️
140
150
  Provide descriptions for every week to describe the events.
141
151
 
142
152
  You can use one single `description.txt` file that can be generated using the GUI
143
153
  or you can put individual txt files into every single weekly sub folder.
144
154
 
155
+ <details>
156
+ <summary>💡 Optional control flags</summary>
157
+
158
+ The following flags can be added anywhere in the photo description:
159
+
160
+ - `[no-calendar]` — prevents a calendar from being generated for this photo.
161
+ - `[no-description]` — suppresses the generated photo description.
162
+
163
+ Example:
164
+
165
+ ```text
166
+ Family vacation at the beach [no-calendar]
167
+ [no-description]
168
+ ```
169
+ </details>
170
+
171
+
145
172
  ### 4️⃣ **Setting up the birthday dates** 🎂📅
146
173
  Provide the birthday information of your friends and family by using the `anniversaries.ini`
147
174
 
175
+ <details open>
176
+ <summary>💡 Details</summary>
177
+
148
178
  ```plaintext
149
179
  [Birthdays]
150
180
 
@@ -156,6 +186,9 @@ Anna = 10.01.
156
186
  [Weddings]
157
187
  Mary & Josh = 02.01.2021 ; ⚭ Symbol is used for Weddings
158
188
  ```
189
+ </details>
190
+
191
+
159
192
 
160
193
  ### 5️⃣ **Generating the Calendar** 🖼️
161
194
  Use **Generate Composition** to generate all collages and one PDF file containing all your compositions.
@@ -42,9 +42,10 @@ Download the latest executable:
42
42
 
43
43
  Get an impression of how your own project could be installed and look like.
44
44
 
45
- Download from [PyPI](https://pypi.org/).
45
+ Download from [PyPI](https://pypi.org/). For more installation options see [install](docs/getting-started/install.md).
46
46
 
47
- 💾 For more installation options see [install](docs/getting-started/install.md).
47
+ <details open>
48
+ <summary>💡 Details PyPI Installation</summary>
48
49
 
49
50
  ```bash
50
51
  pip install Photo-Composition-Designer
@@ -60,6 +61,9 @@ Run GUI from command line
60
61
  Photo-Composition-Designer-gui
61
62
  ```
62
63
 
64
+ </details>
65
+
66
+
63
67
  ---
64
68
 
65
69
 
@@ -82,6 +86,9 @@ Organize your images in the `images/` directory before running the generator.
82
86
  You can use one of the distribution methods to distribute your plain images inside this directory
83
87
  into sub-folders that represent your weekly collage content.
84
88
 
89
+ <details open>
90
+ <summary>💡 Details Photo Directory Structure</summary>
91
+
85
92
  ```plaintext
86
93
  📁 images/
87
94
  ├── 📁 title/
@@ -98,15 +105,38 @@ into sub-folders that represent your weekly collage content.
98
105
 
99
106
  ```
100
107
 
108
+ </details>
109
+
110
+
101
111
  ### 3️⃣ **Provide Descriptions** 🖥️
102
112
  Provide descriptions for every week to describe the events.
103
113
 
104
114
  You can use one single `description.txt` file that can be generated using the GUI
105
115
  or you can put individual txt files into every single weekly sub folder.
106
116
 
117
+ <details>
118
+ <summary>💡 Optional control flags</summary>
119
+
120
+ The following flags can be added anywhere in the photo description:
121
+
122
+ - `[no-calendar]` — prevents a calendar from being generated for this photo.
123
+ - `[no-description]` — suppresses the generated photo description.
124
+
125
+ Example:
126
+
127
+ ```text
128
+ Family vacation at the beach [no-calendar]
129
+ [no-description]
130
+ ```
131
+ </details>
132
+
133
+
107
134
  ### 4️⃣ **Setting up the birthday dates** 🎂📅
108
135
  Provide the birthday information of your friends and family by using the `anniversaries.ini`
109
136
 
137
+ <details open>
138
+ <summary>💡 Details</summary>
139
+
110
140
  ```plaintext
111
141
  [Birthdays]
112
142
 
@@ -118,6 +148,9 @@ Anna = 10.01.
118
148
  [Weddings]
119
149
  Mary & Josh = 02.01.2021 ; ⚭ Symbol is used for Weddings
120
150
  ```
151
+ </details>
152
+
153
+
121
154
 
122
155
  ### 5️⃣ **Generating the Calendar** 🖼️
123
156
  Use **Generate Composition** to generate all collages and one PDF file containing all your compositions.
@@ -31,6 +31,8 @@ calendar:
31
31
  startDate: '2025-12-29T00:00:00'
32
32
  # Number of collages to be generated (e.g. number of weeks) | type=int
33
33
  collagesToGenerate: 53
34
+ # Align the calendar horizontally (False means vertical) | type=bool | [CLI] | choices=[True, False]
35
+ horizontalOrientation: true
34
36
  style:
35
37
  # Background color (RGB) | type=Color
36
38
  backgroundColor: '#141414'
@@ -40,9 +40,10 @@ Download the latest executable:
40
40
 
41
41
  Get an impression of how your own project could be installed and look like.
42
42
 
43
- Download from [PyPI](https://pypi.org/).
43
+ Download from [PyPI](https://pypi.org/). For more installation options see [install](getting-started/install.md).
44
44
 
45
- 💾 For more installation options see [install](getting-started/install.md).
45
+ <details open>
46
+ <summary>💡 Details PyPI Installation</summary>
46
47
 
47
48
  ```bash
48
49
  pip install Photo-Composition-Designer
@@ -58,6 +59,9 @@ Run GUI from command line
58
59
  Photo-Composition-Designer-gui
59
60
  ```
60
61
 
62
+ </details>
63
+
64
+
61
65
  ---
62
66
 
63
67
 
@@ -80,6 +84,9 @@ Organize your images in the `images/` directory before running the generator.
80
84
  You can use one of the distribution methods to distribute your plain images inside this directory
81
85
  into sub-folders that represent your weekly collage content.
82
86
 
87
+ <details open>
88
+ <summary>💡 Details Photo Directory Structure</summary>
89
+
83
90
  ```plaintext
84
91
  📁 images/
85
92
  ├── 📁 title/
@@ -96,15 +103,38 @@ into sub-folders that represent your weekly collage content.
96
103
 
97
104
  ```
98
105
 
106
+ </details>
107
+
108
+
99
109
  ### 3️⃣ **Provide Descriptions** 🖥️
100
110
  Provide descriptions for every week to describe the events.
101
111
 
102
112
  You can use one single `description.txt` file that can be generated using the GUI
103
113
  or you can put individual txt files into every single weekly sub folder.
104
114
 
115
+ <details>
116
+ <summary>💡 Optional control flags</summary>
117
+
118
+ The following flags can be added anywhere in the photo description:
119
+
120
+ - `[no-calendar]` — prevents a calendar from being generated for this photo.
121
+ - `[no-description]` — suppresses the generated photo description.
122
+
123
+ Example:
124
+
125
+ ```text
126
+ Family vacation at the beach [no-calendar]
127
+ [no-description]
128
+ ```
129
+ </details>
130
+
131
+
105
132
  ### 4️⃣ **Setting up the birthday dates** 🎂📅
106
133
  Provide the birthday information of your friends and family by using the `anniversaries.ini`
107
134
 
135
+ <details open>
136
+ <summary>💡 Details</summary>
137
+
108
138
  ```plaintext
109
139
  [Birthdays]
110
140
 
@@ -116,6 +146,9 @@ Anna = 10.01.
116
146
  [Weddings]
117
147
  Mary & Josh = 02.01.2021 ; ⚭ Symbol is used for Weddings
118
148
  ```
149
+ </details>
150
+
151
+
119
152
 
120
153
  ### 5️⃣ **Generating the Calendar** 🖼️
121
154
  Use **Generate Composition** to generate all collages and one PDF file containing all your compositions.
@@ -0,0 +1,60 @@
1
+ # Command Line Interface
2
+
3
+ Command line options for app
4
+
5
+ ```bash
6
+ python -m app [OPTIONS] photoDirectory
7
+ ```
8
+
9
+ ## Options
10
+
11
+ | Option | Type | Description | Default | Choices |
12
+ |---------------------------|-----------|-----------------------------------------------------------------------------------------|---------------------------------------|---------------|
13
+ | `photoDirectory` | PosixPath | Path to the directory containing photos (absolute, or relative to this config.ini file) | *required* | - |
14
+ | `--startDate` | datetime | Start date of the calendar | datetime.datetime(2025, 12, 29, 0, 0) | - |
15
+ | `--horizontalOrientation` | bool | Align the calendar horizontally (False means vertical) | True | [True, False] |
16
+ | `--width` | int | Width of the collage in mm | 216 | - |
17
+ | `--height` | int | Height of the collage in mm | 154 | - |
18
+ | `--dpi` | int | Resolution of the image in dpi | 300 | - |
19
+
20
+
21
+ ## Examples
22
+
23
+
24
+ ### 1. Basic usage
25
+
26
+ ```bash
27
+ python -m app photoDirectory
28
+ ```
29
+
30
+ ### 2. With verbose logging
31
+
32
+ ```bash
33
+ python -m app -v photoDirectory
34
+ python -m app --verbose photoDirectory
35
+ ```
36
+
37
+ ### 3. With quiet mode
38
+
39
+ ```bash
40
+ python -m app -q photoDirectory
41
+ python -m app --quiet photoDirectory
42
+ ```
43
+
44
+ ### 4. With startDate parameter
45
+
46
+ ```bash
47
+ python -m app --startDate 2025-12-29 00:00:00 photoDirectory
48
+ ```
49
+
50
+ ### 5. With horizontalOrientation parameter
51
+
52
+ ```bash
53
+ python -m app --horizontalOrientation True photoDirectory
54
+ ```
55
+
56
+ ### 6. With width parameter
57
+
58
+ ```bash
59
+ python -m app --width 216 photoDirectory
60
+ ```