geovisio 2.5.0__tar.gz → 2.7.0__tar.gz

{geovisio-2.5.0 → geovisio-2.7.0}/.dockerignore

@@ -4,8 +4,11 @@
 !/pyproject.toml
 !/README.md
 !/LICENSE
+!/Makefile
 !/geovisio/**/*.py
 !/geovisio/**/*.html
+!/geovisio/**/*.po
+!/geovisio/**/*.pot
 !/docker/docker-entrypoint.sh
 !/images/*
 !/migrations/*.sql

{geovisio-2.5.0 → geovisio-2.7.0}/.gitignore

@@ -9,3 +9,5 @@ __pycache__
 config.py
 docker/models/
 .vscode/
+site/
+*.mo

{geovisio-2.5.0 → geovisio-2.7.0}/.gitlab-ci.yml

@@ -2,8 +2,9 @@ variables:
   DOCKER_BUILDKIT: 1 # use buildkit for better performance
   DOCKER_DRIVER: overlay2 # better docker driver to avoid copying too many files on each run
   GITLAB_REGISTRY: registry.gitlab.com # We use docker.io for official images and gitlab's registry to store temporary images
-  IMAGE_NAME: geovisio/api
-  CI_IMAGE_CACHE: $GITLAB_REGISTRY/$IMAGE_NAME:build_cache
+  DOCKER_IMAGE_NAME: panoramax/api
+  REPO_NAME: panoramax/server/api
+  CI_IMAGE_CACHE: $GITLAB_REGISTRY/$REPO_NAME:build_cache
   DOCKER_TLS_CERTDIR: ""
 
 # Pipelines will run only for MR, tag and develop/main commits
@@ -18,7 +19,7 @@ code-fmt:
   stage: test
   only:
       - merge_requests
-  image: python:3.9-alpine
+  image: python:3.10-alpine
   script:
     - pip install black
     - black --fast --check .
@@ -34,13 +35,13 @@ test-in-docker:
   image: docker:latest
   services:
       - docker:dind
-      - postgis/postgis:latest
+      - postgis/postgis:15-3.4
   variables:
     POSTGRES_DB: geovisio_test
     POSTGRES_USER: geovisio
     POSTGRES_PASSWORD: geovisiopass
     POSTGRES_HOST_AUTH_METHOD: trust
-    TMP_CI_IMAGE: $GITLAB_REGISTRY/$IMAGE_NAME:$CI_COMMIT_SHORT_SHA
+    TMP_CI_IMAGE: $GITLAB_REGISTRY/$REPO_NAME:$CI_COMMIT_SHORT_SHA
     FF_NETWORK_PER_BUILD: 1 # we ask gitlab to create a custom docker network, to be able to use the services inside the docker
 
 
@@ -77,36 +78,10 @@ test:
       when: never
     - when: on_success
 
-  stage: test
-  image: python:3.9
-  services:
-      - postgis/postgis:latest
-  variables:
-      PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
-      POSTGRES_DB: geovisio_test
-      POSTGRES_USER: geovisio
-      POSTGRES_PASSWORD: geovisiopass
-      POSTGRES_HOST_AUTH_METHOD: trust
-      DB_URL: "postgres://$POSTGRES_USER:$POSTGRES_PASSWORD@postgis-postgis/$POSTGRES_DB"
-      FS_TMP_URL: "/tmp/geovisio_test/tmp/"
-      FS_PERMANENT_URL: "/tmp/geovisio_test/permanent/"
-      FS_DERIVATES_URL: "/tmp/geovisio_test/derivates/"
-  script:
-      - mkdir -p /tmp/geovisio_test/tmp /tmp/geovisio_test/derivates /tmp/geovisio_test/permanent
-      - pip install -e .[dev]
-      - pytest -m "not skipci"
-
-
-test-api-conformance:
-  rules:
-    - if: $CI_COMMIT_TAG
-      when: never
-    - when: on_success
-
   stage: test
   image: python:3.10
   services:
-      - postgis/postgis:latest
+      - postgis/postgis:15-3.4
   variables:
       PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
       POSTGRES_DB: geovisio_test
@@ -118,10 +93,11 @@ test-api-conformance:
       FS_PERMANENT_URL: "/tmp/geovisio_test/permanent/"
       FS_DERIVATES_URL: "/tmp/geovisio_test/derivates/"
   script:
-      - apt update && apt install -y wget jq
+      - apt update && apt install -y gettext
       - mkdir -p /tmp/geovisio_test/tmp /tmp/geovisio_test/derivates /tmp/geovisio_test/permanent
-      - pip install .[dev]
-      - ./tests/test_api_conformance.sh
+      - pip install -e .[dev]
+      - make i18n-po2code
+      - pytest -vv -m "not skipci"
 
 
 publish-develop:
@@ -135,7 +111,7 @@ publish-develop:
   image: docker:latest
   services:
       - docker:dind
-      - postgis/postgis:latest
+      - postgis/postgis:15-3.4
   variables:
       POSTGRES_DB: geovisio_test
       POSTGRES_USER: geovisio
@@ -153,11 +129,9 @@ publish-develop:
     - docker buildx build
       --cache-from "type=registry,ref=$CI_IMAGE_CACHE"
       --cache-to "type=registry,mode=max,ref=$CI_IMAGE_CACHE"
-      --tag "$CI_REGISTRY_IMAGE:develop"
-      --label "org.opencontainers.image.title=$CI_PROJECT_TITLE"
-      --label "org.opencontainers.image.url=$CI_PROJECT_URL"
-      --label "org.opencontainers.image.created=$CI_JOB_STARTED_AT"
-      --label "org.opencontainers.image.revision=$CI_COMMIT_SHORT_SHA"
+      --tag "$DOCKER_IMAGE_NAME:develop"
+      --build-arg GIT_DESCRIBE=$GIT_DESCRIBE
+      --build-arg BUILD_DATE=$CI_JOB_STARTED_AT
       --load
       --progress=plain
       .
@@ -167,11 +141,11 @@ publish-develop:
       --entrypoint "bash"
       --network=host
       --volume ./tests:/opt/geovisio/tests
-      "$CI_REGISTRY_IMAGE:develop"
-      -c 'pip install -e .[dev] && /home/geovisio/.local/bin/pytest -m "not skipci"'
+      "$DOCKER_IMAGE_NAME:develop"
+      -c 'pip install -e .[dev] && /home/geovisio/.local/bin/pytest -vv -m "not skipci"'
 
     # publish image to dockerhub with the develop tag
-    - docker push "$CI_REGISTRY_IMAGE:develop"
+    - docker push "$DOCKER_IMAGE_NAME:develop"
 
 publish-tag-and-latest:
   # we consider that tag always land on main
@@ -182,7 +156,7 @@ publish-tag-and-latest:
   image: docker:latest
   services:
       - docker:dind
-      - postgis/postgis:latest
+      - postgis/postgis:15-3.4
   variables:
       POSTGRES_DB: geovisio_test
       POSTGRES_USER: geovisio
@@ -200,12 +174,10 @@ publish-tag-and-latest:
     - docker buildx build
       --cache-from "type=registry,ref=$CI_IMAGE_CACHE"
       --cache-to "type=registry,mode=max,ref=$CI_IMAGE_CACHE"
-      --tag "$CI_REGISTRY_IMAGE:$CI_COMMIT_REF_NAME"
-      --tag "$CI_REGISTRY_IMAGE:latest"
-      --label "org.opencontainers.image.title=$CI_PROJECT_TITLE"
-      --label "org.opencontainers.image.url=$CI_PROJECT_URL"
-      --label "org.opencontainers.image.created=$CI_JOB_STARTED_AT"
-      --label "org.opencontainers.image.revision=$GIT_DESCRIBE"
+      --tag "$DOCKER_IMAGE_NAME:$CI_COMMIT_REF_NAME"
+      --tag "$DOCKER_IMAGE_NAME:latest"
+      --build-arg GIT_DESCRIBE=$GIT_DESCRIBE
+      --build-arg BUILD_DATE=$CI_JOB_STARTED_AT
       --load
       --progress=plain
       .
@@ -215,18 +187,20 @@ publish-tag-and-latest:
       --entrypoint "bash"
       --network=host
       --volume ./tests:/opt/geovisio/tests
-      "$CI_REGISTRY_IMAGE:latest"
-      -c 'pip install -e .[dev] && ~/.local/bin/pytest -m "not skipci"'
+      "$DOCKER_IMAGE_NAME:latest"
+      -c 'pip install -e .[dev] && ~/.local/bin/pytest -vv -m "not skipci"'
 
     # publish image to dockerhub
-    - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_REF_NAME
-    - docker push $CI_REGISTRY_IMAGE:latest
+    - docker push $DOCKER_IMAGE_NAME:$CI_COMMIT_REF_NAME
+    - docker push $DOCKER_IMAGE_NAME:latest
 
 publish-on-pypi:
   only:
     - tags
   stage: deploy
-  image: python:3.9
+  image: python:3.10
   script:
+    - apt update && apt install -y gettext
     - pip install .[build]
+    - make i18n-po2code
     - flit publish # use [flit](https://flit.pypa.io/) and FLIT_USERNAME/FLIT_PASSWORD env var

{geovisio-2.5.0 → geovisio-2.7.0}/CHANGELOG.md

@@ -5,10 +5,98 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-Before _1.6.0_, [Viewer](https://gitlab.com/geovisio/web-viewer) was embed in this repository, so this changelog also includes Viewer features until the split.
+Before _1.6.0_, [Viewer](https://gitlab.com/panoramax/clients/web-viewer) was embed in this repository, so this changelog also includes Viewer features until the split.
 
 ## [Unreleased]
 
+## [2.7.0] - 2024-10-10
+
+⚠️ The minimal supported Python version is now 3.10. Note that you can run it with newer python versions as some might bring better performance. ⚠
+
+### Added
+
+- The API and picture workers now use connection pool to reduce the load on the database and improve the performances. The connection pool can be configured using `DB_MIN_CNX`/`DB_MAX_CNX`.
+- Add a way to use Gunicorn instead of waitress as WSGI server. Gunicorn can use processes instead of threads, which can result in better performance for high load usage.
+- The ID of the associated accounts are now returned in the STAC response in an `id` field in the `providers` field.
+- Add a whole new way of uploading pictures, using the new `/api/upload_sets` APIs. The pictures added to the uploaded will be dispatched to one or more collection on completion.
+- You can create and manage _Reports_ (issues with pictures or sequences) through `/api/reports` routes. Reports can be created anonymously or by authenticated users, can automatically hide faulty pictures or sequences, and be tracked over time for statistics. **Note** that reports management (beyond creation, which can be done through _web viewer_) is only available through HTTP API as now, no CLI or front-end is offered as now.
+- You can create and manage _Excluded areas_ (areas where people should not upload pictures) through `/api/configuration/excluded_areas` and `/api/users/me/excluded_areas` routes. Excluded areas can be defined for everyone, or by user, for fine management. **Note** that this is only manageable through HTTP API, no CLI or front-end is offered as now.
+- An user account can be marked with an `admin` role in database to enable some features (access to all reports, edit excluded areas).
+- Support of cropped panorama, with new values in `pers:interior_orientation` in picture properties: `visible_area`, `sensor_array_dimensions` following [proposed definition in STAC](https://github.com/stac-extensions/perspective-imagery/issues/10).
+- Routes `/api` and `/api/configuration` return API version in a `geovisio_version` attribute (example: `2.6.0-12-ab12cd34`).
+- Routes returning collections display a `geovisio:upload-software` property showing which client has been used to create the collection (for meta-catalog statistics).
+- handle user agent `GeoVisioCli` and `PanoramaxCli` as the same `cli` software.
+
+### Changed
+
+- Flask session has been set to `permanent`, thus the session cookie will have the lifetime defined by `FLASK_PERMANENT_SESSION_LIFETIME` (default to 7 days).
+- Reject duplicates pictures (same md5). A configuration `API_ACCEPT_DUPLICATE` can make the instance accepts duplicates as before.
+- The background jobs have been changed, it should be transparent for the administrator, but they now rely on the new `job_queue` table, and can handle more types of async jobs.
+- More metadata can be set on API (name, description, logo and main color) in `API_SUMMARY` setting. This is served through `/api/configuration` and `/api` routes for client-side display.
+- Maximum authorized distance between two consecutive pictures in a same segment of a sequence is now 75 meters (distance at 135km/h during two seconds). This only changes map rendering, to avoid sequences cuts over motorways.
+- Sequences and Upload Sets creation now stores `User-Agent` HTTP requests headers.
+- Minimal required PostGIS version is now 3.4 with PostgreSQL 12.
+- Almost all database queries now have a statement timeout (default to 5mn).
+- Updated Geopic Tag Reader to 1.3.0 to solve various issues related to pictures timestamps.
+- In vector tiles style, `interpolate-hcl` expression for grid colouring has been replaced into `interpolate` for broader compatibility with QGIS versions.
+- A new `geovisio:length_km` property is available on `/api/collections/:id`, `/api/users/:id/collection` and `/api/users/me/collection` route, giving the length of sequence in kilometers.
+- ⚠️ The docker images are now `panoramax/api` instead of `geovisio/api`.
+
+### Fixed
+
+- RSS feed was producing invalid viewer links (missing coordinates) since sequences are represented as MultiLineString in database.
+- Fix a bug where we could add pictures to an already deleted sequence.
+- Fix a bug where the `pictures_grid` view was refreshed too frequently (and the computation can be expensive for the database).
+
+### Removed
+
+- The `test-api-conformance.sh` are now regular python tests
+- Removed on-the-fly JPEG to WebP conversion (too slow). WebP might do an unexpected come-back in the future 😉
+- The list of users has been removed from the API entrypoint (`/`) as the list is ever growning, but it can still be accessed through the `/users` endpoint.
+
+## [2.6.0] - 2024-05-17
+
+⚠️ Important Note: This version add several quite long migrations. After the migration are run, you should run as a database administrator:
+
+```sql
+VACUUM FULL pictures, sequences;
+```
+
+or use a tool like [pg_repack](https://github.com/reorg/pg_repack) to remove dead tuples and save lot's of space.
+
+Note that the vacuum will hold an exclusive lock whereas pg_repack will not.
+
+⚠️ Important Note ⚠️ : This new versions uses postgres [`session_replication_role`](https://www.postgresql.org/docs/current/runtime-config-client.html) for non blocking migrations. This means that the users used to connect to the database must either have superuser privilege, or if postgres version is >= 15, you can grant the permission to the user with:
+
+```psql
+GRANT SET ON PARAMETER session_replication_role TO you_user;
+```
+
+### Added
+
+- API routes returning items embed original datetime with timezone information in a new property `datetimetz`.
+- New routes offering [MapLibre Style JSON files](https://maplibre.org/maplibre-style-spec/) for each vector tile endpoint (`/api/map/style.json`, `/api/users/me/map/style.json` and `/api/users/:userId/map/style.json`). This will allow more flexibility in offered vector tiles zoom levels and features against clients. These routes are advertised in API landing page with `xyz-style` and `user-xyz-style` links.
+- A new configuration `DB_CHECK_SCHEMA` to tell GeoVisio not to check the database schema on startup, use only if you know you'll not use GeoVisio before updating its schema.
+- Pictures metadata now embed pitch & roll information (`pers:pitch` and `pers:roll` fields).
+- A new configuration `PICTURE_PROCESS_REFRESH_CRON` tell the background workers when to refresh the database stats (they execute the `flask db refresh` command).
+
+### Changed
+
+- All sequences geometries have been updated to be split if pictures were too far apart (linked to change done in [this MR](https://gitlab.com/panoramax/server/api/-/merge_requests/244)).
+- Vector tiles from zoom 0 to 5 now offers a grid of available pictures (instead of simplified sequences). They are computed on-demand, so you may want to run `flask db refresh` once a day to keep them up-to-date.
+- Doc and links to match the Gitlab organization rename from GeoVisio to Panoramax.
+
+### Fixed
+
+- Migration to change LineString sequence geometry into MultiLinestring was not compatible with older PostGIS version, making Docker image not able to migrate populated sequences tables from 2.4 to 2.5.
+- Route `/api/collections/:cid/geovisio_status` was returning non-empty list of items when no pictures was yet associated to the sequence.
+- Improve `/api/collections/:cid/geovisio_status` performance for big sequences.
+- Improve performance of big sequences deletion in database.
+
+### Removed
+
+- All binary exif fields are removed from the database. This should save quite a lot of database storage.
+
 ## [2.5.0] - 2024-03-07
 
 ### Added
@@ -69,7 +157,7 @@ Before _1.6.0_, [Viewer](https://gitlab.com/geovisio/web-viewer) was embed in th
 
 - Docker container work directory is now `/opt/geovisio`.
 - Docker compose file with blurring is lighter, to for easier maintenance.
-- Update [geo-picture-tag-reader](https://gitlab.com/geovisio/geo-picture-tag-reader) to [1.0.3 version](https://gitlab.com/geovisio/geo-picture-tag-reader/-/tags/1.0.3).
+- Update [geo-picture-tag-reader](https://gitlab.com/panoramax/server/geo-picture-tag-reader) to [1.0.3 version](https://gitlab.com/panoramax/server/geo-picture-tag-reader/-/tags/1.0.3).
 
 ### Removed
 
@@ -111,7 +199,7 @@ Before _1.6.0_, [Viewer](https://gitlab.com/geovisio/web-viewer) was embed in th
 
 ### Changed
 
-- [GeoPic Tag Reader](https://gitlab.com/geovisio/geo-picture-tag-reader) updated to 0.4.1 to embed stronger checks on picture coordinates.
+- [GeoPic Tag Reader](https://gitlab.com/panoramax/server/geo-picture-tag-reader) updated to 0.4.1 to embed stronger checks on picture coordinates.
 
 ### Fixed
 
@@ -133,7 +221,7 @@ Before _1.6.0_, [Viewer](https://gitlab.com/geovisio/web-viewer) was embed in th
 
 ### Changed
 
-- The Docker compose file `docker-compose-full.yml` now embeds [GeoVisio Website](https://gitlab.com/geovisio/website), available on `localhost:3000`.
+- The Docker compose file `docker-compose-full.yml` now embeds [GeoVisio Website](https://gitlab.com/panoramax/server/website), available on `localhost:3000`.
 
 ### Fixed
 
@@ -202,7 +290,7 @@ Before _1.6.0_, [Viewer](https://gitlab.com/geovisio/web-viewer) was embed in th
 ### Added
 
 - Added a `/api/configuration` endpoint with the API configuration. This endpoint is meant to provided easy frontend configuration.
-- Support of Bearer token authorization. This should improve API authentication when a browser is not available, for example in usage with the [CLI](https://gitlab.com/geovisio/cli).
+- Support of Bearer token authorization. This should improve API authentication when a browser is not available, for example in usage with the [CLI](https://gitlab.com/panoramax/clients/cli).
 - The HTTP response header `Access-Control-Expose-Headers` is added to STAC response to allow web browser using the `Location` header.
 - Add API routes to generate a claimable token. By default, it's not associated to any account (created by a `POST` on `/api/auth/tokens/generate`). To be usable, this token needs to be associated to an account via a authenticated call on `/api/auth/tokens/<uuid:token_id>/claim`. This offers a nicer authentication flow on the CLI.
 - Add an API route to revoke a token, a `DELETE` on `/api/users/me/tokens/<uuid:token_id>`
@@ -210,7 +298,7 @@ Before _1.6.0_, [Viewer](https://gitlab.com/geovisio/web-viewer) was embed in th
 ### Changed
 
 - Blur picture is called with a `keep=1` URL query parameter (for a coming migration to [SGBlur](https://github.com/cquest/sgblur)) to keep original unblurred parts on blur API side.
-- [GeoPic Tag Reader](https://gitlab.com/geovisio/geo-picture-tag-reader) updated to 0.1.0 : more EXIF tags are supported for date, heading, GPS coordinates. Also, warnings issued by reader are stored in GeoVisio API database.
+- [GeoPic Tag Reader](https://gitlab.com/panoramax/server/geo-picture-tag-reader) updated to 0.1.0 : more EXIF tags are supported for date, heading, GPS coordinates. Also, warnings issued by reader are stored in GeoVisio API database.
 - All sources have been moved from `./server/src` to `./geovisio` (thanks to [Nick Whitelegg](https://gitlab.com/nickw1)). Thus, sources are now imported as `import geovisio` instead of `import src`.
 
 ### Fixed
@@ -239,8 +327,8 @@ Before _1.6.0_, [Viewer](https://gitlab.com/geovisio/web-viewer) was embed in th
 - Move auth apis from `/auth` to `/api/auth`.
 - Docker image moved to [`geovisio/api`](https://hub.docker.com/r/geovisio/api) (was previously `panieravide/geovisio`)
 - After the OAuth process launched by `/api/auth/login`, we are redirected to the home page
-- Pictures blurring is now **externalized** : GeoVisio API calls a third-party _blurring API_ (which is [available as a part of the whole GeoVisio stack](https://gitlab.com/geovisio/blurring)) instead of relying on internal scripts. This allows more flexible deployments. This changes settings like `BLUR_STRATEGY` which becomes `BLUR_URL`.
-- Reading of EXIF tags from pictures is now done by a separated library called [Geopic Tag Reader](https://gitlab.com/geovisio/geo-picture-tag-reader).
+- Pictures blurring is now **externalized** : GeoVisio API calls a third-party _blurring API_ (which is [available as a part of the whole GeoVisio stack](https://gitlab.com/panoramax/server/blurring)) instead of relying on internal scripts. This allows more flexible deployments. This changes settings like `BLUR_STRATEGY` which becomes `BLUR_URL`.
+- Reading of EXIF tags from pictures is now done by a separated library called [Geopic Tag Reader](https://gitlab.com/panoramax/server/geo-picture-tag-reader).
 - Pictures derivates are now (again) stored in JPEG format. API still can serve images in both JPEG or WebP formats, but with improved performance if using JPEG
 - Thumbnail image is always generated, no matter of `DERIVATES_STRATEGY` value, for better performance on viewer side
 - When picture blurring is enabled, original uploaded image is not stored, only blurred version is kept
@@ -262,15 +350,15 @@ Before _1.6.0_, [Viewer](https://gitlab.com/geovisio/web-viewer) was embed in th
 ### Fixed
 
 - Tests were failing when using PySTAC 1.7.0 due to unavaible `extra_fields['id']` on links
-- EXIF tags filled with blank spaces or similar characters were not handled as null, causing unnecessary errors on pictures processing (issues [#65](https://gitlab.com/geovisio/api/-/issues/65) and [#66](https://gitlab.com/geovisio/api/-/issues/66))
-- Make sure picture EXIF orientation is always used and applied ([#71](https://gitlab.com/geovisio/api/-/issues/71))
+- EXIF tags filled with blank spaces or similar characters were not handled as null, causing unnecessary errors on pictures processing (issues [#65](https://gitlab.com/panoramax/server/api/-/issues/65) and [#66](https://gitlab.com/panoramax/server/api/-/issues/66))
+- Make sure picture EXIF orientation is always used and applied ([#71](https://gitlab.com/panoramax/server/api/-/issues/71))
 - Updates on DB table `pictures` and deletes on DB table `sequences_pictures` now updates `sequences.geom` column automatically
 
 ### Removed
 
-- Removed `SERVER_NAME` from configuration. This parameter was used for url generation, but was causing problems in some cases (cf. [related issue](https://gitlab.com/geovisio/geovisio/-/issues/48))
+- Removed `SERVER_NAME` from configuration. This parameter was used for url generation, but was causing problems in some cases (cf. [related issue](https://gitlab.com/panoramax/server/api/-/issues/48))
 - Removed `BACKEND_MODE` from configuration. This parameter was only used in docker/kubernetes context and can be changed from a environment variable to an argument.
-- Removed the `process-sequences` and `redo-sequences` flask's targets. All pictures upload now pass through the API, and the easiest way to do this is to use [geovisio cli](https://gitlab.com/geovisio/cli).
+- Removed the `process-sequences` and `redo-sequences` flask's targets. All pictures upload now pass through the API, and the easiest way to do this is to use [geovisio cli](https://gitlab.com/panoramax/clients/cli).
 - Removed the `fill-with-mock-data` Flask command
 - Pictures and sequences file paths are removed from database (all storage is based on picture ID)
 
@@ -459,22 +547,24 @@ 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/geovisio/api/-/compare/2.5.0...develop
-[2.5.0]: https://gitlab.com/geovisio/api/-/compare/2.4.0...2.5.0
-[2.4.0]: https://gitlab.com/geovisio/api/-/compare/2.3.1...2.4.0
-[2.3.1]: https://gitlab.com/geovisio/api/-/compare/2.3.0...2.3.1
-[2.3.0]: https://gitlab.com/geovisio/api/-/compare/2.2.0...2.3.0
-[2.2.0]: https://gitlab.com/geovisio/api/-/compare/2.1.1...2.2.0
-[2.1.1]: https://gitlab.com/geovisio/api/-/compare/2.1.0...2.1.1
-[2.1.0]: https://gitlab.com/geovisio/api/-/compare/2.0.2...2.1.0
-[2.0.2]: https://gitlab.com/geovisio/api/-/compare/2.0.1...2.0.2
-[2.0.1]: https://gitlab.com/geovisio/api/-/compare/2.0.0...2.0.1
-[2.0.0]: https://gitlab.com/geovisio/api/-/compare/1.5.0...2.0.0
-[1.5.0]: https://gitlab.com/geovisio/api/-/compare/1.4.1...1.5.0
-[1.4.1]: https://gitlab.com/geovisio/api/-/compare/1.4.0...1.4.1
-[1.4.0]: https://gitlab.com/geovisio/api/-/compare/1.3.1...1.4.0
-[1.3.1]: https://gitlab.com/geovisio/api/-/compare/1.3.0...1.3.1
-[1.3.0]: https://gitlab.com/geovisio/api/-/compare/1.2.0...1.3.0
-[1.2.0]: https://gitlab.com/geovisio/api/-/compare/1.1.0...1.2.0
-[1.1.0]: https://gitlab.com/geovisio/api/-/compare/1.0.0...1.1.0
-[1.0.0]: https://gitlab.com/geovisio/api/-/commits/1.0.0
+[Unreleased]: https://gitlab.com/panoramax/server/api/-/compare/2.7.0...develop
+[2.7.0]: https://gitlab.com/panoramax/server/api/-/compare/2.6.0...2.7.0
+[2.6.0]: https://gitlab.com/panoramax/server/api/-/compare/2.5.0...2.6.0
+[2.5.0]: https://gitlab.com/panoramax/server/api/-/compare/2.4.0...2.5.0
+[2.4.0]: https://gitlab.com/panoramax/server/api/-/compare/2.3.1...2.4.0
+[2.3.1]: https://gitlab.com/panoramax/server/api/-/compare/2.3.0...2.3.1
+[2.3.0]: https://gitlab.com/panoramax/server/api/-/compare/2.2.0...2.3.0
+[2.2.0]: https://gitlab.com/panoramax/server/api/-/compare/2.1.1...2.2.0
+[2.1.1]: https://gitlab.com/panoramax/server/api/-/compare/2.1.0...2.1.1
+[2.1.0]: https://gitlab.com/panoramax/server/api/-/compare/2.0.2...2.1.0
+[2.0.2]: https://gitlab.com/panoramax/server/api/-/compare/2.0.1...2.0.2
+[2.0.1]: https://gitlab.com/panoramax/server/api/-/compare/2.0.0...2.0.1
+[2.0.0]: https://gitlab.com/panoramax/server/api/-/compare/1.5.0...2.0.0
+[1.5.0]: https://gitlab.com/panoramax/server/api/-/compare/1.4.1...1.5.0
+[1.4.1]: https://gitlab.com/panoramax/server/api/-/compare/1.4.0...1.4.1
+[1.4.0]: https://gitlab.com/panoramax/server/api/-/compare/1.3.1...1.4.0
+[1.3.1]: https://gitlab.com/panoramax/server/api/-/compare/1.3.0...1.3.1
+[1.3.0]: https://gitlab.com/panoramax/server/api/-/compare/1.2.0...1.3.0
+[1.2.0]: https://gitlab.com/panoramax/server/api/-/compare/1.1.0...1.2.0
+[1.1.0]: https://gitlab.com/panoramax/server/api/-/compare/1.0.0...1.1.0
+[1.0.0]: https://gitlab.com/panoramax/server/api/-/commits/1.0.0

geovisio-2.7.0/Dockerfile

@@ -0,0 +1,55 @@
+FROM python:3.11-slim
+
+# Stable metadata
+LABEL org.opencontainers.image.title="GeoVisio API"
+LABEL org.opencontainers.image.description="Panoramax is a digital resource for sharing and using field photos. GeoVisio API is the backend part of the ecosystem."
+LABEL org.opencontainers.image.authors="Adrien PAVIE <panieravide@riseup.net>"
+LABEL org.opencontainers.image.source="https://gitlab.com/panoramax/server/api.git"
+LABEL org.opencontainers.image.documentation="https://docs.panoramax.fr/api/"
+LABEL org.opencontainers.image.vendor="Panoramax"
+LABEL org.opencontainers.image.licenses="MIT"
+LABEL org.opencontainers.image.url="https://panoramax.fr/"
+
+# Install system dependencies
+# and create a `geovisio` user, to run the app as non root user
+RUN apt update \
+    && apt install -y git gettext make \
+    && pip install waitress gunicorn Babel \
+    && rm -rf /var/lib/apt/lists/* \
+    && mkdir -p /opt/geovisio /data/geovisio \
+    && groupadd --gid 1000 geovisio \
+    && useradd --uid 1000 --gid 1000 -m geovisio \
+    && chown -R geovisio:geovisio /opt/geovisio /data/geovisio
+
+WORKDIR /opt/geovisio
+USER geovisio
+
+# Install Python dependencies
+COPY ./README.md ./LICENSE ./pyproject.toml ./
+COPY ./geovisio/__init__.py ./geovisio/
+RUN pip install -e . --user
+
+# Add source files
+COPY ./images ./images/
+COPY ./docker/docker-entrypoint.sh ./
+COPY ./geovisio ./geovisio
+COPY ./migrations ./migrations
+COPY ./Makefile ./
+
+# Generate i18n compiled files
+USER root
+RUN make i18n-po2code
+USER geovisio
+
+# Retrieve build metadata
+ARG GIT_DESCRIBE
+LABEL org.opencontainers.image.revision=$GIT_DESCRIBE
+
+# Environment variables
+ENV FLASK_APP=geovisio
+ENV FS_URL="/data/geovisio"
+ENV API_GIT_VERSION=$GIT_DESCRIBE
+
+# Expose service
+EXPOSE 5000
+ENTRYPOINT ["./docker-entrypoint.sh"]

geovisio-2.7.0/Makefile

@@ -0,0 +1,35 @@
+.DEFAULT_GOAL := help
+
+.PHONY: run-all-compose
+
+run-all-compose:  ## Run all services with docker compose
+	docker-compose -f docker/docker-compose-full.yml up
+
+fmt:	## Run code formatting
+	black .
+
+generate-swagger:  ## Generate swagger documentation
+	FS_URL=/tmp flask -e test.env generate-api-schema > docs/api/open_api.json
+
+generate-doc: generate-swagger ## Generate mkdocs documentation
+	mkdocs build --strict
+
+serve-doc: generate-swagger ## Serve mkdocs documentation
+	mkdocs serve
+
+help: ## Print this help message
+	@grep -E '^[a-zA-Z_-]+:.*## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
+
+i18n-code2pot:
+	pybabel extract -F babel.cfg -o geovisio/translations/messages.pot geovisio/
+	msginit --locale=en --no-translator --input=geovisio/translations/messages.pot --output=geovisio/translations/en/LC_MESSAGES/messages.po
+
+i18n-po2code:
+	pybabel compile -d geovisio/translations/
+
+build-docker:
+	docker buildx build \
+		--build-arg GIT_DESCRIBE=`git describe` \
+		--label=org.opencontainers.image.created=`date -u +'%Y-%m-%dT%H:%M:%SZ'` \
+		--label=org.opencontainers.image.version=`cat geovisio/__init__.py | grep -e '^__version__' | cut -d \" -f 2` \
+		-t panoramax/api:develop .

geovisio-2.7.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.1
+Name: geovisio
+Version: 2.7.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
+Requires-Dist: flasgger ~= 0.9.7
+Requires-Dist: Pillow ~= 9.4
+Requires-Dist: Flask-Cors ~= 4.0
+Requires-Dist: fs ~= 2.4
+Requires-Dist: fs-s3fs-forked ~= 1.1.3
+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: Flask-Executor ~= 1.0
+Requires-Dist: geopic-tag-reader[write-exif] == 1.3.1
+Requires-Dist: rfeed ~= 1.1.1
+Requires-Dist: sentry-sdk[flask] ~= 1.31
+Requires-Dist: pygeofilter[backend-native] ~= 0.2.4
+Requires-Dist: python-dateutil ~= 2.8.2
+Requires-Dist: tzdata ~= 2024.1
+Requires-Dist: croniter ~= 2.0.5
+Requires-Dist: pydantic ~= 2.7
+Requires-Dist: pydantic-extra-types ~= 2.7
+Requires-Dist: flask-babel ~= 4.0.0
+Requires-Dist: geojson-pydantic ~= 1.1.0
+Requires-Dist: flit ~= 3.9.0 ; extra == "build"
+Requires-Dist: coverage ~= 6.5 ; 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"
+Requires-Dist: pytest ~= 8.3 ; extra == "dev"
+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: pyyaml ~= 6.0 ; extra == "dev"
+Requires-Dist: openapi-spec-validator ~= 0.7 ; extra == "dev"
+Requires-Dist: stac-api-validator ~= 0.6.3 ; extra == "dev"
+Requires-Dist: mkdocs-material ~= 9.5.21 ; extra == "docs"
+Requires-Dist: mkdocs-swagger-ui-tag ~= 0.6.10 ; extra == "docs"
+Project-URL: Home, https://gitlab.com/panoramax/server/api
+Project-URL: Source Code, https://gitlab.com/panoramax/server/api
+Provides-Extra: build
+Provides-Extra: dev
+Provides-Extra: docs
+
+# ![Panoramax](https://upload.wikimedia.org/wikipedia/commons/thumb/a/a9/Panoramax.svg/40px-Panoramax.svg.png) Panoramax
+
+__Panoramax__ is a digital resource for sharing and using 📍📷 field photos. Anyone can take photographs of places visible from the public streets and contribute them to the Panoramax database. This data is then freely accessible and reusable by all. More information available at [gitlab.com/panoramax](https://gitlab.com/panoramax) and [panoramax.fr](https://panoramax.fr/).
+
+
+# 🌐 Panoramax API
+
+This repository only contains __the backend and web API__ of a Panoramax instance.
+
+## Features
+
+* A __web API__ to search and upload pictures collections
+  * Search pictures by ID, date, location
+  * Compatible with [SpatioTemporal Asset Catalog](https://stacspec.org/) and [OGC WFS 3](https://github.com/opengeospatial/WFS_FES) specifications
+  * Upload your pictures and sequences
+* An easy-to-use __backend__
+  * Generates automatically thumbnail, small and tiled versions of your pictures
+  * Compatible with various filesystems (classic, S3, FTP...)
+  * Authentication and blurring API can be plugged-in for production-ready use
+
+
+## Install & run
+
+Our [documentation](https://gitlab.com/panoramax/server/api/-/tree/develop/docs) will help you install, configure and run a Panoramax instance.
+
+If at some point you're lost or need help, you can contact us through [issues](https://gitlab.com/panoramax/server/api/-/issues) or by [email](mailto:panieravide@riseup.net).
+
+
+## Contributing
+
+Pull requests are welcome. For major changes, please open an [issue](https://gitlab.com/panoramax/server/api/-/issues) first to discuss what you would like to change.
+
+More information about developing is available in [documentation](https://gitlab.com/panoramax/server/api/-/tree/develop/docs).
+
+
+## ⚖️ License
+
+Copyright (c) Panoramax team 2022-2024, [released under MIT license](https://gitlab.com/panoramax/server/api/-/blob/develop/LICENSE).
+

geovisio-2.7.0/Procfile

@@ -0,0 +1,7 @@
+web: bin/run_production_api.sh
+
+# After having poped the API, we upgrade the database schema
+# If the postdeploy fails, scalingo will not expose the new app, and will keep the old one
+# Note that we added DB_CHECK_SCHEMA=false on the `web` to ensure that it starts without checking the schema (since it will be updated after)
+# Note2: scalingo has a 20mn timeout for this, so migration longer will need to be applied manually
+postdeploy: flask db upgrade