backo 0.3.4__tar.gz → 0.3.6__tar.gz

backo-0.3.6/.github/workflows/test.yml

@@ -0,0 +1,97 @@
+name: CodeCov
+
+on: [push, pull_request]
+
+jobs:
+  on_main:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: 
+          - "3.12"
+          - "3.13"
+          - "3.14"
+    services:
+      mongodb:
+        image: mongo:latest
+        env:
+          # MONGO_INITDB_ROOT_USERNAME: admin
+          # MONGO_INITDB_ROOT_PASSWORD: admin
+          MONGO_INITDB_DATABASE: testMongo
+        ports:
+          - 27017:27017
+      valkey:
+        image: valkey/valkey:latest
+        ports:
+          - "6379:6379"
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v1
+      with:
+        version: "latest"        
+    
+    - name: Install Python
+      run: uv python install
+
+    - name: Install dependencies
+      run: |
+        sudo apt-get install libmagic1
+        uv sync --all-groups --all-extras
+
+    - name: run tests and coverage
+      run: |
+        uv run coverage run -m unittest tests
+        uv run coverage report -m
+        uv run coverage xml
+  on_branches:
+    if: github.ref != 'refs/heads/main'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: 
+          - "3.14"
+    services:
+      mongodb:
+        image: mongo:latest
+        env:
+          # MONGO_INITDB_ROOT_USERNAME: admin
+          # MONGO_INITDB_ROOT_PASSWORD: admin
+          MONGO_INITDB_DATABASE: testMongo
+        ports:
+          - 27017:27017
+      valkey:
+        image: valkey/valkey:latest
+        ports:
+          - "6379:6379"
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v1
+      with:
+        version: "latest"        
+    
+    - name: Install Python
+      run: uv python install
+
+    - name: Install dependencies
+      run: |
+        sudo apt-get install libmagic1
+        uv sync --all-groups --all-extras
+
+    - name: run tests and coverage
+      run: |
+        uv run coverage run -m unittest tests
+        uv run coverage report -m
+        uv run coverage xml

backo-0.3.4/.github/workflows/test.yml → backo-0.3.6/.github/workflows/test_examples.yml

@@ -1,4 +1,4 @@
-name: CodeCov
+name: TestExamples
 
 on: [push, pull_request]
 
@@ -12,15 +12,9 @@ jobs:
       mongodb:
         image: mongo:latest
         env:
-          # MONGO_INITDB_ROOT_USERNAME: admin
-          # MONGO_INITDB_ROOT_PASSWORD: admin
           MONGO_INITDB_DATABASE: testMongo
         ports:
           - 27017:27017
-      valkey:
-        image: valkey/valkey:latest
-        ports:
-          - "6379:6379"
     steps:
     - uses: actions/checkout@v3
     - name: Set up Python ${{ matrix.python-version }}
@@ -41,8 +35,7 @@ jobs:
         sudo apt-get install libmagic1
         uv sync --all-groups --all-extras
 
-    - name: run tests and coverage
+    - name: Run media library tests
+      working-directory: examples/media_library
       run: |
-        uv run coverage run -m unittest tests
-        uv run coverage report -m
-        uv run coverage xml
+        uv run python -m unittest tests

{backo-0.3.4 → backo-0.3.6}/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.3.6] 2026-09-17
+
+    * Feat
+      * sorting on selection
+      * sorting in Sqlite3DBConnector and DBMongoConnector
+      * sorting in routes with _sort= in the query string
+  
+    * Internal :
+      * Adding FilterReport for evaluation of SFilters into the DB
+      * test refacto for Ref and RefsList
+      * refacto Ref and RefsList
+  
+    * Fix
+      * import __futures__ error on validation parameters
+      * fix bug on selector in Ref and RefsList
+
+## [0.3.5] 2026-09-15
+
+    * fix
+      * DBHandler pagination bug fix
+      * BREAKING CHANGE : New option migration MigrationStrategy (strategy=)
+      * BREAKING CHANGE : Removing option FillStrategy (ofs=) for Ref
+  
+    * Internal :
+      * Pagination during migration
+      * test refacto for Ref and RefsList
+      * refacto Ref and RefsList
+
 ## [0.3.4] 2026-09-04
 
     * fix : total routes bug fix

{backo-0.3.4 → backo-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: backo
-Version: 0.3.4
+Version: 0.3.6
 Summary: Back office low code
 Project-URL: GitHub, https://github.com/backo-stricto/backo
 Project-URL: Homepage, https://github.com/backo-stricto/backo
@@ -41,7 +41,7 @@ Requires-Dist: pyyaml
 Requires-Dist: questionary
 Requires-Dist: redis>=8.1.0
 Requires-Dist: requests
-Requires-Dist: stricto>=0.2.5
+Requires-Dist: stricto>=0.2.6
 Provides-Extra: mongo
 Requires-Dist: pymongo>=4.17.0; extra == 'mongo'
 Description-Content-Type: text/markdown
@@ -878,6 +878,7 @@ Get a list of objects matching the query string. The query string can be with th
 | \_view | string | "client" | selects the view ([stricto views](https://github.com/backo-stricto/stricto?tab=readme-ov-file#views))  |
 | \_page | int | - | sets the desired number of items per page in paginated data presentation |
 | \_skip | int | - | skips the n-first items of the result list in paginated data presentation. |
+| \_sort | string | - | give the list of sorting fields |
 | \_total | whatyouwant | None | Just compute the total of object and return { 'total' : x } without taking pagination in account |
 
 
@@ -893,9 +894,9 @@ The request returns a HTTP status `200` with that JSON object:
 ```
 
 ##### Example
-Select all users whose name includes 'do' and present the result list with 10 items per page.
+Select all users whose name includes 'do' and present the result list with 10 items per page, sorted by surname.
 ```bash
-curl -X GET 'http://localhost/myApp/users/?name.$re=do&_page=10'  
+curl -X GET 'http://localhost/myApp/users/?name.$re=do&_page=10&_sort=$.surname'  
 ```
 
 #### GET \<my-app-name\>/\<collection name\>/\<_id\>/\<path\>
@@ -1479,6 +1480,11 @@ log = log_system.get_or_create_logger("custom")
 log.setLevel(logging.DEBUG)
 log.addHandler ( my_own_handler )
 # ...
+
+# To see
+log_system.infos()
+# print some available informations about log system (levels, handlers)
+
 ```
 
 ### stack()
@@ -1554,7 +1560,7 @@ def transform_function( o: dict) -> dict:
 ```
 
 
-By default, the flag ```dry_run``` is ```True```. so you will broke nothing. ```dry_run``` will do all work except saving the object in the DB.
+By default, the strategy for migration is ```MigrationStrategy.DRY_RUN```. So you will broke nothing. ```MigrationStrategy.DRY_RUN``` will do all work except saving the object in the DB.
 
 > [!IMPORTANT]  
 > there is no check of *rights* and *current_user* during migration. metadatas (see [_meta](#_meta)) are not updated.
@@ -1571,7 +1577,7 @@ This is an example for migrating data.
 
 ```python
 from media_library import mybackoffice
-from backo import log_system, LogLevel
+from backo import log_system, LogLevel, MigrationStrategy
 
 # Set migration level to debug
 log_migration = log_system.get_or_create_logger("migration")
@@ -1611,13 +1617,24 @@ report = mybackoffice.migrate("books", update_with_note)  # All ids
 report = mybackoffice.migrate("books", update_with_note, _id="my_book_id", dry_run=False)
 # or
 report = mybackoffice.migrate(
-    "books", update_with_note, _ids=["my_book_id1", "my_book_id2"], dry_run=False
+    "books", update_with_note, _ids=["my_book_id1", "my_book_id2"], strategy=MigrationStrategy.EXECUTE
 )
 # or
-report = mybackoffice.migrate("books", update_with_note, dry_run=False)  # All ids
+report = mybackoffice.migrate("books", update_with_note, strategy=MigrationStrategy.EXECUTE)  # All ids
 
 ```
 
+### MigrationStrategy options
+
+| option | description |
+| - | - |
+| ```MigrationStrategy.DRY_RUN``` | Don't change anything, just display and report diffs | 
+| ```MigrationStrategy.EXECUTE``` | Do changements and save in DB if needed. report diffs | 
+| ```MigrationStrategy.FORCE``` | Do changements and rewrite data in DB. report diffs | 
+
+
+
+
 ### report
 
 The migration returns a report structure :

{backo-0.3.4 → backo-0.3.6}/README.md

@@ -830,6 +830,7 @@ Get a list of objects matching the query string. The query string can be with th
 | \_view | string | "client" | selects the view ([stricto views](https://github.com/backo-stricto/stricto?tab=readme-ov-file#views))  |
 | \_page | int | - | sets the desired number of items per page in paginated data presentation |
 | \_skip | int | - | skips the n-first items of the result list in paginated data presentation. |
+| \_sort | string | - | give the list of sorting fields |
 | \_total | whatyouwant | None | Just compute the total of object and return { 'total' : x } without taking pagination in account |
 
 
@@ -845,9 +846,9 @@ The request returns a HTTP status `200` with that JSON object:
 ```
 
 ##### Example
-Select all users whose name includes 'do' and present the result list with 10 items per page.
+Select all users whose name includes 'do' and present the result list with 10 items per page, sorted by surname.
 ```bash
-curl -X GET 'http://localhost/myApp/users/?name.$re=do&_page=10'  
+curl -X GET 'http://localhost/myApp/users/?name.$re=do&_page=10&_sort=$.surname'  
 ```
 
 #### GET \<my-app-name\>/\<collection name\>/\<_id\>/\<path\>
@@ -1431,6 +1432,11 @@ log = log_system.get_or_create_logger("custom")
 log.setLevel(logging.DEBUG)
 log.addHandler ( my_own_handler )
 # ...
+
+# To see
+log_system.infos()
+# print some available informations about log system (levels, handlers)
+
 ```
 
 ### stack()
@@ -1506,7 +1512,7 @@ def transform_function( o: dict) -> dict:
 ```
 
 
-By default, the flag ```dry_run``` is ```True```. so you will broke nothing. ```dry_run``` will do all work except saving the object in the DB.
+By default, the strategy for migration is ```MigrationStrategy.DRY_RUN```. So you will broke nothing. ```MigrationStrategy.DRY_RUN``` will do all work except saving the object in the DB.
 
 > [!IMPORTANT]  
 > there is no check of *rights* and *current_user* during migration. metadatas (see [_meta](#_meta)) are not updated.
@@ -1523,7 +1529,7 @@ This is an example for migrating data.
 
 ```python
 from media_library import mybackoffice
-from backo import log_system, LogLevel
+from backo import log_system, LogLevel, MigrationStrategy
 
 # Set migration level to debug
 log_migration = log_system.get_or_create_logger("migration")
@@ -1563,13 +1569,24 @@ report = mybackoffice.migrate("books", update_with_note)  # All ids
 report = mybackoffice.migrate("books", update_with_note, _id="my_book_id", dry_run=False)
 # or
 report = mybackoffice.migrate(
-    "books", update_with_note, _ids=["my_book_id1", "my_book_id2"], dry_run=False
+    "books", update_with_note, _ids=["my_book_id1", "my_book_id2"], strategy=MigrationStrategy.EXECUTE
 )
 # or
-report = mybackoffice.migrate("books", update_with_note, dry_run=False)  # All ids
+report = mybackoffice.migrate("books", update_with_note, strategy=MigrationStrategy.EXECUTE)  # All ids
 
 ```
 
+### MigrationStrategy options
+
+| option | description |
+| - | - |
+| ```MigrationStrategy.DRY_RUN``` | Don't change anything, just display and report diffs | 
+| ```MigrationStrategy.EXECUTE``` | Do changements and save in DB if needed. report diffs | 
+| ```MigrationStrategy.FORCE``` | Do changements and rewrite data in DB. report diffs | 
+
+
+
+
 ### report
 
 The migration returns a report structure :

{backo-0.3.4 → backo-0.3.6}/backo/__init__.py

@@ -20,6 +20,7 @@ from .error import (
     BackoError,
     SessionError,
     FileError,
+    ExpiredError,
 )
 from .backoffice import Backoffice
 from .collection import Collection
@@ -37,7 +38,7 @@ from .file.blob_file import BlobFile
 from .meta_data_handler import GenericMetaDataHandler, StandardMetaDataHandler
 from .status import StatusType
 from .action import Action
-from .migration_report import MigrationReport
+from .migration import MigrationReport, MigrationStrategy
 from .request_decorators import (
     check_content_type,
     return_http_error,
@@ -48,4 +49,5 @@ from .api_toolbox import (
     multidict_to_sfilter,
     dict_to_sfilter,
 )
+from .sort import SortItem, Sort
 from .initialisation.init_script import backo_init

{backo-0.3.4 → backo-0.3.6}/backo/backoffice.py

@@ -15,7 +15,7 @@ from stricto import Kparse, SSyntaxError, validation_parameters
 
 from .collection import Collection
 from .item import Item
-from .migration_report import MigrationReport
+from .migration import MigrationReport, MigrationStrategy
 from .log import log_system
 from .openapi import BACKO_FILTER_SCHEMA, BACKO_META_SCHEMA, JSON_PATCH_SCHEMA
 from .request_decorators import error_to_http_handler
@@ -27,6 +27,7 @@ KPARSE_MIGRATION_MODEL = {
     "_id": str,
     "_ids": list[str],
     "dry_run": {"type": bool, "default": True},
+    "strategy": {"type": MigrationStrategy, "default": MigrationStrategy.DRY_RUN},
 }
 
 
@@ -56,9 +57,9 @@ class Backoffice:  # pylint: disable=too-many-instance-attributes
     def __init__(self, name: str):
         """Constructor for backoffice"""
         self.name = name
-        self.collections = {}
+        self.collections: dict[str, Collection] = {}
         self._transaction_id_reference = 1
-        self.transactions = {}
+        self.transactions: dict[int, list[Transaction]] = {}
 
     @validation_parameters
     def register_collection(self, coll: Collection) -> None:
@@ -169,8 +170,15 @@ class Backoffice:  # pylint: disable=too-many-instance-attributes
         if _ids is None and options.get("_id") is not None:
             _ids = [options.get("_id")]
 
+        strategy: MigrationStrategy = options.get("strategy")
+        if strategy not in MigrationStrategy:
+            raise SSyntaxError(
+                'Migration Strategy "{0}" not found',
+                strategy,
+            )
+
         coll = self.collections.get(collection_name)
-        return coll.migrate(migration_function, _ids, options.get("dry_run"))
+        return coll.migrate(migration_function, _ids, strategy)
 
     @validation_parameters
     def build_routes(