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.
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/build-linux.yml +2 -2
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/build-macos.yml +2 -2
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/build-win.yml +2 -2
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/main.yml +3 -3
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/release.yml +3 -3
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/update_readme.yml +2 -2
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.gitignore +77 -0
- photo_composition_designer-1.0.7/AGENTS.md +94 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/HISTORY.md +68 -0
- {photo_composition_designer-1.0.6/src/Photo_Composition_Designer.egg-info → photo_composition_designer-1.0.7}/PKG-INFO +36 -3
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/README.md +35 -2
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/config.yaml +2 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/index.md +35 -2
- photo_composition_designer-1.0.7/docs/usage/cli.md +60 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/usage/config.md +8 -7
- photo_composition_designer-1.0.7/images/descriptions.txt +9 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/_version.py +3 -3
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/__init__.py +40 -0
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/composition_designer_factory.py +60 -0
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/composition_workflow.py +124 -0
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/photo_distribution_workflow.py +74 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/cli.py +4 -4
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/config/config.py +7 -0
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/base.py +229 -0
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_builder.py +139 -0
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_io.py +127 -0
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_layout.py +73 -0
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_renderer.py +171 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/gui.py +36 -116
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/CalendarRenderer.py +219 -76
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/CollageRenderer.py +5 -1
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7/src/Photo_Composition_Designer.egg-info}/PKG-INFO +36 -3
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/SOURCES.txt +13 -3
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/scm_file_list.json +134 -124
- photo_composition_designer-1.0.7/src/Photo_Composition_Designer.egg-info/scm_version.json +8 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_CalendarRenderer.py +25 -2
- photo_composition_designer-1.0.7/tests/test_CompositionDesigner.py +259 -0
- photo_composition_designer-1.0.7/tests/test_application_workflows.py +274 -0
- photo_composition_designer-1.0.7/tests/test_cli.py +44 -0
- photo_composition_designer-1.0.7/tests/test_composition_components.py +141 -0
- photo_composition_designer-1.0.6/AGENTS.md +0 -94
- photo_composition_designer-1.0.6/docs/usage/cli.md +0 -59
- photo_composition_designer-1.0.6/images/descriptions.txt +0 -9
- photo_composition_designer-1.0.6/src/Photo_Composition_Designer/core/base.py +0 -374
- photo_composition_designer-1.0.6/src/Photo_Composition_Designer.egg-info/scm_version.json +0 -8
- photo_composition_designer-1.0.6/tests/test_CompositionDesigner.py +0 -33
- photo_composition_designer-1.0.6/tests/test_cli.py +0 -49
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/FUNDING.yml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/actions/setup-environment/action.yml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/dependabot.yml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/init.sh +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/release_message.sh +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/rename_project.sh +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/update_funding.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.idea/runConfigurations/config_generate.xml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.idea/runConfigurations/module_cli.xml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.idea/runConfigurations/module_gui.xml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.idea/vcs.xml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.pre-commit-config-linux.yaml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.pre-commit-config.yaml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.readthedocs.yaml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/LICENSE +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/Makefile +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/anniversaries.ini +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/.nav.yml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/collages.png +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/favicon.png +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/gui_main.png +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/gui_settings.png +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/_static/img/logo.png +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/css/custom.css +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/funding/funding.md +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/getting-started/install.md +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/docs/getting-started/virtual-environment.md +0 -0
- /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
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/title/image_02.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_1/description.txt +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_1/image_01.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_2/image_04.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_2/image_13.jpg +0 -0
- /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
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_3/image_02.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_3/image_03.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_3/image_07.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_4/image_08.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_4/image_09.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_4/image_10.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_4/image_13.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/Lisbon.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/image_05.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/image_06.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/image_07.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_5/image_13.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/bundschatten-sheep-7039994_1920.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/falkenpost-cars-1638594_1920.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/valdemarvan2003-vietnam-8121062_1920.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/fietzfotos-london-2928889_1920.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/piper60-spanish-84795_1920.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/sippakorn-cows-4708901_1920.jpg +0 -0
- {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
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/landscape_one_bicycle_left.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/landscape_two_persons_right.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_one_person_top.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_two_cars_bottom.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_two_persons_bottom.jpg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/locations_de.ini +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/locations_en.ini +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/mkdocs.yml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/pyproject.toml +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/pytest.ini +0 -0
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/res/yolo/yolo26n.onnx +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/scripts/generate_config_docs.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/scripts/project_structure.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/scripts/show_filelist.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/scripts/update_readme.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/setup.cfg +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/__main__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/__main__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Anniversaries.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Locations.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/MoonPhase.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Photo.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/config/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/core/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/GuiLogWriter.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/__main__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/DescriptionRenderer.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/MapRenderer.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/ObjectDetector.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/SmartCrop.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/DescriptionsFileGenerator.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/GeoPlotter.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/Helpers.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/ImageDistributor.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/dependency_links.txt +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/entry_points.txt +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/requires.txt +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/top_level.txt +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/firewall_handler.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/main.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/src/path_handler.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/template.yml.url +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/TestHelper.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/__init__.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_CollageRenderer.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_DescriptionRenderer.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_DescriptionsFileGenerator.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_GeoPlotter.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_ImageDistributor.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_Locations.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_MapRenderer.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_MoonPhase.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_ObjectDetector.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_Photo.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_SmartCrop.py +0 -0
- {photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/tests/test_anniversaries.py +0 -0
- {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@
|
|
20
|
+
uses: actions/checkout@v6
|
|
21
21
|
|
|
22
22
|
- name: Set up Python
|
|
23
|
-
uses: actions/setup-python@
|
|
23
|
+
uses: actions/setup-python@v6
|
|
24
24
|
with:
|
|
25
25
|
python-version: ${{ matrix.python-version }}
|
|
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@
|
|
19
|
+
uses: actions/checkout@v6
|
|
20
20
|
|
|
21
21
|
- name: Set up Python
|
|
22
|
-
uses: actions/setup-python@
|
|
22
|
+
uses: actions/setup-python@v6
|
|
23
23
|
with:
|
|
24
24
|
python-version: '3.11'
|
|
25
25
|
|
{photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/main.yml
RENAMED
|
@@ -22,7 +22,7 @@ jobs:
|
|
|
22
22
|
os: [ubuntu-latest]
|
|
23
23
|
runs-on: ${{ matrix.os }}
|
|
24
24
|
steps:
|
|
25
|
-
- uses: actions/checkout@
|
|
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@
|
|
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@
|
|
69
|
+
- uses: actions/checkout@v6
|
|
70
70
|
- uses: actions/setup-python@v5
|
|
71
71
|
with:
|
|
72
72
|
python-version: ${{ matrix.python-version }}
|
{photo_composition_designer-1.0.6 → photo_composition_designer-1.0.7}/.github/workflows/release.yml
RENAMED
|
@@ -21,7 +21,7 @@ jobs:
|
|
|
21
21
|
permissions:
|
|
22
22
|
contents: write
|
|
23
23
|
steps:
|
|
24
|
-
- uses: actions/checkout@
|
|
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@
|
|
40
|
+
- uses: actions/checkout@v6
|
|
41
41
|
- name: Set up Python
|
|
42
|
-
uses: actions/setup-python@
|
|
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@
|
|
15
|
+
- uses: actions/checkout@v6
|
|
16
16
|
- name: Set up Python
|
|
17
|
-
uses: actions/setup-python@
|
|
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.
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
+
```
|