LSST Applications 27.0.0,g0265f82a02+469cd937ee,g02d81e74bb+21ad69e7e1,g1470d8bcf6+cbe83ee85a,g2079a07aa2+e67c6346a6,g212a7c68fe+04a9158687,g2305ad1205+94392ce272,g295015adf3+81dd352a9d,g2bbee38e9b+469cd937ee,g337abbeb29+469cd937ee,g3939d97d7f+72a9f7b576,g487adcacf7+71499e7cba,g50ff169b8f+5929b3527e,g52b1c1532d+a6fc98d2e7,g591dd9f2cf+df404f777f,g5a732f18d5+be83d3ecdb,g64a986408d+21ad69e7e1,g858d7b2824+21ad69e7e1,g8a8a8dda67+a6fc98d2e7,g99cad8db69+f62e5b0af5,g9ddcbc5298+d4bad12328,ga1e77700b3+9c366c4306,ga8c6da7877+71e4819109,gb0e22166c9+25ba2f69a1,gb6a65358fc+469cd937ee,gbb8dafda3b+69d3c0e320,gc07e1c2157+a98bf949bb,gc120e1dc64+615ec43309,gc28159a63d+469cd937ee,gcf0d15dbbd+72a9f7b576,gdaeeff99f8+a38ce5ea23,ge6526c86ff+3a7c1ac5f1,ge79ae78c31+469cd937ee,gee10cc3b42+a6fc98d2e7,gf1cff7945b+21ad69e7e1,gfbcc870c63+9a11dc8c8f
LSST Data Management Base Package
|
Public Member Functions | |
str|None | get (self, str key, str|None default=None) |
None | set (self, str key, str value, *bool force=False) |
bool | delete (self, str key) |
Generator[tuple[str, str], None, None] | items (self) |
bool | empty (self) |
Interface for accessing APDB metadata. Metadata is a collection of key/value items usually stored in a special table in the database. This abstract interface provides methods for accessing and modifying it.
Definition at line 30 of file apdbMetadata.py.
bool lsst.dax.apdb.apdbMetadata.ApdbMetadata.delete | ( | self, | |
str | key ) |
Delete metadata record. Parameters ---------- key : `str` Metadata key, arbitrary non-empty string. Returns ------- existed : `bool` `True` is returned if attribute existed before it was deleted.
Reimplemented in lsst.dax.apdb.cassandra.apdbMetadataCassandra.ApdbMetadataCassandra, and lsst.dax.apdb.sql.apdbMetadataSql.ApdbMetadataSql.
Definition at line 84 of file apdbMetadata.py.
bool lsst.dax.apdb.apdbMetadata.ApdbMetadata.empty | ( | self | ) |
Check whether attributes set is empty. Returns ------- empty : `bool` `True` if there are no any attributes defined. `True` is also returned if metadata table is missing.
Reimplemented in lsst.dax.apdb.cassandra.apdbMetadataCassandra.ApdbMetadataCassandra, and lsst.dax.apdb.sql.apdbMetadataSql.ApdbMetadataSql.
Definition at line 113 of file apdbMetadata.py.
str | None lsst.dax.apdb.apdbMetadata.ApdbMetadata.get | ( | self, | |
str | key, | ||
str | None | default = None ) |
Retrieve value of a given metadata record. Parameters ---------- key : `str` Metadata key, arbitrary non-empty string. default : `str`, optional Default value returned when key does not exist, can be string or `None`. Returns ------- value : `str` or `None` Metadata value, if key does not exist then ``default`` is returned.
Reimplemented in lsst.dax.apdb.cassandra.apdbMetadataCassandra.ApdbMetadataCassandra, and lsst.dax.apdb.sql.apdbMetadataSql.ApdbMetadataSql.
Definition at line 39 of file apdbMetadata.py.
Generator[tuple[str, str], None, None] lsst.dax.apdb.apdbMetadata.ApdbMetadata.items | ( | self | ) |
Iterate over records and yield their keys and values. Yields ------ key : `str` Metadata key. value : `str` Corresponding metadata value.
Reimplemented in lsst.dax.apdb.cassandra.apdbMetadataCassandra.ApdbMetadataCassandra, and lsst.dax.apdb.sql.apdbMetadataSql.ApdbMetadataSql.
Definition at line 100 of file apdbMetadata.py.
None lsst.dax.apdb.apdbMetadata.ApdbMetadata.set | ( | self, | |
str | key, | ||
str | value, | ||
*bool | force = False ) |
Set value for a given metadata record. Parameters ---------- key : `str` Metadata key, arbitrary non-empty string. value : `str` New metadata value, an arbitrary string. Due to deficiencies of some database engines we are not allowing empty strings to be stored in the database, and ``value`` cannot be an empty string. force : `bool`, optional Controls handling of existing metadata. With default `False` value an exception is raised if ``key`` already exists, if `True` is passed then value of the existing key will be updated. Raises ------ KeyError Raised if key already exists but ``force`` option is false. ValueError Raised if key or value parameters are empty.
Reimplemented in lsst.dax.apdb.cassandra.apdbMetadataCassandra.ApdbMetadataCassandra, and lsst.dax.apdb.sql.apdbMetadataSql.ApdbMetadataSql.
Definition at line 58 of file apdbMetadata.py.