plotwork 0.1.0__tar.gz

plotwork-0.1.0/.gitignore

@@ -0,0 +1,164 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.*
+!.env.example
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+.output
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp directory
+.temp
+
+# Sveltekit cache directory
+.svelte-kit/
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# Firebase cache directory
+.firebase/
+
+# TernJS port file
+.tern-port
+
+# Stores Visual Studio Code versions used for testing Visual Studio Code extensions
+.vscode-test
+
+# pnpm
+.pnpm-store
+
+# yarn v3
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Vite files
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*
+.vite/
+
+# Astro generated types
+.astro/
+
+# Turbo Repo
+.turbo
+
+# SDK build output
+dist/
+dist-packs/
+.claude/state/
+.claude/settings.local.json
+docs/film/out/
+
+# Python
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.venv/
+*.egg-info/

plotwork-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Plotwork
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

plotwork-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.5
+Name: plotwork
+Version: 0.1.0
+Summary: The Plotwork API from Python: validate, draw, render, import and publish diagrams, on the standard library alone.
+Project-URL: Homepage, https://plotwork.dev
+Project-URL: Documentation, https://docs.plotwork.dev/sdks
+Project-URL: Source, https://github.com/plotwork-official/plotwork-sdk
+Project-URL: Issues, https://github.com/plotwork-official/plotwork-sdk/issues
+Author: Plotwork
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api-client,architecture,diagrams,diagrams-as-code,plotwork,svg
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Documentation
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://plotwork.dev">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://plotwork.dev/brand/logo/plotwork-lockup-on-dark.svg">
+      <img alt="Plotwork" src="https://plotwork.dev/brand/logo/plotwork-lockup-on-light.svg" width="240">
+    </picture>
+  </a>
+</p>
+
+# plotwork
+
+<p>
+  <a href="https://pypi.org/project/plotwork/"><img alt="PyPI" src="https://img.shields.io/pypi/v/plotwork?logo=pypi&logoColor=white&color=0f766e"></a>
+  <img alt="Python" src="https://img.shields.io/pypi/pyversions/plotwork?logo=python&logoColor=white&color=0f766e">
+  <a href="https://pypi.org/project/plotwork/#provenance"><img alt="Provenance" src="https://img.shields.io/badge/provenance-attested-0f766e?logo=sigstore&logoColor=white"></a>
+  <img alt="Runtime dependencies" src="https://img.shields.io/badge/runtime%20dependencies-0-0f766e?logo=dependabot&logoColor=white">
+  <img alt="Typed" src="https://img.shields.io/badge/types-generated%20from%20OpenAPI-3776ab?logo=python&logoColor=white">
+</p>
+
+The hosted Plotwork API from Python. Every `/v1` operation (validate, draw, render, import a file, publish, patterns, icons) is a typed method generated from the API's OpenAPI document, sent with `urllib` from the standard library alone. It runs on Python 3.10 and later.
+
+## TL;DR
+
+| Question | Answer |
+|---|---|
+| What does it install? | Nothing else. |
+| Where do the types come from? | The API's OpenAPI document, kept in the SDK repository as [`spec/openapi.json`](https://github.com/plotwork-official/plotwork-sdk/blob/main/spec/openapi.json). Every request and answer is a `TypedDict`. |
+| How do I sign in? | An API key from the Plotwork portal (`api_key`), or an OAuth access token (`access_token`). |
+| Does a mistake in a diagram raise? | No. It is part of the answer, with a line, a column and a hint. Only a failed request raises, as `PlotworkApiError` with a stable `error_code`. |
+| Does it retry? | A safe call is retried twice on 429 and 503, after the API's `Retry-After`. Publishing is never retried. |
+| Is there a TypeScript client? | Yes, [`@plotwork.official/sdk`](https://www.npmjs.com/package/@plotwork.official/sdk), with the same calls in camelCase. |
+
+## Install
+
+```bash
+pip install plotwork
+```
+
+## Use
+
+```python
+import os
+
+from plotwork import Plotwork
+
+plotwork = Plotwork(api_key=os.environ["PLOTWORK_API_KEY"])
+
+source = 'flow "Checkout"\nnode web service "Web tier"\nnode api service "Orders API"\nweb -> api : "places order"\n'
+
+checked = plotwork.diagrams.validate(source=source)
+if not checked["valid"]:
+    for error in checked["errors"]:
+        print(error["line"], error["column"], error["message"], error.get("hint"))
+
+published = plotwork.diagrams.publish(source=source, embedSource=True)
+# A diagram an organisation's policy keeps private has no public link.
+if "url" in published:
+    print(published["url"])
+```
+
+A method takes the request's fields as keyword arguments, named as the API names them (`embedSource`, `documentPath`), and returns the answer as a plain `dict` typed by a `TypedDict`. A body you already have as a `dict` is passed with `**body`. Keep the key in an environment variable or your CI's secret store, never in a file you commit.
+
+| Group | Calls |
+|---|---|
+| `diagrams` | `validate`, `draw`, `render`, `outline`, `read`, `edit`, `compare`, `suggest`, `convert_mermaid`, `publish` |
+| `import_source` | A diagram from Terraform, OpenAPI, SQL, Kubernetes, Compose and the other formats the API reads |
+| `markdown` | `sync`, `plan` |
+| `patterns` | `find`, `get`, `draw`, `check` |
+| `icons` | `search`, `map` |
+| `vocabulary` | The language's statements and limits, for a kind or a topic |
+
+## Errors
+
+```python
+from plotwork import PlotworkApiError
+
+try:
+    plotwork.diagrams.render(source=source)
+except PlotworkApiError as error:
+    print(error.status, error.error_code, error.request_id)
+```
+
+| `error_code` | Means |
+|---|---|
+| `auth.missing`, `auth.invalid_key` | No key, or one the API does not accept |
+| `rate_limit.exceeded` | Too many calls; already retried for a safe call |
+| `http.<status>` | An answer that was not the API's error envelope, such as a proxy's page |
+| `request.timeout`, `request.failed` | No answer came; `status` is 0 |
+
+## Options
+
+| Option | Default |
+|---|---|
+| `api_key` | none |
+| `access_token` | none |
+| `base_url` | `https://api.plotwork.dev` (`https://api-preview.plotwork.dev` for preview, or a self-hosted engine) |
+| `timeout` | `60` seconds |
+| `max_retries` | `2` |
+| `opener` | `urllib.request.build_opener().open`; pass your own for a proxy or a test |
+| `sleep` | `time.sleep`, the wait before a retry |
+
+`plotwork.with_options(timeout=120)` gives a copy with another timeout or number of retries, for a slow call such as a large import.
+
+## See also
+
+| Page | Why |
+|---|---|
+| [SDKs guide](https://docs.plotwork.dev/sdks) | Every Plotwork SDK, and which to choose |
+| [API reference](https://docs.plotwork.dev) | What each operation does |
+| [TypeScript client](https://www.npmjs.com/package/@plotwork.official/sdk) | The same API from TypeScript |
+| [Viewer](https://www.npmjs.com/package/@plotwork.official/viewer) | Show what you publish, interactively, in a web page |
+| [Source](https://github.com/plotwork-official/plotwork-sdk/tree/main/python) | This package, its tests and its generator |

plotwork-0.1.0/README.md

@@ -0,0 +1,112 @@
+<p align="center">
+  <a href="https://plotwork.dev">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://plotwork.dev/brand/logo/plotwork-lockup-on-dark.svg">
+      <img alt="Plotwork" src="https://plotwork.dev/brand/logo/plotwork-lockup-on-light.svg" width="240">
+    </picture>
+  </a>
+</p>
+
+# plotwork
+
+<p>
+  <a href="https://pypi.org/project/plotwork/"><img alt="PyPI" src="https://img.shields.io/pypi/v/plotwork?logo=pypi&logoColor=white&color=0f766e"></a>
+  <img alt="Python" src="https://img.shields.io/pypi/pyversions/plotwork?logo=python&logoColor=white&color=0f766e">
+  <a href="https://pypi.org/project/plotwork/#provenance"><img alt="Provenance" src="https://img.shields.io/badge/provenance-attested-0f766e?logo=sigstore&logoColor=white"></a>
+  <img alt="Runtime dependencies" src="https://img.shields.io/badge/runtime%20dependencies-0-0f766e?logo=dependabot&logoColor=white">
+  <img alt="Typed" src="https://img.shields.io/badge/types-generated%20from%20OpenAPI-3776ab?logo=python&logoColor=white">
+</p>
+
+The hosted Plotwork API from Python. Every `/v1` operation (validate, draw, render, import a file, publish, patterns, icons) is a typed method generated from the API's OpenAPI document, sent with `urllib` from the standard library alone. It runs on Python 3.10 and later.
+
+## TL;DR
+
+| Question | Answer |
+|---|---|
+| What does it install? | Nothing else. |
+| Where do the types come from? | The API's OpenAPI document, kept in the SDK repository as [`spec/openapi.json`](https://github.com/plotwork-official/plotwork-sdk/blob/main/spec/openapi.json). Every request and answer is a `TypedDict`. |
+| How do I sign in? | An API key from the Plotwork portal (`api_key`), or an OAuth access token (`access_token`). |
+| Does a mistake in a diagram raise? | No. It is part of the answer, with a line, a column and a hint. Only a failed request raises, as `PlotworkApiError` with a stable `error_code`. |
+| Does it retry? | A safe call is retried twice on 429 and 503, after the API's `Retry-After`. Publishing is never retried. |
+| Is there a TypeScript client? | Yes, [`@plotwork.official/sdk`](https://www.npmjs.com/package/@plotwork.official/sdk), with the same calls in camelCase. |
+
+## Install
+
+```bash
+pip install plotwork
+```
+
+## Use
+
+```python
+import os
+
+from plotwork import Plotwork
+
+plotwork = Plotwork(api_key=os.environ["PLOTWORK_API_KEY"])
+
+source = 'flow "Checkout"\nnode web service "Web tier"\nnode api service "Orders API"\nweb -> api : "places order"\n'
+
+checked = plotwork.diagrams.validate(source=source)
+if not checked["valid"]:
+    for error in checked["errors"]:
+        print(error["line"], error["column"], error["message"], error.get("hint"))
+
+published = plotwork.diagrams.publish(source=source, embedSource=True)
+# A diagram an organisation's policy keeps private has no public link.
+if "url" in published:
+    print(published["url"])
+```
+
+A method takes the request's fields as keyword arguments, named as the API names them (`embedSource`, `documentPath`), and returns the answer as a plain `dict` typed by a `TypedDict`. A body you already have as a `dict` is passed with `**body`. Keep the key in an environment variable or your CI's secret store, never in a file you commit.
+
+| Group | Calls |
+|---|---|
+| `diagrams` | `validate`, `draw`, `render`, `outline`, `read`, `edit`, `compare`, `suggest`, `convert_mermaid`, `publish` |
+| `import_source` | A diagram from Terraform, OpenAPI, SQL, Kubernetes, Compose and the other formats the API reads |
+| `markdown` | `sync`, `plan` |
+| `patterns` | `find`, `get`, `draw`, `check` |
+| `icons` | `search`, `map` |
+| `vocabulary` | The language's statements and limits, for a kind or a topic |
+
+## Errors
+
+```python
+from plotwork import PlotworkApiError
+
+try:
+    plotwork.diagrams.render(source=source)
+except PlotworkApiError as error:
+    print(error.status, error.error_code, error.request_id)
+```
+
+| `error_code` | Means |
+|---|---|
+| `auth.missing`, `auth.invalid_key` | No key, or one the API does not accept |
+| `rate_limit.exceeded` | Too many calls; already retried for a safe call |
+| `http.<status>` | An answer that was not the API's error envelope, such as a proxy's page |
+| `request.timeout`, `request.failed` | No answer came; `status` is 0 |
+
+## Options
+
+| Option | Default |
+|---|---|
+| `api_key` | none |
+| `access_token` | none |
+| `base_url` | `https://api.plotwork.dev` (`https://api-preview.plotwork.dev` for preview, or a self-hosted engine) |
+| `timeout` | `60` seconds |
+| `max_retries` | `2` |
+| `opener` | `urllib.request.build_opener().open`; pass your own for a proxy or a test |
+| `sleep` | `time.sleep`, the wait before a retry |
+
+`plotwork.with_options(timeout=120)` gives a copy with another timeout or number of retries, for a slow call such as a large import.
+
+## See also
+
+| Page | Why |
+|---|---|
+| [SDKs guide](https://docs.plotwork.dev/sdks) | Every Plotwork SDK, and which to choose |
+| [API reference](https://docs.plotwork.dev) | What each operation does |
+| [TypeScript client](https://www.npmjs.com/package/@plotwork.official/sdk) | The same API from TypeScript |
+| [Viewer](https://www.npmjs.com/package/@plotwork.official/viewer) | Show what you publish, interactively, in a web page |
+| [Source](https://github.com/plotwork-official/plotwork-sdk/tree/main/python) | This package, its tests and its generator |

plotwork-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["hatchling==1.33.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "plotwork"
+version = "0.1.0"
+description = "The Plotwork API from Python: validate, draw, render, import and publish diagrams, on the standard library alone."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Plotwork" }]
+keywords = ["plotwork", "diagrams", "diagrams-as-code", "architecture", "svg", "api-client"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Documentation",
+  "Topic :: Multimedia :: Graphics",
+  "Topic :: Software Development :: Documentation",
+  "Typing :: Typed",
+]
+# No runtime dependencies: scripts/check-no-runtime-dependencies.mjs fails if this list gains a name.
+dependencies = []
+
+[project.urls]
+Homepage = "https://plotwork.dev"
+Documentation = "https://docs.plotwork.dev/sdks"
+Source = "https://github.com/plotwork-official/plotwork-sdk"
+Issues = "https://github.com/plotwork-official/plotwork-sdk/issues"
+
+[dependency-groups]
+# What CI installs: the tests, the build, and a strict type check of the generated types.
+dev = ["pytest==9.2.0", "build==1.6.1", "mypy==2.4.1"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/plotwork"]
+exclude = ["src/plotwork/README.md"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/plotwork", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = "-ra"
+filterwarnings = ["error"]

plotwork-0.1.0/src/plotwork/README.md

@@ -0,0 +1,21 @@
+# Python client source
+
+The typed client for the Plotwork API: one transport on `urllib.request`, and the operations generated from `spec/openapi.json`.
+
+## Standards
+
+Code here follows:
+
+- [API clients](../../../.standards/docs/standards/core/api-clients.md) - one transport, typed errors, a timeout, retries only for calls that are safe to send twice
+- [Dependencies](../../../.standards/docs/standards/core/dependencies.md) - nothing is imported but the standard library
+- [Error handling](../../../.standards/docs/standards/core/error-handling.md) - a diagram's mistakes are data in the answer; only a failed request raises
+
+## Contents
+
+| Path | Purpose |
+|---|---|
+| `__init__.py` | `Plotwork`, the client: the key or token, the base address, `with_options`, and the generated operations on it. |
+| `_request.py` | `Transport`: sends one request, reads the answer, retries 429 and 503 for safe calls, and turns the API's error envelope into `PlotworkApiError`. |
+| `_generated.py` | Every schema as a `TypedDict` and every operation as a typed method, written by `pnpm gen:python`. Never edited by hand; `pnpm check` fails when it is stale. |
+| `_version.py` | `__version__`; a test holds it equal to `pyproject.toml`. |
+| `py.typed` | Tells type checkers the package carries its own types. |

plotwork-0.1.0/src/plotwork/__init__.py

@@ -0,0 +1,90 @@
+"""``plotwork``: the hosted Plotwork API from Python, on the standard library alone.
+
+Every ``/v1`` operation is a typed method generated from ``spec/openapi.json``::
+
+    import os
+    from plotwork import Plotwork
+
+    plotwork = Plotwork(api_key=os.environ["PLOTWORK_API_KEY"])
+    checked = plotwork.diagrams.validate(source=source)
+    published = plotwork.diagrams.publish(source=source, alias="checkout-flow")
+"""
+
+from __future__ import annotations
+
+from typing import Any, Callable, Dict, Optional
+
+from ._generated import OPERATION_PATHS, Operations
+from ._request import Opener, PlotworkApiError, Transport, retry_delay
+from ._version import __version__
+
+__all__ = ["DEFAULT_BASE_URL", "OPERATION_PATHS", "Plotwork", "PlotworkApiError", "Transport", "__version__", "retry_delay"]
+
+#: The production API.
+DEFAULT_BASE_URL = "https://api.plotwork.dev"
+
+_UNSET: Any = object()
+
+
+class Plotwork(Operations):
+    """The Plotwork API client.
+
+    :param api_key: An account or organisation API key, sent as ``X-API-Key``. Keep it in an environment variable or a secret store.
+    :param access_token: An OAuth access token, sent as ``Authorization: Bearer``, in place of a key.
+    :param base_url: The API's address: production by default, ``https://api-preview.plotwork.dev`` for preview, or a self-hosted engine.
+    :param timeout: Seconds before a call counts as failed: 60 by default.
+    :param max_retries: How many times a safe call is tried again on 429 or 503: 2 by default, 0 to never retry.
+    :param opener: Opens each request, called like ``urllib.request.urlopen``; a proxy or a test passes its own.
+    :param sleep: Waits the given seconds before a retry; ``time.sleep`` by default.
+    """
+
+    def __init__(
+        self,
+        *,
+        api_key: Optional[str] = None,
+        access_token: Optional[str] = None,
+        base_url: Optional[str] = None,
+        timeout: float = 60.0,
+        max_retries: int = 2,
+        opener: Optional[Opener] = None,
+        sleep: Optional[Callable[[float], Any]] = None,
+    ) -> None:
+        headers: Dict[str, str] = {}
+        if api_key:
+            headers["X-API-Key"] = api_key
+        if access_token:
+            headers["Authorization"] = f"Bearer {access_token}"
+        self._options: Dict[str, Any] = {
+            "api_key": api_key,
+            "access_token": access_token,
+            "base_url": base_url,
+            "timeout": timeout,
+            "max_retries": max_retries,
+            "opener": opener,
+            "sleep": sleep,
+        }
+        super().__init__(
+            Transport(
+                base_url=base_url or DEFAULT_BASE_URL,
+                headers=headers,
+                timeout=timeout,
+                max_retries=max_retries,
+                opener=opener,
+                sleep=sleep,
+            )
+        )
+
+    def with_options(self, *, timeout: float = _UNSET, max_retries: int = _UNSET) -> "Plotwork":
+        """A copy of this client with another timeout or number of retries, for one call or a few:
+
+        ``plotwork.with_options(timeout=120).import_source(format="terraform", text=text)``
+        """
+        options = dict(self._options)
+        if timeout is not _UNSET:
+            options["timeout"] = timeout
+        if max_retries is not _UNSET:
+            options["max_retries"] = max_retries
+        return Plotwork(**options)
+
+    def __repr__(self) -> str:
+        return f"Plotwork(base_url={self._transport.base_url!r})"