0.12.0

0.12.0 introducing following enhancements to client API:

Method for syncing a project sync_project:

client.sync_project("/merginmaps-project-directory")

• This method synchronizes a project by pulling server changes and pushing local changes in a single operation.
• A retry mechanism has been introduced to handle server conflicts during data uploads.
• You no longer need to call client.pull_project() followed by client.push_project(); sync_project handles both.
• A related mergin sync command has been introduced using the same logic.

Integration to new upload mechanism

The Python API client is now fully integrated with the new upload mechanism on supported servers. This mechanism minimizes upload blocking time when multiple clients are uploading data simultaneously.

All changes

• Close connection to make runnable test in new python in GH action by @MarcelGeo in #276
• Upload changes limits by @MarcelGeo in #274
• add support for v2 project response from project versions by @MarcelGeo in #285
• introduce helper to normalize workspace/project roles from strings by @DanChov in #284
• Push v2 integration by @MarcelGeo in #262
• Fix version of black to latest by @MarcelGeo in #286
• Upgrade version to 0.12.0 by @MarcelGeo in #287

Full Changelog: 0.11.0...0.12.0

0.11.0

What's Changed

• Added 502/504 logging by @elderbug0 in #267
• Download and pull project to temp dir by @JanCaha in #259
• Add auth logging by @harminius in #269
• extend 502/504 failure logging by @DanChov in #268
• Move tests to version 3.8 + fix tempdir handling in older python by @MarcelGeo in #271
• import geodiff from deps in client_push by @harminius in #277
• Return OLD server only for 404 resp by @harminius in #278

New Contributors

• @elderbug0 made their first contribution in #267
• @DanChov made their first contribution in #268

Full Changelog: 0.10.5...0.11.0

0.10.5

What's Changed

• Hotfix access token structure by @tomasMizera in #264

0.10.4

What's Changed

• Fix typing notation by @harminius in #263

Full Changelog: 0.10.3...0.10.4

0.10.3

0.10.3 introduces method MerginClient.create_invitation for creating invitations and changes sending diagnostic logs with maximum size 5MB. Complete list of changes:

What's Changed

• increase log size to a maximum 5 mb by @ValentinBuira in #250
• Create invitation method by @harminius in #251
• Add type check when creating a new MerginProject by @constantinneagu in #255
• Fix logs sending by @JanCaha in #258

New Contributors

• @constantinneagu made their first contribution in #255

Full Changelog: 0.10.2...0.10.3

0.10.2

0.10.2 includes enhancements to error handling and authorization of requests.

What's Changed

• Fix error handling _do_request() by @JanCaha in #248
• Explicitly allow creation of MC without auth by @JanCaha in #249

Full Changelog: 0.10.1...0.10.2

0.10.1

Version 0.10.1 introduces Jupyter notebooks examples and some minor code and tests refactoring.

What's Changed

• Fix project_id type by @harminius in #234
• fix creator tests by @MarcelGeo in #236
• Fix tests 2025.4.1 by @MarcelGeo in #239
• allow sending diagnostic logs from client by @JanCaha in #243
• Notebooks examples by @MarcelGeo in #238
• Jupyter notebooks - Update README.md by @alex-cit in #246
• Login sso by @JanCaha in #237
• allow client creation without authorization by @JanCaha in #247

New Contributors

• @alex-cit made their first contribution in #246

Full Changelog: 0.10.0...0.10.1

0.10.0

0.10.0 introduces new methods for workspace and project management to MerginClient

We've implemented enhancements that allow you to directly create users within a workspace, list existing workspace members, modify workspace member details, retrieve a list of project collaborators, and adjust the roles of project collaborators. For instance, user creation can be performed as follows:

   from mergin.common import WorkspaceRole
   from mergin.client import MerginClient

    client = MerginClient(login=<MERGIN_USERNAME>, password=<MERGIN_PASSWORD>)
    user = client.create_user(
           email="staff@company.com",
            password="<SOME STRONG PASSWORD>",
            notify_user=True,
            workspace_id=1,
            workspace_role=WorkspaceRole.READER,
     )

What's Changed

• V2 endpoints for user and access management by @harminius in #231

New Contributors

• @harminius made their first contribution in #231

Full Changelog: 0.9.4...0.10.0

0.9.4

Version 0.9.4 introduces improvements to project version handling and some minor code and tests refactoring.

What's Changed

• Project history : Add functionalities for the version viewer in the QGIS plugin by @ValentinBuira in #222
• Improve error handling by @ValentinBuira in #224
• Remove deprecated check for server compatibility via the list of endpoints by @tomasMizera in #223

New Contributors

• @VitorVieiraZ made their first contribution in #221

Full Changelog: 0.9.3...0.9.4

0.9.3

What's Changed

• Added list-files CLI command for list of project files (#199 by @kaloyan13)
• Upgrade pygeodiff to 2.0.4 (#218 )
• Do not use paginated endpoint for project version detail (#216 )
• Improve client error handling (#209 )
• Bump actions/download-artifact from 2 to 4.1.7 in /.github/workflows (#215 )
• Cleanup references to previous repository name of python-api-client (#217)

New Contributors

• @ValentinBuira made their first contribution in #209
• @kaloyan13 made their first contribution in #199
• @dependabot made their first contribution in #215

Full Changelog: 0.9.2...0.9.3