From 25b2f5b28e48dd84f4169e4e87dcfeba2e54832c Mon Sep 17 00:00:00 2001 From: Tim Jenness Date: Mon, 10 Jul 2023 08:07:48 -0700 Subject: [PATCH] Added news fragments --- doc/changes/DM-39915.feature.rst | 6 ++++++ doc/changes/DM-39915.removal.rst | 2 ++ 2 files changed, 8 insertions(+) create mode 100644 doc/changes/DM-39915.feature.rst create mode 100644 doc/changes/DM-39915.removal.rst diff --git a/doc/changes/DM-39915.feature.rst b/doc/changes/DM-39915.feature.rst new file mode 100644 index 0000000000..3ecd02ae40 --- /dev/null +++ b/doc/changes/DM-39915.feature.rst @@ -0,0 +1,6 @@ +Added new APIs to support the deprecation of ``LimitedButler.datastore``: +* ``LimitedButler.get_datastore_roots`` can be used to retrieve any root URIs associated with attached datastores. + If a datastore does not support the concept it will return `None` for its root URI. +* ``LimitedButler.get_datastore_names`` can be used to retrieve the names of the internal datastores. +* ``LimitedButler.get_many_uris`` allows for the bulk retrieval of URIs from a list of refs. +* Also made ``getURI`` and ``getURIs`` available for ``LimitedButler``. diff --git a/doc/changes/DM-39915.removal.rst b/doc/changes/DM-39915.removal.rst new file mode 100644 index 0000000000..8957f44f24 --- /dev/null +++ b/doc/changes/DM-39915.removal.rst @@ -0,0 +1,2 @@ +The semi-public ``Butler.datastore`` property has now been deprecated. +The ``LimitedButler`` API has been expanded such that there is no longer any need for anyone to access the datastore class directly.