qubrics-sdk 4.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,22 @@
1
+ node_modules/
2
+ .venv/
3
+ .pytest_cache/
4
+ dist/
5
+ .tmp/
6
+ coverage/
7
+ .DS_Store
8
+ *.log
9
+ *.snap
10
+ snapcraft-*.txt
11
+ *.codegen.json
12
+ .codegen/
13
+ .codegraph/
14
+ *.tsbuildinfo
15
+ packages/ts/cli/oclif.manifest.json
16
+ packages/ts/cli/tmp/
17
+ .phpunit.result.cache
18
+ __pycache__/
19
+ *.py[cod]
20
+ vendor/
21
+ .bundle/
22
+ target/
@@ -0,0 +1,130 @@
1
+ # Changelog
2
+
3
+ ## [4.0.0](https://github.com/qubrics/qubrics-sdk/compare/python-sdk-v3.0.1...python-sdk-v4.0.0) (2026-11-21)
4
+
5
+
6
+ ### ⚠ BREAKING CHANGES
7
+
8
+ * **python:** update native package imports
9
+
10
+ ### Features
11
+
12
+ * **python:** update native package imports ([a326bc9](https://github.com/qubrics/qubrics-sdk/commit/a326bc923fff448470d908bb527afaaa35f6d739))
13
+
14
+
15
+ ### Bug Fixes
16
+
17
+ * **management:** prepare calendar-free Python and Ruby 3.0.0 ([1449b51](https://github.com/qubrics/qubrics-sdk/commit/1449b51e1decd1fe6ebb17d203e726363002f0f8))
18
+ * **management:** prepare calendar-free Python and Ruby 3.0.0 ([6b282b0](https://github.com/qubrics/qubrics-sdk/commit/6b282b0049f5fc4c7bdb8dd201e0aabbd34929c0))
19
+ * **python:** prepare Mailbox 3.0.0 on released Sending ([4f699ae](https://github.com/qubrics/qubrics-sdk/commit/4f699ae351825c8e6e61fb4afbe833292168d962))
20
+ * **python:** prepare Sending 2.0.0 native release metadata ([9510177](https://github.com/qubrics/qubrics-sdk/commit/9510177d1cf309262bfa856975e64624c5aecf35))
21
+
22
+
23
+ ### Documentation
24
+
25
+ * use generated SDK method names in examples ([5bb29fc](https://github.com/qubrics/qubrics-sdk/commit/5bb29fc309bae1013da2802210a5b23ccf9dbfd0))
26
+
27
+ ## [3.0.1](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v3.0.0...python-sdk-v3.0.1) (2026-09-21)
28
+
29
+
30
+ ### Bug Fixes
31
+
32
+ * **python-sdk:** raise the mailbox and management floors to 2.0.2 and 2.0.1 ([466f5e4](https://github.com/Sendmux/sendmux-sdk/commit/466f5e44a4d9bfb71c7d5bd0bf0f6a0e7ab5c60c))
33
+
34
+
35
+ ### Documentation
36
+
37
+ * **python-sdk:** drop stale Unreleased changelog block shipped in 3.0.0 ([912dfcf](https://github.com/Sendmux/sendmux-sdk/commit/912dfcf3372df43449fdcd75f5d4ea211ab94754))
38
+
39
+ ## [3.0.0](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v2.0.0...python-sdk-v3.0.0) (2026-09-18)
40
+
41
+
42
+ ### ⚠ BREAKING CHANGES
43
+
44
+ * **python-sdk:** provider lists expose ProviderListItem while details retain ProviderItem with variables. Requires Management 2 and prepares the SDK 3 release; published SDK versions remain immutable.
45
+
46
+ ### Bug Fixes
47
+
48
+ * **python-sdk:** adopt Management 2 and Sending 1.6 producer floors ([d296c8f](https://github.com/Sendmux/sendmux-sdk/commit/d296c8f550e1754b2190b8a5f028c96bff4404b1))
49
+
50
+
51
+ ### Documentation
52
+
53
+ * **python-sdk:** classify raised Sending floor as breaking ([c91c415](https://github.com/Sendmux/sendmux-sdk/commit/c91c415d57845fe7950c057fc93e46ef8b7ccdf3))
54
+
55
+ ## [2.0.0](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v1.2.0...python-sdk-v2.0.0) (2026-09-15)
56
+
57
+
58
+ ### ⚠ BREAKING CHANGES
59
+
60
+ * The `mailbox` module's thread-message lists return `MailboxThreadMessageSummaryCursorListResponse` instead of the ordinary message-list response type, with required `meta.thread_id` and optional typed `meta.sync_state`; ordinary message lists remain thread-independent.
61
+ * Upgrade `sendmux-sdk`, `sendmux-mailbox`, the lockfile, and affected call sites together; restore them together to roll back. See [Version 2.0.0 migration](README.md#version-200-migration).
62
+
63
+
64
+ ### Bug Fixes
65
+
66
+ * align Python SDK mailbox floor ([57c43c4](https://github.com/Sendmux/sendmux-sdk/commit/57c43c47f9adc1d5c16bdc6904b5681794b8ab1f))
67
+ * prepare mailbox SDK major releases ([dc01472](https://github.com/Sendmux/sendmux-sdk/commit/dc014724f7f6eb6b93293e6acbcc1a36c5060ebb))
68
+ * **python-sdk:** require `sendmux-core>=1.3.1,<2.0.0`, `sendmux-mailbox>=2.0.0,<3.0.0`, and `sendmux-sending>=1.5.1,<2.0.0` to adopt the Mailbox 2 response contract and propagate the core exception-mapping fix
69
+
70
+ ## [1.2.0](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v1.1.1...python-sdk-v1.2.0) (2026-09-10)
71
+
72
+
73
+ ### Features
74
+
75
+ * add REST OAuth clients and CLI token lifecycle ([cc4a3aa](https://github.com/Sendmux/sendmux-sdk/commit/cc4a3aa6110378641418a94455ed5b9a986e65ff))
76
+
77
+ ## [1.1.1](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v1.1.0...python-sdk-v1.1.1) (2026-09-08)
78
+
79
+
80
+ ### Bug Fixes
81
+
82
+ * **python-sdk:** require connection-capable components ([#179](https://github.com/Sendmux/sendmux-sdk/issues/179)) ([df3bf12](https://github.com/Sendmux/sendmux-sdk/commit/df3bf12f0dc6ce4e39dd36550d49187e8b9aabfb))
83
+
84
+ ## [1.1.0](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v1.0.4...python-sdk-v1.1.0) (2026-07-01)
85
+
86
+
87
+ ### Features
88
+
89
+ * allow owner-approved agent tokens for sending ([9d1cb7d](https://github.com/Sendmux/sendmux-sdk/commit/9d1cb7df3df5aef1f59a4990dc087178ba3a7b21))
90
+
91
+
92
+ ### Bug Fixes
93
+
94
+ * **python-sdk:** require current component versions ([a77fa59](https://github.com/Sendmux/sendmux-sdk/commit/a77fa59a69fd10bbf014d0ed1f0d7693305b7adb))
95
+ * **python-sdk:** require current component versions ([31d2557](https://github.com/Sendmux/sendmux-sdk/commit/31d255772e5f3e1ba0149c1ca3928b176659edfd))
96
+
97
+ ## [1.0.4](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v1.0.3...python-sdk-v1.0.4) (2026-06-19)
98
+
99
+
100
+ ### Bug Fixes
101
+
102
+ * **python:** add package metadata classifiers ([9a79f5d](https://github.com/Sendmux/sendmux-sdk/commit/9a79f5d118766c5a59fdc9e568f4cf08874f1486))
103
+
104
+ ## [1.0.3](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v1.0.2...python-sdk-v1.0.3) (2026-06-18)
105
+
106
+
107
+ ### Documentation
108
+
109
+ * update Sendmux docs links ([24b89cb](https://github.com/Sendmux/sendmux-sdk/commit/24b89cb851dd8f37dd1304eb292681892bad077d))
110
+
111
+ ## [1.0.2](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v1.0.1...python-sdk-v1.0.2) (2026-06-17)
112
+
113
+
114
+ ### Documentation
115
+
116
+ * expand Python package READMEs ([6d82e19](https://github.com/Sendmux/sendmux-sdk/commit/6d82e1990d5a4efbde7b8107deae58bd99d35b89))
117
+
118
+ ## [1.0.1](https://github.com/Sendmux/sendmux-sdk/compare/python-sdk-v1.0.0...python-sdk-v1.0.1) (2026-06-17)
119
+
120
+
121
+ ### Bug Fixes
122
+
123
+ * **python:** publish dists with supported metadata ([e5506e7](https://github.com/Sendmux/sendmux-sdk/commit/e5506e71410a61a7ddcf547f67f863ff2cfc60d6))
124
+
125
+ ## 1.0.0 (2026-06-01)
126
+
127
+
128
+ ### Features
129
+
130
+ * **python-sdk:** add generated Python packages ([82c4a84](https://github.com/Sendmux/sendmux-sdk/commit/82c4a84976b4d9802f993b07302430546a323543))
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Sendmux
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
@@ -0,0 +1,153 @@
1
+ Metadata-Version: 2.4
2
+ Name: qubrics-sdk
3
+ Version: 4.0.0
4
+ Summary: Umbrella package for the Qubrics Python SDK.
5
+ Project-URL: Repository, https://github.com/qubrics/qubrics-sdk
6
+ License-Expression: MIT
7
+ License-File: LICENSE
8
+ Classifier: License :: OSI Approved :: MIT License
9
+ Classifier: Programming Language :: Python :: 3
10
+ Classifier: Programming Language :: Python :: 3.10
11
+ Classifier: Programming Language :: Python :: 3.11
12
+ Classifier: Programming Language :: Python :: 3.12
13
+ Classifier: Programming Language :: Python :: 3.13
14
+ Requires-Python: >=3.10
15
+ Requires-Dist: qubrics-core<3.0.0,>=2.0.0
16
+ Requires-Dist: qubrics-mailbox<4.0.0,>=3.0.0
17
+ Requires-Dist: qubrics-management<4.0.0,>=3.0.0
18
+ Requires-Dist: qubrics-sending<3.0.0,>=2.0.0
19
+ Description-Content-Type: text/markdown
20
+
21
+ # qubrics-sdk
22
+
23
+ [![PyPI version](https://img.shields.io/pypi/v/qubrics-sdk)](https://pypi.org/project/qubrics-sdk/)
24
+ [![Python versions](https://img.shields.io/pypi/pyversions/qubrics-sdk)](https://pypi.org/project/qubrics-sdk/)
25
+ [![PyPI downloads](https://img.shields.io/pypi/dm/qubrics-sdk)](https://pypi.org/project/qubrics-sdk/)
26
+ [![Licence](https://img.shields.io/pypi/l/qubrics-sdk)](https://github.com/qubrics/qubrics-sdk/blob/main/LICENSE)
27
+
28
+ Optional umbrella package for the Qubrics Python SDK.
29
+
30
+ ## Documentation
31
+
32
+ - Qubrics docs: [qubrics.com/docs](https://qubrics.com/docs)
33
+ - Management API reference: [qubrics.com/docs/api/introduction](https://qubrics.com/docs/api/introduction)
34
+ - Mailbox API reference: [qubrics.com/docs/mailbox-api/introduction](https://qubrics.com/docs/mailbox-api/introduction)
35
+ - Sending API reference: [qubrics.com/docs/sending-api/introduction](https://qubrics.com/docs/sending-api/introduction)
36
+ - Source repository: [qubrics/qubrics-sdk](https://github.com/qubrics/qubrics-sdk)
37
+
38
+ ## Requirements
39
+
40
+ - Python 3.10 or newer.
41
+ - A send-capable `smx_mbx_*` key or owner-approved Sending-resource `smx_agent_*` token for Sending clients.
42
+ - A mailbox-scoped `smx_mbx_*` key or scoped `smx_agent_*` token for Mailbox clients.
43
+ - A root `smx_root_*` key for Management clients.
44
+
45
+ For OAuth, use a REST access token with the scopes and mailbox access required by the operation. See [OAuth for REST APIs](https://qubrics.com/docs/developer-tools/oauth).
46
+
47
+ ## Installation
48
+
49
+ These commands target the Qubrics release of `qubrics-sdk`. Until it is published, install `sendmux-sdk` with its existing import names.
50
+
51
+ ```sh
52
+ pip install qubrics-sdk
53
+ ```
54
+
55
+ ## Connection checks
56
+
57
+ Check a Management credential without creating resources:
58
+
59
+ ```python
60
+ import os
61
+
62
+ from qubrics.sdk import management
63
+
64
+ with management.create_management_client(
65
+ api_key=os.environ["QUBRICS_MANAGEMENT_API_KEY"]
66
+ ) as client:
67
+ connection = management.ConnectionApi(client).management_get_connection()
68
+ print(connection.data.label, connection.data.team.id)
69
+ ```
70
+
71
+ Use `data.label` for the connection name and `data.team.id` for its stable team
72
+ identifier. Each API surface has its own connection operation:
73
+
74
+ | Surface | API class | Method |
75
+ | --- | --- | --- |
76
+ | Management | `management.ConnectionApi` | `management_get_connection()` |
77
+ | Mailbox | `mailbox.MailboxAPIApi` | `mailbox_get_connection()` |
78
+ | Sending | `sending.MetaApi` | `sending_get_connection()` |
79
+
80
+ Create each client with the credential for that surface.
81
+
82
+ ## OAuth access tokens
83
+
84
+ Pass either `api_key` or `access_token`. `access_token` accepts a bare token string or a synchronous callable; the callable is evaluated for each authenticated request. Your application owns token storage, expiry checks and refresh coordination.
85
+
86
+ ```python
87
+ import os
88
+
89
+ from qubrics.sdk import management
90
+
91
+ client = management.create_management_client(
92
+ access_token=lambda: os.environ["QUBRICS_ACCESS_TOKEN"]
93
+ )
94
+ ```
95
+
96
+ ## Usage
97
+
98
+ ```python
99
+ import os
100
+
101
+ from qubrics.sdk import sending
102
+
103
+ client = sending.create_sending_client(api_key=os.environ["QUBRICS_SENDING_API_KEY"])
104
+ api = sending.EmailsApi(client)
105
+
106
+ response = api.sending_send_email(
107
+ sending.EmailSendRequest(
108
+ var_from=sending.Address(email="sender@example.com"),
109
+ to=sending.Address(email="recipient@example.com"),
110
+ subject="Hello from Qubrics",
111
+ html_body="<p>Hello.</p>",
112
+ text_body="Hello.",
113
+ ),
114
+ idempotency_key="email_123",
115
+ )
116
+
117
+ print(response.data.message_id)
118
+ ```
119
+
120
+ The umbrella package lazy-loads:
121
+
122
+ - `core` from `qubrics.core`
123
+ - `sending` from `qubrics.sending`
124
+ - `mailbox` from `qubrics.mailbox`
125
+ - `management` from `qubrics.management`
126
+
127
+ Use the per-surface packages directly when an integration only needs one API surface.
128
+
129
+ ## Provider model migration
130
+
131
+ The `management` module's provider-list responses contain `ProviderListItem` objects instead of `ProviderItem` objects. Detail responses retain `ProviderItem` and require the `variables` map; list items omit that map.
132
+
133
+ To update provider-list callers:
134
+
135
+ 1. Update your requirements to `qubrics-sdk` and regenerate your lockfile. If you pin components directly, update `qubrics-core`, `qubrics-mailbox`, `qubrics-management`, and `qubrics-sending` together.
136
+ 2. Change provider-list annotations and type checks from `management.ProviderItem` to `management.ProviderListItem`. Keep `management.ProviderItem` for detail responses, and include `variables` in detail fixtures (`{}` when none are set).
137
+ 3. Run `python -m pip check` and your provider-list, provider-detail, and sending tests. Confirm list items use `ProviderListItem`, detail fixtures retain their variables, and delivery-group requests serialize the selected group.
138
+
139
+ To roll back, restore the previous SDK and component requirements, lockfile, and affected call sites together.
140
+
141
+ ## Thread message model migration
142
+
143
+ The umbrella's `mailbox` module adopts the thread-specific list response: thread-message results require `meta.thread_id` and expose optional typed `meta.sync_state`, while ordinary message-list results remain thread-independent. Other Mailbox list families expose typed state metadata where applicable.
144
+
145
+ Update `qubrics-sdk`, `qubrics-mailbox`, the lockfile, and affected annotations or fixtures together. To roll back, restore the previous package requirements, lockfile, and call sites together.
146
+
147
+ ## Support
148
+
149
+ Open an issue in [qubrics/qubrics-sdk](https://github.com/qubrics/qubrics-sdk/issues) with the package name, version, and request ID from any API error.
150
+
151
+ ## Licence
152
+
153
+ MIT. See the [licence file](https://github.com/qubrics/qubrics-sdk/blob/main/LICENSE).
@@ -0,0 +1,133 @@
1
+ # qubrics-sdk
2
+
3
+ [![PyPI version](https://img.shields.io/pypi/v/qubrics-sdk)](https://pypi.org/project/qubrics-sdk/)
4
+ [![Python versions](https://img.shields.io/pypi/pyversions/qubrics-sdk)](https://pypi.org/project/qubrics-sdk/)
5
+ [![PyPI downloads](https://img.shields.io/pypi/dm/qubrics-sdk)](https://pypi.org/project/qubrics-sdk/)
6
+ [![Licence](https://img.shields.io/pypi/l/qubrics-sdk)](https://github.com/qubrics/qubrics-sdk/blob/main/LICENSE)
7
+
8
+ Optional umbrella package for the Qubrics Python SDK.
9
+
10
+ ## Documentation
11
+
12
+ - Qubrics docs: [qubrics.com/docs](https://qubrics.com/docs)
13
+ - Management API reference: [qubrics.com/docs/api/introduction](https://qubrics.com/docs/api/introduction)
14
+ - Mailbox API reference: [qubrics.com/docs/mailbox-api/introduction](https://qubrics.com/docs/mailbox-api/introduction)
15
+ - Sending API reference: [qubrics.com/docs/sending-api/introduction](https://qubrics.com/docs/sending-api/introduction)
16
+ - Source repository: [qubrics/qubrics-sdk](https://github.com/qubrics/qubrics-sdk)
17
+
18
+ ## Requirements
19
+
20
+ - Python 3.10 or newer.
21
+ - A send-capable `smx_mbx_*` key or owner-approved Sending-resource `smx_agent_*` token for Sending clients.
22
+ - A mailbox-scoped `smx_mbx_*` key or scoped `smx_agent_*` token for Mailbox clients.
23
+ - A root `smx_root_*` key for Management clients.
24
+
25
+ For OAuth, use a REST access token with the scopes and mailbox access required by the operation. See [OAuth for REST APIs](https://qubrics.com/docs/developer-tools/oauth).
26
+
27
+ ## Installation
28
+
29
+ These commands target the Qubrics release of `qubrics-sdk`. Until it is published, install `sendmux-sdk` with its existing import names.
30
+
31
+ ```sh
32
+ pip install qubrics-sdk
33
+ ```
34
+
35
+ ## Connection checks
36
+
37
+ Check a Management credential without creating resources:
38
+
39
+ ```python
40
+ import os
41
+
42
+ from qubrics.sdk import management
43
+
44
+ with management.create_management_client(
45
+ api_key=os.environ["QUBRICS_MANAGEMENT_API_KEY"]
46
+ ) as client:
47
+ connection = management.ConnectionApi(client).management_get_connection()
48
+ print(connection.data.label, connection.data.team.id)
49
+ ```
50
+
51
+ Use `data.label` for the connection name and `data.team.id` for its stable team
52
+ identifier. Each API surface has its own connection operation:
53
+
54
+ | Surface | API class | Method |
55
+ | --- | --- | --- |
56
+ | Management | `management.ConnectionApi` | `management_get_connection()` |
57
+ | Mailbox | `mailbox.MailboxAPIApi` | `mailbox_get_connection()` |
58
+ | Sending | `sending.MetaApi` | `sending_get_connection()` |
59
+
60
+ Create each client with the credential for that surface.
61
+
62
+ ## OAuth access tokens
63
+
64
+ Pass either `api_key` or `access_token`. `access_token` accepts a bare token string or a synchronous callable; the callable is evaluated for each authenticated request. Your application owns token storage, expiry checks and refresh coordination.
65
+
66
+ ```python
67
+ import os
68
+
69
+ from qubrics.sdk import management
70
+
71
+ client = management.create_management_client(
72
+ access_token=lambda: os.environ["QUBRICS_ACCESS_TOKEN"]
73
+ )
74
+ ```
75
+
76
+ ## Usage
77
+
78
+ ```python
79
+ import os
80
+
81
+ from qubrics.sdk import sending
82
+
83
+ client = sending.create_sending_client(api_key=os.environ["QUBRICS_SENDING_API_KEY"])
84
+ api = sending.EmailsApi(client)
85
+
86
+ response = api.sending_send_email(
87
+ sending.EmailSendRequest(
88
+ var_from=sending.Address(email="sender@example.com"),
89
+ to=sending.Address(email="recipient@example.com"),
90
+ subject="Hello from Qubrics",
91
+ html_body="<p>Hello.</p>",
92
+ text_body="Hello.",
93
+ ),
94
+ idempotency_key="email_123",
95
+ )
96
+
97
+ print(response.data.message_id)
98
+ ```
99
+
100
+ The umbrella package lazy-loads:
101
+
102
+ - `core` from `qubrics.core`
103
+ - `sending` from `qubrics.sending`
104
+ - `mailbox` from `qubrics.mailbox`
105
+ - `management` from `qubrics.management`
106
+
107
+ Use the per-surface packages directly when an integration only needs one API surface.
108
+
109
+ ## Provider model migration
110
+
111
+ The `management` module's provider-list responses contain `ProviderListItem` objects instead of `ProviderItem` objects. Detail responses retain `ProviderItem` and require the `variables` map; list items omit that map.
112
+
113
+ To update provider-list callers:
114
+
115
+ 1. Update your requirements to `qubrics-sdk` and regenerate your lockfile. If you pin components directly, update `qubrics-core`, `qubrics-mailbox`, `qubrics-management`, and `qubrics-sending` together.
116
+ 2. Change provider-list annotations and type checks from `management.ProviderItem` to `management.ProviderListItem`. Keep `management.ProviderItem` for detail responses, and include `variables` in detail fixtures (`{}` when none are set).
117
+ 3. Run `python -m pip check` and your provider-list, provider-detail, and sending tests. Confirm list items use `ProviderListItem`, detail fixtures retain their variables, and delivery-group requests serialize the selected group.
118
+
119
+ To roll back, restore the previous SDK and component requirements, lockfile, and affected call sites together.
120
+
121
+ ## Thread message model migration
122
+
123
+ The umbrella's `mailbox` module adopts the thread-specific list response: thread-message results require `meta.thread_id` and expose optional typed `meta.sync_state`, while ordinary message-list results remain thread-independent. Other Mailbox list families expose typed state metadata where applicable.
124
+
125
+ Update `qubrics-sdk`, `qubrics-mailbox`, the lockfile, and affected annotations or fixtures together. To roll back, restore the previous package requirements, lockfile, and call sites together.
126
+
127
+ ## Support
128
+
129
+ Open an issue in [qubrics/qubrics-sdk](https://github.com/qubrics/qubrics-sdk/issues) with the package name, version, and request ID from any API error.
130
+
131
+ ## Licence
132
+
133
+ MIT. See the [licence file](https://github.com/qubrics/qubrics-sdk/blob/main/LICENSE).
@@ -0,0 +1,35 @@
1
+ [build-system]
2
+ requires = ["hatchling>=1.27"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "qubrics-sdk"
7
+ version = "4.0.0"
8
+ description = "Umbrella package for the Qubrics Python SDK."
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = "MIT"
12
+ classifiers = [
13
+ "License :: OSI Approved :: MIT License",
14
+ "Programming Language :: Python :: 3",
15
+ "Programming Language :: Python :: 3.10",
16
+ "Programming Language :: Python :: 3.11",
17
+ "Programming Language :: Python :: 3.12",
18
+ "Programming Language :: Python :: 3.13",
19
+ ]
20
+ dependencies = [
21
+ "qubrics-core>=2.0.0,<3.0.0",
22
+ "qubrics-mailbox>=3.0.0,<4.0.0",
23
+ "qubrics-management>=3.0.0,<4.0.0",
24
+ "qubrics-sending>=2.0.0,<3.0.0",
25
+ ]
26
+
27
+ [project.urls]
28
+ Repository = "https://github.com/qubrics/qubrics-sdk"
29
+
30
+ [tool.hatch.build.targets.sdist]
31
+ core-metadata-version = "2.4"
32
+
33
+ [tool.hatch.build.targets.wheel]
34
+ core-metadata-version = "2.4"
35
+ packages = ["qubrics"]
@@ -0,0 +1,21 @@
1
+ from __future__ import annotations
2
+
3
+ from importlib import import_module
4
+ from types import ModuleType
5
+
6
+ __all__ = ["core", "mailbox", "management", "sending"]
7
+
8
+ _MODULES = {
9
+ "core": "qubrics.core",
10
+ "mailbox": "qubrics.mailbox",
11
+ "management": "qubrics.management",
12
+ "sending": "qubrics.sending",
13
+ }
14
+
15
+
16
+ def __getattr__(name: str) -> ModuleType:
17
+ if name not in _MODULES:
18
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
19
+ module = import_module(_MODULES[name])
20
+ globals()[name] = module
21
+ return module