bluecore-graph-toolbox 2.0.0__tar.gz

bluecore_graph_toolbox-2.0.0/.gitignore

@@ -0,0 +1,3 @@
+*__pycache__*
+
+*swp

bluecore_graph_toolbox-2.0.0/LICENSE-2.0.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

bluecore_graph_toolbox-2.0.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.5
+Name: bluecore-graph-toolbox
+Version: 2.0.0
+Summary: Airflow Plugin for Blue Core Toolbox
+Project-URL: Homepage, https://github.com/blue-core-lod/graph-toolbox
+Project-URL: Issues, https://github.com/blue-core-lod/graph-toolbox/issues
+License-Expression: Apache-2.0
+License-File: LICENSE-2.0.txt
+Keywords: airflow,airflow-plugin,bibframe,blue-core,rdf
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Apache Airflow
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: ==3.12.*
+Requires-Dist: apache-airflow<4,>=3.2.0
+Requires-Dist: bluecore-airflow-common>=0.1.0
+Requires-Dist: jinja2>=3.1.6
+Description-Content-Type: text/markdown
+
+# Blue Core Graph Toolbox
+Web Application for loading and manipulating [Blue Core](https://bcld.info) RDF. 
+
+The Toolbox is being rebuilt as an [Airflow 3 plugin](#running-as-an-airflow-plugin)
+that runs inside Blue Core Workflows. Until its screens are moved over, the
+original PyScript site lives alongside it in this repo.
+
+Through [Pyscript](https://pyscript.net/), the [rdflib](https://rdflib.readthedocs.io/en/stable/) Python package is used 
+for loading RDF through Blue Core.
+
+## Existing and Planned Functionality
+- Run SPARQL queries on one or more Blue Core Resources
+- Download RDF in various serializations like Turtle, XML/RDF, and json-ld
+- Chat with Blue Core AI Agents
+- Import and convert MARC to Blue Core BIBFRAME Resources
+- Export Blue Core Constrained Bound Descriptions (CBD) to 
+  MARC21 records
+
+## Running as an Airflow plugin
+
+The `bluecore_graph_toolbox` package registers itself with Airflow through the
+`airflow.plugins` entry point, so installing it into the Airflow environment is
+all that's needed; nothing goes in the plugins folder. Shared helpers, the base
+template and styles come from
+[bluecore-airflow-common](https://github.com/blue-core-lod/bluecore-airflow-common).
+
+Requires Python 3.12 and Airflow 3.2 or later (tested against 3.3.2).
+
+Releases are published to PyPI as
+[bluecore-graph-toolbox](https://pypi.org/p/bluecore-graph-toolbox)
+
+```sh
+uv build
+uv add bluecore-graph-toolbox
+```
+
+In [bluecore-workflows](https://github.com/blue-core-lod/bluecore-workflows),
+add the pin to `dependencies` in its `pyproject.toml` and run `uv lock`; the
+Docker image installs it from the lockfile, so no wheel is copied in. When a
+new Toolbox release adds screens or API routes, bump that pin and `uv lock`
+again in a Workflows pull request.
+
+Once installed, a Toolbox item appears in the Airflow navigation. The UI
+shows it in an iframe at `/plugin/graph-toolbox`; the app itself is mounted at
+`/graph-toolbox`:
+
+| Route | Sign-in | Purpose |
+|---|---|---|
+| `GET /graph-toolbox/` | required | Landing page |
+| `GET /graph-toolbox/health` | none | `{"status", "version"}` |
+| `/graph-toolbox/static/…` | none | Toolbox and shared Blue Core assets |
+
+Sign-in is Airflow's own: the page uses Airflow's JWT cookie (Keycloak in a
+Blue Core stack), and the Toolbox has no login of its own.
+
+All URLs follow [api] base_url, so the same build works with Airflow at the
+root or proxied under a path such as /workflows
+(AIRFLOW__API__BASE_URL=`http://localhost/workflows`), where the routes above
+become `/workflows/graph-toolbox/…`.
+
+## Development
+
+```sh
+uv sync
+uv run ruff check src/bluecore_graph_toolbox tests
+uv run pytest
+```
+
+## Releasing
+
+Releases go to PyPI from
+[`.github/workflows/python-publish.yml`](.github/workflows/python-publish.yml)
+using [trusted publishing](https://docs.pypi.org/trusted-publishers/), so no
+API token is stored in the repo.
+
+1. Bump `version` in `pyproject.toml` (`uv version --bump minor`, say) and
+   merge it to `main`.
+2. Create a GitHub release whose tag is `v` plus that version, e.g. `v2.1.0`.
+3. Publishing the release runs the workflow: it checks the tag against
+   `pyproject.toml`, runs the tests, builds the wheel and sdist, checks that the
+   wheel installs as an Airflow plugin, and uploads both to PyPI. Approve the
+   `pypi` environment deployment if it asks.
+4. Bump the pin in bluecore-workflows as described above.

bluecore_graph_toolbox-2.0.0/README.md

@@ -0,0 +1,83 @@
+# Blue Core Graph Toolbox
+Web Application for loading and manipulating [Blue Core](https://bcld.info) RDF. 
+
+The Toolbox is being rebuilt as an [Airflow 3 plugin](#running-as-an-airflow-plugin)
+that runs inside Blue Core Workflows. Until its screens are moved over, the
+original PyScript site lives alongside it in this repo.
+
+Through [Pyscript](https://pyscript.net/), the [rdflib](https://rdflib.readthedocs.io/en/stable/) Python package is used 
+for loading RDF through Blue Core.
+
+## Existing and Planned Functionality
+- Run SPARQL queries on one or more Blue Core Resources
+- Download RDF in various serializations like Turtle, XML/RDF, and json-ld
+- Chat with Blue Core AI Agents
+- Import and convert MARC to Blue Core BIBFRAME Resources
+- Export Blue Core Constrained Bound Descriptions (CBD) to 
+  MARC21 records
+
+## Running as an Airflow plugin
+
+The `bluecore_graph_toolbox` package registers itself with Airflow through the
+`airflow.plugins` entry point, so installing it into the Airflow environment is
+all that's needed; nothing goes in the plugins folder. Shared helpers, the base
+template and styles come from
+[bluecore-airflow-common](https://github.com/blue-core-lod/bluecore-airflow-common).
+
+Requires Python 3.12 and Airflow 3.2 or later (tested against 3.3.2).
+
+Releases are published to PyPI as
+[bluecore-graph-toolbox](https://pypi.org/p/bluecore-graph-toolbox)
+
+```sh
+uv build
+uv add bluecore-graph-toolbox
+```
+
+In [bluecore-workflows](https://github.com/blue-core-lod/bluecore-workflows),
+add the pin to `dependencies` in its `pyproject.toml` and run `uv lock`; the
+Docker image installs it from the lockfile, so no wheel is copied in. When a
+new Toolbox release adds screens or API routes, bump that pin and `uv lock`
+again in a Workflows pull request.
+
+Once installed, a Toolbox item appears in the Airflow navigation. The UI
+shows it in an iframe at `/plugin/graph-toolbox`; the app itself is mounted at
+`/graph-toolbox`:
+
+| Route | Sign-in | Purpose |
+|---|---|---|
+| `GET /graph-toolbox/` | required | Landing page |
+| `GET /graph-toolbox/health` | none | `{"status", "version"}` |
+| `/graph-toolbox/static/…` | none | Toolbox and shared Blue Core assets |
+
+Sign-in is Airflow's own: the page uses Airflow's JWT cookie (Keycloak in a
+Blue Core stack), and the Toolbox has no login of its own.
+
+All URLs follow [api] base_url, so the same build works with Airflow at the
+root or proxied under a path such as /workflows
+(AIRFLOW__API__BASE_URL=`http://localhost/workflows`), where the routes above
+become `/workflows/graph-toolbox/…`.
+
+## Development
+
+```sh
+uv sync
+uv run ruff check src/bluecore_graph_toolbox tests
+uv run pytest
+```
+
+## Releasing
+
+Releases go to PyPI from
+[`.github/workflows/python-publish.yml`](.github/workflows/python-publish.yml)
+using [trusted publishing](https://docs.pypi.org/trusted-publishers/), so no
+API token is stored in the repo.
+
+1. Bump `version` in `pyproject.toml` (`uv version --bump minor`, say) and
+   merge it to `main`.
+2. Create a GitHub release whose tag is `v` plus that version, e.g. `v2.1.0`.
+3. Publishing the release runs the workflow: it checks the tag against
+   `pyproject.toml`, runs the tests, builds the wheel and sdist, checks that the
+   wheel installs as an Airflow plugin, and uploads both to PyPI. Approve the
+   `pypi` environment deployment if it asks.
+4. Bump the pin in bluecore-workflows as described above.

bluecore_graph_toolbox-2.0.0/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+name = "bluecore-graph-toolbox"
+version = "2.0.0"
+description = "Airflow Plugin for Blue Core Toolbox"
+readme = "README.md"
+requires-python = "==3.12.*"
+license = "Apache-2.0"
+license-files = ["LICENSE-2.0.txt"]
+keywords = ["airflow", "airflow-plugin", "bibframe", "blue-core", "rdf"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: Apache Airflow",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "apache-airflow>=3.2.0,<4",
+    "bluecore-airflow-common>=0.1.0",
+    "jinja2>=3.1.6",
+]
+
+[project.urls]
+Homepage = "https://github.com/blue-core-lod/graph-toolbox"
+Issues = "https://github.com/blue-core-lod/graph-toolbox/issues"
+
+[project.entry-points."airflow.plugins"]
+bluecore_graph_toolbox = "bluecore_graph_toolbox.plugin:GraphToolboxPlugin"
+
+[dependency-groups]
+dev = [
+    "apache-airflow==3.3.2",
+    "httpx",
+    "pytest",
+    "ruff",
+]
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/bluecore_graph_toolbox"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/bluecore_graph_toolbox",
+    "tests",
+    "README.md",
+    "LICENSE-2.0.txt",
+]
+[tool.pytest.ini_options]
+testpaths = ["tests"]

bluecore_graph_toolbox-2.0.0/src/bluecore_graph_toolbox/__init__.py

@@ -0,0 +1,8 @@
+"""Blue Core Graph Toolbox, packaged as an Airflow 3 plugin."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("bluecore-graph-toolbox")
+except PackageNotFoundError:
+    __version__ = "0.0.0+unknown"

bluecore_graph_toolbox-2.0.0/src/bluecore_graph_toolbox/plugin.py

@@ -0,0 +1,100 @@
+"""Blue Core Graph Toolbox, served as an Airflow 3 plugin.
+
+The plugin registers two things with Airflow:
+
+1. A FastAPI application mounted into the Airflow API server at
+   ``/graph-toolbox``, so its routes share Airflow's authentication.
+2. An external view that adds a "Toolbox" item to the Airflow navigation.
+   Because it supplies a ``url_route``, the Airflow UI renders the page in an
+   iframe at ``/plugin/graph-toolbox``.
+
+   Routes, relative to the prefix:
+
+- ``GET /``: landing page (signed in)
+- ``GET /health``: ``{"status", "version"}`` (public)
+- ``/static/*`` and ``/static/bluecore/*``: assets (public)
+
+Toolbox screens are built out in graph-toolbox #43 and #45-47.
+"""
+
+from __future__ import annotations
+
+import pathlib
+
+import bluecore_airflow_common as common
+from airflow.api_fastapi.core_api.security import GetUserDep
+from airflow.plugins_manager import AirflowPlugin
+from fastapi import APIRouter, Depends, FastAPI, Request
+from fastapi.responses import HTMLResponse
+
+from bluecore_graph_toolbox import __version__
+
+PLUGIN_NAME = "bluecore_graph_toolbox"
+TITLE = "Blue Core Graph Toolbox"
+
+# The Airflow nav truncates long labels, so the nav item has its own short name.
+NAV_LABEL = "Toolbox"
+
+# Where the FastAPI app is mounted on the Airflow API server, and the path the
+# Airflow UI uses for the iframe that wraps it. The route must be unique across
+# plugins, or Airflow drops the view.
+URL_PREFIX = "/graph-toolbox"
+URL_ROUTE = "graph-toolbox"
+
+PACKAGE_DIR = pathlib.Path(__file__).parent
+STATIC_DIR = PACKAGE_DIR / "static"
+TEMPLATES_DIR = PACKAGE_DIR / "templates"
+
+app = FastAPI(title=TITLE, docs_url=None, redoc_url=None, openapi_url=None)
+common.mount_static(app, STATIC_DIR)
+templates = common.templates(TEMPLATES_DIR)
+
+# Everything on this router needs a signed-in user, so screens added later are
+# protected without each route having to remember to ask.
+pages = APIRouter(dependencies=[Depends(common.requires_login)])
+
+
+@pages.get("/", response_class=HTMLResponse)
+def index(request: Request, user: GetUserDep) -> HTMLResponse:
+    """Render the landing page."""
+    return templates.TemplateResponse(
+        request=request,
+        name="index.html",
+        context=common.context(
+            URL_PREFIX, title=TITLE, username=user.get_name(), version=__version__
+        ),
+    )
+
+
+@app.get("/health")
+def health() -> dict[str, str]:
+    """Report that the plugin is loaded. Public, so it carries nothing sensitive."""
+    return {"status": "ok", "version": __version__}
+
+
+app.include_router(pages)
+
+
+class GraphToolboxPlugin(AirflowPlugin):
+    name = PLUGIN_NAME
+
+    fastapi_apps = [  # noqa: RUF012
+        {
+            "app": app,
+            "url_prefix": URL_PREFIX,
+            "name": TITLE,
+        }
+    ]
+
+    external_views = [  # noqa: RUF012
+        {
+            "name": NAV_LABEL,
+            "href": f"{common.airflow_root_path()}{URL_PREFIX}/",
+            "url_route": URL_ROUTE,
+            "destination": "nav",
+            # Rendered by the Airflow UI in an <img>, so the icon cannot pick up
+            # the nav's text color and each color mode needs its own file.
+            "icon": common.static_url(URL_PREFIX, "toolbox.svg"),
+            "icon_dark_mode": common.static_url(URL_PREFIX, "toolbox-dark.svg"),
+        }
+    ]

bluecore_graph_toolbox-2.0.0/src/bluecore_graph_toolbox/static/blue-core-v1.svg

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 589.5 162">
+  <defs>
+    <style>
+      .cls-1, .cls-2 {
+        fill: #003caf;
+      }
+
+      .cls-3, .cls-4 {
+        font-family: Roboto-Medium, Roboto;
+        font-weight: 500;
+      }
+
+      .cls-5, .cls-6 {
+        font-family: Roboto-Light, Roboto;
+        font-weight: 300;
+      }
+
+      .cls-2 {
+        font-size: 100px;
+      }
+
+      .cls-7 {
+        fill: #fff;
+      }
+
+      .cls-6 {
+        letter-spacing: -.06em;
+      }
+
+      .cls-4 {
+        letter-spacing: 0em;
+      }
+    </style>
+  </defs>
+  <text class="cls-2" transform="translate(151 115.5)"><tspan class="cls-5" x="0" y="0">Blue</tspan><tspan class="cls-6" x="190.28" y="0"> </tspan><tspan class="cls-3" x="208.6" y="0">Co</tspan><tspan class="cls-4" x="330.82" y="0">r</tspan><tspan class="cls-3" x="365.04" y="0">e</tspan></text>
+  <g>
+    <circle class="cls-1" cx="51.75" cy="110.25" r="29.25"/>
+    <circle class="cls-1" cx="102.94" cy="81" r="29.25"/>
+    <circle class="cls-1" cx="51.75" cy="51.75" r="29.25"/>
+    <path class="cls-7" d="M51.03,81c-2.39,0-4.57-.32-6.59-.89v29.24c0,4.54,3.27,8.21,7.31,8.21s7.31-3.68,7.31-8.21v-29.25c-2.41.57-5.06.9-8.03.9Z"/>
+    <path class="cls-7" d="M77.61,96.27c1.19,2.07,2.01,4.12,2.53,6.15l25.32-14.62c3.93-2.27,5.48-6.94,3.46-10.44-2.02-3.5-6.84-4.49-10.77-2.23l-25.33,14.63c1.7,1.8,3.31,3.93,4.8,6.51Z"/>
+    <path class="cls-7" d="M56.33,46.05c-3.93-2.27-8.75-1.27-10.77,2.23s-.47,8.17,3.46,10.44l25.33,14.63c.71-2.37,1.75-4.84,3.23-7.41,1.19-2.07,2.57-3.8,4.06-5.27l-25.32-14.62Z"/>
+  </g>
+</svg>

bluecore_graph_toolbox-2.0.0/src/bluecore_graph_toolbox/static/toolbox-dark.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"
+     fill="none" stroke="#e2e8f0" stroke-width="2" stroke-linecap="round"
+     stroke-linejoin="round" role="img" aria-label="Wrench">
+  <path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z" />
+</svg>

bluecore_graph_toolbox-2.0.0/src/bluecore_graph_toolbox/static/toolbox.css

@@ -0,0 +1,15 @@
+/*
+ * Graph Toolbox styles, loaded after the shared bluecore.css. Only rules
+ * specific to the Toolbox belong here; anything every plugin page needs goes
+ * in bluecore-airflow-common instead.
+ */
+
+.toolbox-logo {
+  width: 12rem;
+  height: auto;
+}
+
+.toolbox-version {
+  font-size: 1rem;
+  color: var(--bluecore-fg-muted);
+}

bluecore_graph_toolbox-2.0.0/src/bluecore_graph_toolbox/static/toolbox.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"
+     fill="none" stroke="#2d3748" stroke-width="2" stroke-linecap="round"
+     stroke-linejoin="round" role="img" aria-label="Wrench">
+  <path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z" />
+</svg>

bluecore_graph_toolbox-2.0.0/src/bluecore_graph_toolbox/templates/index.html

@@ -0,0 +1,18 @@
+{% extends "bluecore/base.html" %}
+
+{% block head %}
+<link rel="stylesheet" href="{{ static_url('toolbox.css') }}" />
+{% endblock %}
+
+{% block body_class %}centered{% endblock %}
+
+{% block content %}
+<img
+  class="toolbox-logo"
+  src="{{ static_url('blue-core-v1.svg') }}"
+  alt="Blue Core"
+/>
+<h1>{{ title }}</h1>
+<p>Signed in as {{ username }}</p>
+<p class="toolbox-version">Version {{ version }}</p>
+{% endblock %}

bluecore_graph_toolbox-2.0.0/tests/conftest.py

@@ -0,0 +1,70 @@
+"""Shared fixtures for the Graph Toolbox plugin tests."""
+
+from __future__ import annotations
+
+import importlib
+from collections.abc import Iterator
+from types import ModuleType
+
+import pytest
+from airflow.api_fastapi.core_api.security import get_user
+from fastapi.testclient import TestClient
+
+from bluecore_graph_toolbox import plugin as plugin_module
+
+# [api] base_url values, with the path each one should put in front of every
+# URL: Airflow at the root, proxied under /workflows, and not set at all.
+BASE_URLS = {
+    "root": ("http://localhost:8080/", ""),
+    "workflows": ("http://localhost/workflows", "/workflows"),
+    "unset": ("", ""),
+}
+
+
+class StubUser:
+    """Stands in for the user Airflow resolves from its JWT cookie."""
+
+    def __init__(self, name: str) -> None:
+        self.name = name
+        self.id = name
+
+    def get_name(self) -> str:
+        return self.name
+
+    def get_id(self) -> str:
+        return self.id
+
+
+@pytest.fixture(params=sorted(BASE_URLS))
+def root_path(request: pytest.FixtureRequest, monkeypatch: pytest.MonkeyPatch) -> str:
+    """Set [api] base_url and return the root path URLs should start with."""
+    base_url, path = BASE_URLS[request.param]
+    monkeypatch.setenv("AIRFLOW__API__BASE_URL", base_url)
+    return path
+
+
+@pytest.fixture
+def plugin(root_path: str) -> ModuleType:
+    """The plugin module, imported again under the current base_url.
+
+    The nav link and icon URLs are built when the module is imported, so it
+    has to be reloaded for each base path to see the change.
+    """
+    return importlib.reload(plugin_module)
+
+
+@pytest.fixture
+def client(plugin: ModuleType) -> TestClient:
+    """A browser with no Airflow cookie."""
+    return TestClient(plugin.app)
+
+
+@pytest.fixture
+def signed_in_client(plugin: ModuleType) -> Iterator[TestClient]:
+    """A browser whose Airflow cookie resolved to a user.
+
+    The name contains markup so tests can check the page escapes it.
+    """
+    plugin.app.dependency_overrides[get_user] = lambda: StubUser("<b>cataloger</b>")
+    yield TestClient(plugin.app)
+    plugin.app.dependency_overrides.clear()

bluecore_graph_toolbox-2.0.0/tests/test_entry_point.py

@@ -0,0 +1,26 @@
+"""Tests that installing the package is enough for Airflow to find the plugin."""
+
+from __future__ import annotations
+
+from importlib.metadata import entry_points, version
+
+from airflow.plugins_manager import AirflowPlugin
+
+from bluecore_graph_toolbox import __version__
+from bluecore_graph_toolbox.plugin import GraphToolboxPlugin
+
+
+def test_plugin_is_registered_as_an_airflow_entry_point() -> None:
+    [entry_point] = entry_points(group="airflow.plugins", name="bluecore_graph_toolbox")
+
+    assert entry_point.value == "bluecore_graph_toolbox.plugin:GraphToolboxPlugin"
+    loaded = entry_point.load()
+    assert loaded is GraphToolboxPlugin
+    assert issubclass(loaded, AirflowPlugin)
+
+
+def test_version_comes_from_the_installed_distribution() -> None:
+    # __version__ looks itself up by distribution name, so renaming the
+    # distribution without updating __init__.py falls back to 0.0.0+unknown.
+    assert __version__ != "0.0.0+unknown"
+    assert __version__ == version("bluecore-graph-toolbox")

bluecore_graph_toolbox-2.0.0/tests/test_plugin.py

@@ -0,0 +1,93 @@
+"""Tests for the Graph Toolbox Airflow plugin: registration, URLs and access."""
+
+from __future__ import annotations
+
+import re
+from types import ModuleType
+
+from airflow.plugins_manager import AirflowPlugin
+from fastapi.testclient import TestClient
+
+from bluecore_graph_toolbox import __version__
+
+STATIC_FILES = [
+    "toolbox.css",
+    "toolbox.svg",
+    "toolbox-dark.svg",
+    "blue-core-v1.svg",
+    "bluecore/bluecore.css",
+    "bluecore/bluecore.js",
+]
+
+
+def test_plugin_registers_app_and_nav_view(plugin: ModuleType) -> None:
+    toolbox = plugin.GraphToolboxPlugin
+
+    assert issubclass(toolbox, AirflowPlugin)
+    assert toolbox.name == "bluecore_graph_toolbox"
+    assert toolbox.fastapi_apps == [
+        {"app": plugin.app, "url_prefix": "/graph-toolbox", "name": plugin.TITLE}
+    ]
+    [view] = toolbox.external_views
+    assert view["name"] == "Toolbox"
+    assert view["url_route"] == "graph-toolbox"
+    assert view["destination"] == "nav"
+
+
+def test_nav_urls_follow_base_url(plugin: ModuleType, root_path: str) -> None:
+    [view] = plugin.GraphToolboxPlugin.external_views
+
+    assert view["href"] == f"{root_path}/graph-toolbox/"
+    assert view["icon"] == f"{root_path}/graph-toolbox/static/toolbox.svg"
+    assert (
+        view["icon_dark_mode"] == f"{root_path}/graph-toolbox/static/toolbox-dark.svg"
+    )
+
+
+def test_landing_page_requires_sign_in(client: TestClient) -> None:
+    response = client.get("/")
+
+    assert response.status_code == 401
+
+
+def test_landing_page_shows_signed_in_user(signed_in_client: TestClient) -> None:
+    response = signed_in_client.get("/")
+
+    assert response.status_code == 200
+    assert "Signed in as <b>cataloger</b>" in response.text
+    assert "<b>cataloger</b>" not in response.text
+    assert f"Version {__version__}" in response.text
+
+
+def test_landing_page_links_are_absolute(
+    signed_in_client: TestClient, root_path: str
+) -> None:
+    html = signed_in_client.get("/").text
+    static = f"{root_path}/graph-toolbox/static"
+
+    local = [
+        url
+        for url in re.findall(r'(?:href|src)="([^"]+)"', html)
+        if not url.startswith("https://")
+    ]
+    assert sorted(local) == sorted(
+        [
+            f"{static}/bluecore/bluecore.css",
+            f"{static}/bluecore/bluecore.js",
+            f"{static}/toolbox.css",
+            f"{static}/blue-core-v1.svg",
+        ]
+    )
+
+
+def test_health_is_public_and_minimal(client: TestClient) -> None:
+    response = client.get("/health")
+
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok", "version": __version__}
+
+
+def test_static_files_are_served_without_sign_in(client: TestClient) -> None:
+    for name in STATIC_FILES:
+        response = client.get(f"/static/{name}")
+        assert response.status_code == 200, name