antelope-interface 0.3.1__tar.gz → 0.3.2__tar.gz

{antelope_interface-0.3.1/src/antelope_interface.egg-info → antelope_interface-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: antelope_interface
-Version: 0.3.1
+Version: 0.3.2
 Summary: A common interface for accessing LCA data
 Author-email: Brandon Kuczenski <bkuczenski@ucsb.edu>
 License: BSD-3-Clause

{antelope_interface-0.3.1 → antelope_interface-0.3.2}/pyproject.toml

@@ -22,7 +22,7 @@ classifiers = [
         "Topic :: Scientific/Engineering"
 ]
 dependencies = ["synonym_dict >= 0.2.4", "pydantic >= 2.5.0"]
-version = "0.3.1"
+version = "0.3.2"
 
 [tool.setuptools.packages.find]
 where = ["src"]

{antelope_interface-0.3.1 → antelope_interface-0.3.2}/setup.py

@@ -5,6 +5,8 @@ setup()
 
 """
 Version History:
+0.3.2  2025/08/01 - 0.3.2 release. better background handling.
+
 0.3.1  2025/06/18 - 0.3.1 release. small tweaks to method signatures.
 
 0.3.0   2024/10/24 - 0.3.0 release. add comparators.

{antelope_interface-0.3.1 → antelope_interface-0.3.2}/src/antelope/__init__.py

@@ -11,7 +11,7 @@ from .interfaces.ibasic import BasicInterface, EntityNotFound, NoAccessToEntity,
 from .interfaces.iconfigure import ConfigureInterface
 from .interfaces.iexchange import ExchangeInterface, ExchangeRequired
 from .interfaces.iindex import IndexInterface, IndexRequired, directions, comp_dir, num_dir, check_direction, valid_sense, comp_sense
-from .interfaces.ibackground import BackgroundInterface, BackgroundRequired
+from .interfaces.ibackground import BackgroundInterface, BackgroundRequired, LinkingError
 from .interfaces.iquantity import QuantityInterface, QuantityRequired, NoFactorsFound, ConversionReferenceMismatch, FlowableMismatch
 from .interfaces.iforeground import ForegroundInterface
 

{antelope_interface-0.3.1 → antelope_interface-0.3.2}/src/antelope/interfaces/ibackground.py

@@ -26,6 +26,13 @@ class BackgroundRequired(Exception):
     pass
 
 
+class LinkingError(Exception):
+    """
+    To be returned when a strict linking strategy cannot be implemented
+    """
+    pass
+
+
 _interface = 'background'
 
 BACKGROUND_VALUES_REQUIRED = {'dependencies', 'emissions', 'cutoffs', 'lci', 'sys_lci', 'foreground', 'ad', 'bf'}

antelope_interface-0.3.2/src/antelope/qdb/qdb.py

@@ -0,0 +1,32 @@
+"""
+An interface specification for a quantity database.  This was originally conceived as being *the* quantity
+interface, but as things have developed it's become clear that the qdb does more (and less) than the
+quantity interface governs, and many (even most) of the operations of qdb are not even part of the antelope
+interface spec.
+
+For that reason, we are putting this *still in* antelope interface but *outside of* the abstract query framework,
+and making it a straight abstract base class.
+"""
+
+from abc import ABC
+
+
+class QdbInterface(ABC):
+    """
+    The main purpose of the qdb is to maintain a free-standing database of quantities and flows.  This will
+    most likely be implemented as a graph, but the interface for interacting with it is not going to care about
+    that.  Here we brainstorm about all the things we would want the qdb to do.
+
+    # quantities
+
+    Quantities are a fundamental concept in physical science; yet my implementation of them is basically made up
+    based on my experience and intuition.  We distinguish between reference quantities, which are directly measurable,
+    and which are [within qdb] *strictly* canonical and can therefore only be created or altered by privileged users,
+    and *indicators*, which are quantities that may or may not be directly measurable but are owned by users and
+    therefore not canonical.
+
+
+    In qdb, we only store *reference* quantities (right? or do we allow users
+    to make their own quantities?  we allow users to make their own *indicators*.  Only privileged users can c
+    """
+    pass

antelope_interface-0.3.2/src/antelope/qdb/units.py

@@ -0,0 +1,15 @@
+"""
+this belongs in the implementation, not the interface
+"""
+
+from pint import UnitRegistry
+
+
+U = UnitRegistry()
+
+
+comp_units = {
+    'm3': U.meter ** 3,
+    'm2a': U.meter ** 2 * U.year,
+    'tkm': U.tonne * U.kilometer,
+}

{antelope_interface-0.3.1 → antelope_interface-0.3.2}/src/antelope/refs/base.py

@@ -140,7 +140,10 @@ class BaseRef(BaseEntity):
         return item in self._d
 
     def __setitem__(self, key, value):
-        self._d[key] = value
+        if value is None:
+            self._d.pop(key, None)
+        else:
+            self._d[key] = value
 
     @property
     def _name(self):

{antelope_interface-0.3.1 → antelope_interface-0.3.2/src/antelope_interface.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: antelope_interface
-Version: 0.3.1
+Version: 0.3.2
 Summary: A common interface for accessing LCA data
 Author-email: Brandon Kuczenski <bkuczenski@ucsb.edu>
 License: BSD-3-Clause

{antelope_interface-0.3.1 → antelope_interface-0.3.2}/src/antelope_interface.egg-info/SOURCES.txt

@@ -22,6 +22,9 @@ src/antelope/interfaces/iquantity.py
 src/antelope/models/__init__.py
 src/antelope/models/auth.py
 src/antelope/models/comparators.py
+src/antelope/qdb/__init__.py
+src/antelope/qdb/qdb.py
+src/antelope/qdb/units.py
 src/antelope/refs/__init__.py
 src/antelope/refs/base.py
 src/antelope/refs/catalog_ref.py