Merge pull request #1694 from dandi/enh-staging

Bring back dandi-staging to provide more graceful transition for 3rd party libraries

Author: yarikoptic

dandi/cli/tests/test_instances.py

@@ -19,6 +19,9 @@ def test_cmd_instances(monkeypatch):
         "dandi-sandbox:\n"
         "  api: https://api.sandbox.dandiarchive.org/api\n"
         "  gui: https://sandbox.dandiarchive.org\n"
+        "dandi-staging:\n"
+        "  api: https://api.sandbox.dandiarchive.org/api\n"
+        "  gui: https://sandbox.dandiarchive.org\n"
         "ember:\n"
         "  api: https://api-dandi.emberarchive.org/api\n"
         "  gui: https://dandi.emberarchive.org\n"

dandi/consts.py

@@ -122,6 +122,13 @@ def urls(self) -> Iterator[str]:
         "https://dandiarchive.org",
         "https://api.dandiarchive.org/api",
     ),
+    # Deprecated. Remove early 2026.
+    # Should come before dandi-sandbox so _rev map does map to sandbox
+    "dandi-staging": DandiInstance(
+        "dandi-staging",
+        "https://sandbox.dandiarchive.org",
+        "https://api.sandbox.dandiarchive.org/api",
+    ),
     "dandi-sandbox": DandiInstance(
         "dandi-sandbox",
         "https://sandbox.dandiarchive.org",

dandi/utils.py

@@ -576,6 +576,11 @@ def get_instance(dandi_instance_id: str | DandiInstance) -> DandiInstance:
     else:
         dandi_id = dandi_instance_id
         instance = known_instances[dandi_id]
+    if dandi_id == "dandi-staging":
+        lgr.warning(
+            "'dandi-staging' DANDI instance identifier is deprecated. "
+            "The instance was renamed into 'dandi-sandbox', please use that identifier instead."
+        )
     if redirector_url is None:
         assert instance is not None
         return _get_instance(instance.api.rstrip("/"), True, instance, dandi_id)

docs/source/cmdline/instances.rst

@@ -22,6 +22,9 @@ Example output:
     dandi-sandbox:
       api: https://api.sandbox.dandiarchive.org/api
       gui: https://sandbox.dandiarchive.org
+    dandi-staging:
+      api: https://api.sandbox.dandiarchive.org/api
+      gui: https://sandbox.dandiarchive.org
     linc-staging:
       api: https://staging-api.lincbrain.org/api
       gui: https://staging.lincbrain.org