Merge upstream Scille/umongo main branch (901 commits)

.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+- package-ecosystem: pip
+  directory: "/"
+  schedule:
+    interval: monthly
+  open-pull-requests-limit: 10
+- package-ecosystem: "github-actions"
+  directory: "/"
+  schedule:
+    interval: monthly

.github/workflows/build-release.yml

@@ -0,0 +1,98 @@
+name: build
+on:
+  push:
+    branches: ["main"]
+    tags: ["*"]
+  pull_request:
+
+jobs:
+  docs:
+    name: docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - run: pip install tox
+      - run: tox -e docs
+  tests:
+    name: ${{ matrix.name }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { name: "3.10-pymongo3", python: "3.10", tox: py310-pymongo3 }
+          - { name: "3.13-pymongo4", python: "3.13", tox: py313-pymongo4 }
+          - { name: "3.10-motor", python: "3.10", tox: py310-motor }
+          - { name: "3.13-motor", python: "3.13", tox: py313-motor }
+          - { name: "3.10-txmongo", python: "3.10", tox: py310-txmongo }
+          - { name: "3.13-txmongo", python: "3.13", tox: py313-txmongo }
+    steps:
+      - uses: actions/checkout@v6
+      - name: Start MongoDB
+        uses: supercharge/mongodb-github-action@1.12.1
+        with:
+          mongodb-version: 8.0
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python }}
+          allow-prereleases: true
+      - run: python -m pip install tox
+      - run: python -m tox -e ${{ matrix.tox }}
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - name: Install pypa/build
+        run: python -m pip install build
+      - name: Build a binary wheel and a source tarball
+        run: python -m build
+      - name: Install twine
+        run: python -m pip install twine
+      - name: Check build
+        run: python -m twine check --strict dist/*
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+  # this duplicates pre-commit.ci, so only run it on tags
+  # it guarantees that linting is passing prior to a release
+  lint-pre-release:
+    if: startsWith(github.ref, 'refs/tags')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - run: python -m pip install tox
+      - run: python -m tox -e lint
+  publish-to-pypi:
+    name: PyPI release
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [lint-pre-release, build, tests]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/umongo
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.pre-commit-config.yaml

@@ -0,0 +1,13 @@
+ci:
+  autoupdate_schedule: monthly
+repos:
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.14.7
+  hooks:
+    - id: ruff-check
+    - id: ruff-format
+- repo: https://github.com/python-jsonschema/check-jsonschema
+  rev: 0.35.0
+  hooks:
+    - id: check-github-workflows
+    - id: check-readthedocs

.readthedocs.yml

@@ -0,0 +1,15 @@
+version: 2
+sphinx:
+  configuration: docs/conf.py
+formats:
+  - pdf
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.13"
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

AUTHORS.rst

@@ -26,3 +26,4 @@ Contributors
 * Attila Kóbor `@atti92 <https://github.com/atti92>`_
 * Denis Moskalets `@denya <https://github.com/denya>`_
 * Phil Chiu `@whophil <https://github.com/whophil>`_
+* sanju sci `@sanjusci <https://github.com/sanjusci>`_

HISTORY.rst → CHANGELOG.rst

@@ -1,6 +1,50 @@
-=======
-History
-=======
+=========
+Changelog
+=========
+
+4.0.0b4 (2025-10-07)
+--------------------
+
+Features:
+
+* *Backwards-incompatible*: ``find_one`` methods don't accept ``*args`` anymore (#411).
+
+4.0.0b3 (2025-10-02)
+--------------------
+
+Other:
+
+* Drop marshmallow 3 (#408)
+
+4.0.0b2 (2025-09-22)
+--------------------
+
+Other:
+
+* Drop motor 2 (#406)
+* Require Python 3.10 (#406)
+
+4.0.0b1 (2025-09-21)
+--------------------
+
+Features:
+
+* Support pymongo 4 (#392)
+* Support motor 3 (#392)
+* Support marshmallow 4 (#400)
+* *Backwards-incompatible*: ``missing`` and ``default`` attributes are no longer
+  used in umongo fields, only ``dump_default`` and ``load_default`` are used.
+  ``marshmallow_load_default`` and ``marshmallow_dump_default`` attributes may
+  be used to overwrite the values to use in the pure marshmallow field returned
+  by ``as_marshmallow_field`` method. (#392)
+
+Other:
+
+* *Backwards-incompatible*: Remove ``__version__``, ``__author__`` and
+  ``__email__`` from umongo.__init__.py (#395).
+* Require marshmallow >=3.26 (#401)
+* Support Python up to 3.13 (#392)
+* Drop Python 3.7 and 3.8 (#393)
 
 3.1.0 (2021-12-23)
 ------------------

CONTRIBUTING.rst

@@ -60,6 +60,7 @@ Get Started!
 Ready to contribute? Here's how to set up `umongo` for local development.
 
 1. Fork the `umongo` repo on GitHub.
+
 2. Clone your fork locally::
 
     $ git clone git@github.com:your_name_here/umongo.git
@@ -68,51 +69,30 @@ Ready to contribute? Here's how to set up `umongo` for local development.
 
     $ mkvirtualenv umongo
     $ cd umongo/
-    $ python setup.py develop
+    $ pip install -e .[dev]
 
-4. Create a branch for local development::
+4. Install the pre-commit hooks, which will format and lint your git staged files::
 
-    $ git checkout -b name-of-your-bugfix-or-feature
+    $ pre-commit install
 
-   Now you can make your changes locally.
+5. Create a branch for local development::
 
-5. When you're done making changes, check that your changes pass flake8 and the tests, including testing other Python versions with tox::
+    $ git checkout -b name-of-your-bugfix-or-feature
 
-    $ flake8 umongo
-    $ py.test tests
-    $ tox
+   Now you can make your changes locally. Please add necessary feature or non-regression tests.
 
-   To get flake8, pytest and tox, just pip install them into your virtualenv.
+5. When you're done making changes, check that your changes pass tests::
 
-.. note:: You need pytest>=2.8
+    $ pytest
 
 6. Commit your changes and push your branch to GitHub::
 
     $ git add .
-    $ git commit -m "Your detailed description of your changes."
-    $ git push origin name-of-your-bugfix-or-feature
+    $ git commit -m "Detailed description of your changes."
+    $ git push -u origin name-of-your-bugfix-or-feature
 
 7. Submit a pull request through the GitHub website.
 
-I18n
-----
-
-There are additional steps to make changes involving translated strings.
-
-1. Extract translatable strings from the code into messages.pot::
-
-    $ make extract_messages
-
-2. Update flask example translation files::
-
-    $ make update_flask_example_messages
-
-3. Update/fix translations
-
-4. Compile new binary translation files::
-
-    $ make compile_flask_example_messages
-
 Pull Request Guidelines
 -----------------------
 
@@ -122,6 +102,3 @@ Before you submit a pull request, check that it meets these guidelines:
 2. If the pull request adds functionality, the docs should be updated. Put
    your new functionality into a function with a docstring, and add the
    feature to the list in README.rst.
-3. The pull request should work for Python 3.7 and 3.8. Check
-   https://travis-ci.org/touilleMan/umongo/pull_requests
-   and make sure that the tests pass for all supported Python versions.