boxd 0.3.0.dev1003__tar.gz → 0.3.0.dev1040__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.
Files changed (55) hide show
  1. {boxd-0.3.0.dev1003/src/boxd.egg-info → boxd-0.3.0.dev1040}/PKG-INFO +1 -1
  2. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/pyproject.toml +1 -1
  3. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_credentials.py +25 -5
  4. boxd-0.3.0.dev1040/src/boxd/_generated/api_pb2.py +696 -0
  5. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_requests.py +13 -0
  6. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_transport.py +91 -8
  7. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_urls.py +24 -0
  8. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/machines.py +121 -56
  9. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040/src/boxd.egg-info}/PKG-INFO +1 -1
  10. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd.egg-info/SOURCES.txt +2 -0
  11. boxd-0.3.0.dev1040/tests/test_create_in_one_call.py +136 -0
  12. boxd-0.3.0.dev1040/tests/test_raw_key.py +254 -0
  13. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_transport.py +1 -1
  14. boxd-0.3.0.dev1003/src/boxd/_generated/api_pb2.py +0 -696
  15. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/LICENSE +0 -0
  16. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/README.md +0 -0
  17. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/setup.cfg +0 -0
  18. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/__init__.py +0 -0
  19. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_client.py +0 -0
  20. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_generated/__init__.py +0 -0
  21. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_generated/api_pb2_grpc.py +0 -0
  22. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_mappers.py +0 -0
  23. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_regions.py +0 -0
  24. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_streaming.py +0 -0
  25. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/_version_check.py +0 -0
  26. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/errors.py +0 -0
  27. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/models.py +0 -0
  28. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/py.typed +0 -0
  29. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/__init__.py +0 -0
  30. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/account.py +0 -0
  31. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/credentials.py +0 -0
  32. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/disks.py +0 -0
  33. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/domains.py +0 -0
  34. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/fs.py +0 -0
  35. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/orgs.py +0 -0
  36. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/regions.py +0 -0
  37. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/snapshots.py +0 -0
  38. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/teams.py +0 -0
  39. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/resources/vars.py +0 -0
  40. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd/spec.py +0 -0
  41. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd.egg-info/dependency_links.txt +0 -0
  42. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd.egg-info/requires.txt +0 -0
  43. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/src/boxd.egg-info/top_level.txt +0 -0
  44. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_credentials.py +0 -0
  45. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_delete_self.py +0 -0
  46. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_fs.py +0 -0
  47. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_mappers.py +0 -0
  48. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_namespaces.py +0 -0
  49. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_python_versions.py +0 -0
  50. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_regions.py +0 -0
  51. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_requests.py +0 -0
  52. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_spec.py +0 -0
  53. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_streaming.py +0 -0
  54. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_urls.py +0 -0
  55. {boxd-0.3.0.dev1003 → boxd-0.3.0.dev1040}/tests/test_version_check.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: boxd
3
- Version: 0.3.0.dev1003
3
+ Version: 0.3.0.dev1040
4
4
  Summary: Python SDK for the boxd cloud VM platform
5
5
  Author: Azin
6
6
  License-Expression: MIT
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "boxd"
3
- version = "0.3.0.dev1003"
3
+ version = "0.3.0.dev1040"
4
4
  description = "Python SDK for the boxd cloud VM platform"
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -1,13 +1,15 @@
1
- """Credential resolution: explicit token, API-key exchange, or in-VM metadata.
1
+ """Credential resolution: explicit token, API key, or in-VM metadata.
2
2
 
3
- The gRPC API accepts exactly one credential — ``Authorization: Bearer <JWT>``.
4
- A ``bxd_`` key is never sent to :9443. Everything here exists to obtain a JWT
5
- and keep it fresh.
3
+ The gRPC API takes ``Authorization: Bearer <JWT>``, and a ``bxd_`` API key as
4
+ the bearer itself. A key goes as itself over TLS, or to a loopback address
5
+ (:meth:`_CredentialsBase.raw_key`); otherwise, and once a server refuses it as
6
+ one from before raw keys does (the transport's ``_refuses_raw_key``), it is
7
+ exchanged for a JWT that is kept fresh, as every client did before.
6
8
 
7
9
  Resolution order, first match wins:
8
10
 
9
11
  1. explicit ``token`` — used as-is, never refreshed
10
- 2. explicit ``api_key`` — exchanged for a JWT
12
+ 2. explicit ``api_key`` — sent as itself, or exchanged for a JWT
11
13
  3. ``BOXD_TOKEN``, then ``BOXD_API_KEY`` — same handling
12
14
  4. in-VM metadata adapter — no credentials required
13
15
  5. otherwise :class:`AuthenticationError` (reason ``"missing_credentials"``)
@@ -289,6 +291,24 @@ class _CredentialsBase:
289
291
  self._expires_at: float = 0.0
290
292
  # Base URL learned from the metadata adapter (in-VM mode only).
291
293
  self.discovered_base_url: str | None = None
294
+ # A server refused the key itself as an older one does: exchange it
295
+ # from now on, for the life of the client, every endpoint included.
296
+ self._raw_key_refused = False
297
+
298
+ def raw_key(self, *, allowed: bool) -> str | None:
299
+ """The API key, when a call should carry it as the bearer itself.
300
+
301
+ ``allowed`` says the endpoint is reached over TLS or on a loopback
302
+ address. ``None`` means use :meth:`token` (a token, an in-VM
303
+ credential, or the session exchanged for the key).
304
+ """
305
+ if self.mode != "exchange" or not allowed or self._raw_key_refused:
306
+ return None
307
+ return self._api_key
308
+
309
+ def raw_key_refused(self) -> None:
310
+ """A server refused the key itself: exchange it from now on."""
311
+ self._raw_key_refused = True
292
312
 
293
313
  @property
294
314
  def mode(self) -> str: