geovisio 2.8.0__tar.gz → 2.9.0__tar.gz

{geovisio-2.8.0 → geovisio-2.9.0}/CHANGELOG.md

@@ -9,13 +9,55 @@ Before _1.6.0_, [Viewer](https://gitlab.com/panoramax/clients/web-viewer) was em
 
 ## [Unreleased]
 
+## [2.9.0] - 2025-05-12
+
+### Added
+
+- Add a new configuration `PICTURE_PROCESS_NB_RETRIES` to tell the number of times a job will be retried if there is a `RecoverableProcessException` during process (like if the blurring api is not reachable). Defaults to 5 like before.
+- Add a way to search on semantic tags in `/api/search` endpoint with a CQL2 filter like `filter="semantics.some_key"='some_value'`.
+- Add a `API_REGISTRATION_IS_OPEN` setting in the API to tell the federation that account can (or not) be created directly on the instance. Defaults to `false`.
+- Added field `geovisio:rank_in_collection` to pictures metadata to get the rank of the picture in the collection in `/api/collections/:cid/items/:id` / `/api/collections/:cid/items` and `/api/search` responses. This makes it easier to use the `startAfterRank` parameter to paginate through pictures in collections..
+- Handle semantics returned by the blurring API, and automatically add annotations on the pictures with semantic tags on the detected objects..
+
+### Fixed
+
+- Fix the pagination links when many sequences had the exact same creation date on `/api/collections`.
+- Migration `20240409_01_jnhra-pictures-grid.sql` was not working from empty database.
+- When asking for collections list as CSV format, API was sending `Content-Type: text/html` instead of `text/csv` in response.
+- Fix a sql error on `/api/users/me/collection` when using PostgreSQL <= 13.
+- Fix a bug causing a 500 when filtering collections with no updates
+- Fix a bug where the collection geometry was not recomputed after a sort.
+
+### Changed
+
+- Change the way the coefficients are computed for the grid, compute the mean only over squares with flat (or 360°) pictures.
+- Update lot of dependencies (Flask, psycopg, pillow, sentry, ...)
+
+## [2.8.1] - 2025-03-13
+
+### Added
+
+- Add a way to know the role and permission of the logged user in `/api/users/me`.
+- Add the ability to update an upload set parameters through a `PATCH` on `/api/upload_sets/:id`.
+- Add a debug endpoint `/api/debug_headers` that can be handy when setting a new instance to check if the proxies are correctly setting the headers.
+- Add the ability to add annotations to a part of a picture, with semantic tags associated (through `/api/collections/:id/items/:id/annotations`).
+
+### Fixed
+
+- Fix a bug where dispatching several time the same upload set would not cleanup unused sequences.
+- Fix a bug where the relative heading parameter was not correctly validated on null values.
+
+### Changed
+
+- Only display `tos_accepted` field in `/api/users/me` if ToS are mandatory.
+
 ## [2.8.0] - 2025-02-10
 
 ### Added
 
 - Add the ability to export a user's collections in a CSV file by either providing a `format` query parameter or with the `Accept: text/csv` header. The CSV export is not limited to the first 1000 collections as the JSON API.
 - More metadata can be defined for the API in `API_SUMMARY` environment variable: contact email and geographical coverage
-- Add the ability to blur again a picture/sequence, by calling the `/api/collections/:id/prepare`/`/api/collections/:id/items/:id/prepare` endpoints. 
+- Add the ability to blur again a picture/sequence, by calling the `/api/collections/:id/prepare`/`/api/collections/:id/items/:id/prepare` endpoints.
 - Add the ability to change a picture's capture time, latitude and longitude using the PATCH `/api/collections/:id/items/:id` route.
 - Add the number of collection to the endpoint `/api/users/:id/collection`
 - Add _pages_ management to handle legal mentions and terms of service storage in database. New routes `/api/pages` allow to create, list, delete these pages in several languages.
@@ -606,7 +648,9 @@ FLASK_APP="src" flask process-sequences
 - Viewer based on Photo Sphere Viewer automatically calling API to search and retrieve pictures
 - Dockerfile for easy server setup
 
-[Unreleased]: https://gitlab.com/panoramax/server/api/-/compare/2.8.0...develop
+[Unreleased]: https://gitlab.com/panoramax/server/api/-/compare/2.9.0...develop
+[2.9.0]: https://gitlab.com/panoramax/server/api/-/compare/2.8.1...2.9.0
+[2.8.1]: https://gitlab.com/panoramax/server/api/-/compare/2.8.0...2.8.1
 [2.8.0]: https://gitlab.com/panoramax/server/api/-/compare/2.7.1...2.8.0
 [2.7.1]: https://gitlab.com/panoramax/server/api/-/compare/2.7.0...2.7.1
 [2.7.0]: https://gitlab.com/panoramax/server/api/-/compare/2.6.0...2.7.0

{geovisio-2.8.0 → geovisio-2.9.0}/PKG-INFO

@@ -1,39 +1,41 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: geovisio
-Version: 2.8.0
+Version: 2.9.0
 Summary: GeoVisio API - Main
 Author-email: Adrien PAVIE <panieravide@riseup.net>, Antoine Desbordes <antoine.desbordes@gmail.com>
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Classifier: License :: OSI Approved :: MIT License
-Requires-Dist: Flask ~= 2.3
-Requires-Dist: psycopg[pool] ~= 3.1
+License-File: LICENSE
+Requires-Dist: Flask ~= 3.1
+Requires-Dist: psycopg[pool] ~= 3.2
 Requires-Dist: flasgger ~= 0.9.7
-Requires-Dist: Pillow ~= 9.4
-Requires-Dist: Flask-Cors ~= 4.0
+Requires-Dist: Pillow ~= 11.1
+Requires-Dist: Flask-Cors ~= 5.0
 Requires-Dist: fs ~= 2.4
-Requires-Dist: fs-s3fs-forked ~= 1.1.3
+Requires-Dist: fs-s3fs-forked ~= 1.1.4
 Requires-Dist: flask-compress ~= 1.14
 Requires-Dist: requests ~= 2.31
-Requires-Dist: yoyo-migrations ~= 8.2
-Requires-Dist: psycopg-binary ~= 3.1
-Requires-Dist: python-dotenv ~= 0.21
-Requires-Dist: authlib ~= 1.2
+Requires-Dist: yoyo-migrations ~= 9.0
+Requires-Dist: psycopg-binary ~= 3.2
+Requires-Dist: python-dotenv ~= 1.1
+Requires-Dist: authlib ~= 1.5
 Requires-Dist: Flask-Executor ~= 1.0
 Requires-Dist: geopic-tag-reader[write-exif] == 1.4.2
 Requires-Dist: rfeed ~= 1.1.1
-Requires-Dist: sentry-sdk[flask] ~= 1.31
-Requires-Dist: pygeofilter[backend-native] ~= 0.2.4
+Requires-Dist: sentry-sdk[flask] ~= 2.24
+Requires-Dist: pygeofilter[backend-native] ~= 0.3.1
 Requires-Dist: python-dateutil ~= 2.9.0
-Requires-Dist: tzdata ~= 2024.1
-Requires-Dist: croniter ~= 2.0.5
-Requires-Dist: pydantic ~= 2.7
+Requires-Dist: tzdata ~= 2025.2
+Requires-Dist: croniter ~= 6.0.0
+Requires-Dist: pydantic ~= 2.11
 Requires-Dist: pydantic-extra-types ~= 2.7
 Requires-Dist: flask-babel ~= 4.0.0
-Requires-Dist: geojson-pydantic ~= 1.1.0
+Requires-Dist: geojson-pydantic ~= 1.2.0
 Requires-Dist: email-validator ~= 2.2.0
+Requires-Dist: multipart>=1.2.1
 Requires-Dist: flit ~= 3.9.0 ; extra == "build"
-Requires-Dist: coverage ~= 6.5 ; extra == "dev"
+Requires-Dist: coverage ~= 7.7 ; extra == "dev"
 Requires-Dist: protobuf ~= 4.21 ; extra == "dev"
 Requires-Dist: mapbox-vector-tile ~= 2.0 ; extra == "dev"
 Requires-Dist: pystac ~= 1.9 ; extra == "dev"
@@ -42,13 +44,13 @@ Requires-Dist: pytest-datafiles ~= 2.0 ; extra == "dev"
 Requires-Dist: pyexiv2 ~= 2.15 ; extra == "dev"
 Requires-Dist: testcontainers ~= 4.1 ; extra == "dev"
 Requires-Dist: requests-mock ~= 1.11 ; extra == "dev"
-Requires-Dist: black ~= 24.1 ; extra == "dev"
-Requires-Dist: pre-commit ~= 3.3 ; extra == "dev"
+Requires-Dist: black ~= 25.1 ; extra == "dev"
+Requires-Dist: pre-commit ~= 4.2 ; extra == "dev"
 Requires-Dist: pyyaml ~= 6.0 ; extra == "dev"
 Requires-Dist: openapi-spec-validator ~= 0.7 ; extra == "dev"
 Requires-Dist: stac-api-validator ~= 0.6.4 ; extra == "dev"
-Requires-Dist: mkdocs-material ~= 9.5.21 ; extra == "docs"
-Requires-Dist: mkdocs-swagger-ui-tag ~= 0.6.10 ; extra == "docs"
+Requires-Dist: mkdocs-material ~= 9.6.9 ; extra == "docs"
+Requires-Dist: mkdocs-swagger-ui-tag ~= 0.6.11 ; extra == "docs"
 Project-URL: Home, https://gitlab.com/panoramax/server/api
 Project-URL: Source Code, https://gitlab.com/panoramax/server/api
 Provides-Extra: build

{geovisio-2.8.0 → geovisio-2.9.0}/docker/docker-compose-full.yml

@@ -59,7 +59,7 @@ services:
       - |
         python3 -m flask user elysee --set-role admin --create
     depends_on:
-      elysee-account-creator:
+      migrations:
         condition: service_completed_successfully
     environment:
       DB_URL: postgres://gvs:gvspwd@db/geovisio

{geovisio-2.8.0 → geovisio-2.9.0}/docker/full-keycloak-auth/docker-compose.yml

@@ -73,7 +73,7 @@ services:
     <<: *geovisio-default
     command: db-upgrade
     environment:
-      DB_URL: postgres://gvs:gvspwd@db/geovisio
+      DB_URL: postgres://gvs:${PG_PASSWORD}@db/geovisio
     depends_on:
       db:
         condition: service_healthy
@@ -94,7 +94,7 @@ services:
       OAUTH_CLIENT_ID: geovisio
       OAUTH_CLIENT_SECRET: ${OAUTH_CLIENT_SECRET}
       OAUTH_OIDC_URL: https://${DOMAIN}/oauth/realms/geovisio
-      DB_URL: postgres://gvs:gvspwd@db/geovisio
+      DB_URL: postgres://gvs:${PG_PASSWORD}@db/geovisio
       FLASK_SECRET_KEY: ${FLASK_SECRET_KEY}
       FLASK_SESSION_COOKIE_DOMAIN: ${DOMAIN:-localhost}
       API_FORCE_AUTH_ON_UPLOAD: True
@@ -103,6 +103,18 @@ services:
       API_BLUR_URL: https://blur.panoramax.openstreetmap.fr
       API_DERIVATES_PICTURES_PUBLIC_URL: /derivates
       API_PERMANENT_PICTURES_PUBLIC_URL: /permanent
+      # API SUMMARY regroup many metadata about the instance
+      # check the documentation on how translations are handled: https://docs.panoramax.fr/api/install/settings/#metadata
+      API_SUMMARY: >-
+        {
+          "color": "#abcdef",
+          "description": {"en": "a long description", "fr": "une description longue"},
+          "logo": "https://gitlab.com/panoramax/gitlab-profile/-/raw/main/images/logo.svg", 
+          "email": "the_administrator@mypanoramax.org",
+          "name": {"en": "${INSTANCE_NAME:-A Panoramax instance}", "fr": "Mon petit serveur des familles"},
+          "geo_coverage": {"en": "Anywhere you like", "fr": "Partout où le vent vous portera"}
+        }
+      API_REGISTRATION_IS_OPEN: True # True if the instance is open to registration, False if not, it is only used in the federation for the moment
       PICTURE_PROCESS_THREADS_LIMIT: 0
       PICTURE_PROCESS_DERIVATES_STRATEGY: PREPROCESS
       FS_URL: /data/geovisio
@@ -125,9 +137,17 @@ services:
   website:
     image: panoramax/website:latest
     environment:
+      # documentation for configuration: https://docs.panoramax.fr/website/03_Settings/
       VITE_INSTANCE_NAME: ${INSTANCE_NAME:-A geovisio instance}
       VITE_API_URL: /
       VITE_TILES: https://panoramax.openstreetmap.fr/pmtiles/basic.json
+      # optional metadata
+      # The title for the <title> tag of the HTML
+      VITE_TITLE: "My Panoramax: The free alternative to photo-mapping territories" 
+      # The title for the meta tags.
+      VITE_META_TITLE: "My Panoramax: The free alternative to photo-mapping territories"
+      # The description for meta tags, which is useful for SEO.
+      VITE_META_DESCRIPTION: "Panoramax is a digital resource for sharing and using field photos. Anyone can take photographs of places visible from public roads and contribute them to the Panoramax database."
     ports:
       - 3000
     networks:
@@ -148,7 +168,7 @@ services:
     restart: always
     environment:
       PICTURE_PROCESS_DERIVATES_STRATEGY: PREPROCESS
-      DB_URL: postgres://gvs:gvspwd@db/geovisio
+      DB_URL: postgres://gvs:${PG_PASSWORD}@db/geovisio
       FS_URL: /data/geovisio
       API_BLUR_URL: https://blur.panoramax.openstreetmap.fr
 
@@ -180,7 +200,7 @@ services:
   db:
     environment:
       POSTGRES_DB: geovisio
-      POSTGRES_PASSWORD: gvspwd
+      POSTGRES_PASSWORD: ${PG_PASSWORD}
       POSTGRES_USER: gvs
     healthcheck:
       test: pg_isready -h db -q -d $$POSTGRES_DB -U $$POSTGRES_USER

{geovisio-2.8.0 → geovisio-2.9.0}/docker/full-keycloak-auth/env.example

@@ -15,6 +15,9 @@ KEYCLOAK_ADMIN_PASSWORD=
 # For production should be provided with a long random string as stated in flask's documentation.
 FLASK_SECRET_KEY=
 
+# Password of the postgres db account
+PG_PASSWORD=
+
 # Directory where to store the pictures
 # Note that this directory must have been created beforehand
 # PICTURES_DIR=./pictures_storage

{geovisio-2.8.0 → geovisio-2.9.0}/docker/full-keycloak-auth/nginx.conf

@@ -52,7 +52,7 @@ http {
 
             # add X-forward- headers for keycloak to know it's canonical host
             # force https
-    	    proxy_set_header X-Forwarded-Scheme https;
+    	    proxy_set_header X-Forwarded-Proto https;
             proxy_set_header X-Forwarded-Host $host;
 
 			proxy_redirect default;

{geovisio-2.8.0 → geovisio-2.9.0}/docker/full-osm-auth/docker-compose.yml

@@ -19,7 +19,7 @@ services:
     <<: *geovisio-default
     command: db-upgrade
     environment:
-      DB_URL: postgres://gvs:gvspwd@db/geovisio
+      DB_URL: postgres://gvs:${PG_PASSWORD}@db/geovisio
     depends_on:
       db:
         condition: service_healthy
@@ -38,7 +38,7 @@ services:
       OAUTH_PROVIDER: osm
       OAUTH_CLIENT_ID: ${OAUTH_CLIENT_ID}
       OAUTH_CLIENT_SECRET: ${OAUTH_CLIENT_SECRET}
-      DB_URL: postgres://gvs:gvspwd@db/geovisio
+      DB_URL: postgres://gvs:${PG_PASSWORD}@db/geovisio
       FLASK_SECRET_KEY: ${FLASK_SECRET_KEY}
       FLASK_SESSION_COOKIE_DOMAIN: ${FLASK_SESSION_COOKIE_DOMAIN:-localhost}
       API_FORCE_AUTH_ON_UPLOAD: True
@@ -52,6 +52,18 @@ services:
       FS_URL: /data/geovisio
       NB_API_THREADS: 10
       INFRA_NB_PROXIES: ${INFRA_NB_PROXIES:-1}
+      # API SUMMARY regroup many metadata about the instance
+      # check the documentation on how translations are handled: https://docs.panoramax.fr/api/install/settings/#metadata
+      API_SUMMARY: >-
+        {
+          "color": "#abcdef",
+          "description": {"en": "a long description", "fr": "une description longue"},
+          "logo": "https://gitlab.com/panoramax/gitlab-profile/-/raw/main/images/logo.svg", 
+          "email": "the_administrator@mypanoramax.org",
+          "name": {"en": "${INSTANCE_NAME:-A Panoramax instance}", "fr": "Mon petit serveur des familles"},
+          "geo_coverage": {"en": "Anywhere you like", "fr": "Partout où le vent vous portera"}
+        }
+      API_REGISTRATION_IS_OPEN: True # True if the instance is open to registration, False if not, it is only used in the federation for the moment
     ports:
       - 5000
     volumes:
@@ -73,6 +85,13 @@ services:
       VITE_INSTANCE_NAME: ${INSTANCE_NAME:-A geovisio instance}
       VITE_API_URL: /
       VITE_TILES: https://panoramax.openstreetmap.fr/pmtiles/basic.json
+       # optional metadata
+      # The title for the <title> tag of the HTML
+      VITE_TITLE: "My Panoramax: The free alternative to photo-mapping territories" 
+      # The title for the meta tags.
+      VITE_META_TITLE: "My Panoramax: The free alternative to photo-mapping territories"
+      # The description for meta tags, which is useful for SEO.
+      VITE_META_DESCRIPTION: "Panoramax is a digital resource for sharing and using field photos. Anyone can take photographs of places visible from public roads and contribute them to the Panoramax database."
     ports:
       - 3000
     networks:
@@ -90,7 +109,7 @@ services:
     restart: always
     environment:
       PICTURE_PROCESS_DERIVATES_STRATEGY: PREPROCESS
-      DB_URL: postgres://gvs:gvspwd@db/geovisio
+      DB_URL: postgres://gvs:${PG_PASSWORD}@db/geovisio
       FS_URL: /data/geovisio
       API_BLUR_URL: https://blur.panoramax.openstreetmap.fr
 
@@ -120,7 +139,7 @@ services:
   db:
     environment:
       POSTGRES_DB: geovisio
-      POSTGRES_PASSWORD: gvspwd
+      POSTGRES_PASSWORD: ${PG_PASSWORD}
       POSTGRES_USER: gvs
     healthcheck:
       test: pg_isready -h db -q -d $$POSTGRES_DB -U $$POSTGRES_USER

{geovisio-2.8.0 → geovisio-2.9.0}/docker/full-osm-auth/env.example

@@ -11,6 +11,9 @@ OAUTH_CLIENT_SECRET=
 # For production should be provided with a long random string as stated in flask's documentation.
 FLASK_SECRET_KEY=
 
+# Password of the postgres db account
+PG_PASSWORD=
+
 # Instance domain, used in cookies
 FLASK_SESSION_COOKIE_DOMAIN=