dss-python 0.15.7__tar.gz → 0.15.8a1__tar.gz

{dss_python-0.15.7 → dss_python-0.15.8a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dss-python
-Version: 0.15.7
+Version: 0.15.8a1
 Summary: Python interface (bindings and tools) for OpenDSS. Based on the AltDSS/DSS C-API project, the alternative OpenDSS implementation from DSS-Extensions.org. Multiplatform, API-compatible/drop-in replacement for the COM version of OpenDSS.
 Project-URL: Homepage, https://github.com/dss-extensions/DSS-Python
 Project-URL: Documentation, https://dss-extensions.org/DSS-Python
@@ -55,7 +55,7 @@ Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Scientific/Engineering
 Requires-Python: >=3.7
-Requires-Dist: dss-python-backend==0.14.5
+Requires-Dist: dss-python-backend==0.14.6a1
 Requires-Dist: numpy>=1.21.0
 Requires-Dist: typing-extensions<5,>=4.5
 Provides-Extra: all

{dss_python-0.15.7 → dss_python-0.15.8a1}/dss/IBus.py

@@ -463,6 +463,13 @@ class IBus(Base):
         return self.__getitem__(index)
 
     def __iter__(self) -> Iterator[IBus]:
+        if self._api_util._is_odd:
+            for i in range(self._lib.Circuit_Get_NumBuses()):
+                self._check_for_error(self._lib.Circuit_SetActiveBusi(i))
+                yield self
+
+            return
+
         n = self._check_for_error(self._lib.Circuit_SetActiveBusi(0))
         while n == 0:
             yield self

{dss_python-0.15.7 → dss_python-0.15.8a1}/dss/ICircuit.py

@@ -206,14 +206,14 @@ class ICircuit(Base):
         self.PVSystems = IPVSystems(api_util)
         self.Vsources = IVsources(api_util)
         self.LineCodes = ILineCodes(api_util)
-        self.LineGeometries = ILineGeometries(api_util)
-        self.LineSpacings = ILineSpacings(api_util)
-        self.WireData = IWireData(api_util)
-        self.CNData = ICNData(api_util)
-        self.TSData = ITSData(api_util)
-        self.Reactors = IReactors(api_util)
+        self.LineGeometries = ILineGeometries(api_util) if not api_util._is_odd else None
+        self.LineSpacings = ILineSpacings(api_util) if not api_util._is_odd else None
+        self.WireData = IWireData(api_util) if not api_util._is_odd else None
+        self.CNData = ICNData(api_util) if not api_util._is_odd else None
+        self.TSData = ITSData(api_util) if not api_util._is_odd else None
+        self.Reactors = IReactors(api_util) if not api_util._is_odd else None
         self.ReduceCkt = IReduceCkt(api_util) #: Circuit Reduction Interface
-        self.Storages = IStorages(api_util)
+        self.Storages = IStorages(api_util) if not api_util._is_odd else None
         self.GICSources = IGICSources(api_util)
 
         if hasattr(api_util.lib, 'Parallel_CreateActor'):

{dss_python-0.15.7 → dss_python-0.15.8a1}/dss/IDSS.py

@@ -134,14 +134,14 @@ class IDSS(Base):
         self.Executive = IDSS_Executive(api_util)
         
         #: Kept for compatibility.
-        self.Events = IDSSEvents(api_util)
+        self.Events = IDSSEvents(api_util) if not api_util._is_odd else None
         
         #: Kept for compatibility.
         self.Parser = IParser(api_util)
         
         #: Kept for compatibility. Apparently was used for DSSim-PC (now OpenDSS-G), a 
         #: closed-source software developed by EPRI using LabView.
-        self.DSSim_Coms = IDSSimComs(api_util)
+        self.DSSim_Coms = IDSSimComs(api_util) if not api_util._is_odd else None
         
         #: The YMatrix interface provides advanced access to the internals of
         #: the DSS engine. The sparse admittance matrix of the system is also 
@@ -157,7 +157,7 @@ class IDSS(Base):
         #: and run scripts inside the ZIP, without creating extra files on disk.
         #: 
         #: **(API Extension)**
-        self.ZIP = IZIP(api_util)
+        self.ZIP = IZIP(api_util) if not api_util._is_odd else None
 
         Base.__init__(self, api_util)    
 
@@ -444,6 +444,10 @@ class IDSS(Base):
 
         **(API Extension)**
         '''
+
+        if self._api_util._is_odd:
+            raise NotImplementedError("NewContext is not supported for the official OpenDSS engine.")
+
         ffi = self._api_util.ffi
         lib = self._api_util.lib_unpatched
         new_ctx = ffi.gc(lib.ctx_New(), lib.ctx_Dispose)

dss_python-0.15.8a1/dss/Oddie.py

@@ -0,0 +1,84 @@
+from __future__ import annotations
+from typing import Optional
+from ._cffi_api_util import CffiApiUtil
+from .IDSS import IDSS
+from enum import Flag
+
+class OddieOptions(Flag):
+    MapErrors = 0x01
+
+
+class IOddieDSS(IDSS):
+    r'''
+    The OddieDSS class exposes the official OpenDSSDirect.DLL binary,
+    as distributed by EPRI, with the same API as the DSS-Python and
+    the official COM interface object on Windows. It uses AltDSS Oddie
+    to achieve this.
+
+    **Note:** This class requires the backend for Oddie to be included in
+    the `dss_python_backend` package. If it is not available, an import 
+    error should occur when trying to use this.
+
+    AltDSS Oddie wraps OpenDSSDirect.DLL, providing a minimal compatiliby layer
+    to expose it with the same API as AltDSS/DSS C-API. With it, we can
+    just reuse most of the tools from the other projects on DSS-Extensions
+    without too much extra work.
+
+    Note that many functions from DSS-Extensions will not be available and/or
+    will return errors, and this is expected. There are some issues and/or
+    limitations from OpenDSSDirect.DLL that may or may not affect specific
+    use cases; check the documentation on https://dss-extensions.org for 
+    more information.
+
+    :param library_path: The name or full path of the target dynamic library to
+    load. Defaults to trying to load "OpenDSSDirect" from `c:\Program Files\OpenDSS\x64`,
+    followed by trying to load it from the current path.
+
+    :param load_flags: Optional, flags to feed the [`LoadLibrary`](https://learn.microsoft.com/en-us/windows/win32/api/libloaderapi/nf-libloaderapi-loadlibraryexa) 
+    (on Windows) or `dlopen` (on Linux and macOS, whenever EPRI supports it). If not provided, a default set will be used.
+
+    :param oddie_options: Optional, Oddie configuration flags. If none passed,
+    the default settings (recommended) will be used. For advanced users.
+    '''
+
+    def __init__(self, library_path: str = '', load_flags: Optional[int] = None, oddie_options: Optional[OddieOptions] = None):
+        from dss_python_backend import _altdss_oddie_capi
+        lib = _altdss_oddie_capi.lib
+        ffi = _altdss_oddie_capi.ffi
+        NULL = ffi.NULL
+        
+        c_load_flags = NULL
+        if load_flags is not None:
+            c_load_flags = ffi.new('uint32_t*', load_flags)
+
+        if library_path:
+            library_path = library_path.encode()
+            lib.Oddie_SetLibOptions(library_path, c_load_flags)
+            ctx = lib.ctx_New()
+        else:
+            # Try the default install folder
+            library_path = rb'C:\Program Files\OpenDSS\x64\OpenDSSDirect.dll'
+            lib.Oddie_SetLibOptions(library_path, c_load_flags)
+            ctx = lib.ctx_New()
+            if ctx == NULL:
+                # Try from the general path, let the system resolve it
+                library_path = rb'OpenDSSDirect.dll'
+                lib.Oddie_SetLibOptions(library_path, c_load_flags)
+                ctx = lib.ctx_New()
+
+        if ctx == NULL:
+            raise RuntimeError("Could not load the target library.")
+
+        if lib.ctx_DSS_Start(ctx, 0) != 1:
+            raise RuntimeError("DSS_Start call was not successful.")
+
+        if oddie_options is not None:
+            lib.Oddie_SetOptions(oddie_options)
+
+        ctx = ffi.gc(ctx, lib.ctx_Dispose)
+        api_util = CffiApiUtil(ffi, lib, ctx, is_odd=True)
+        api_util._library_path = library_path
+        IDSS.__init__(self, api_util)
+
+
+__all__ = ['IOddieDSS', 'OddieOptions']

{dss_python-0.15.7 → dss_python-0.15.8a1}/dss/__init__.py

@@ -17,8 +17,8 @@ if os.path.exists(_properties_mo):
     lib.DSS_SetPropertiesMO(_properties_mo.encode())
 
 from ._cffi_api_util import CffiApiUtil, DSSException, set_case_insensitive_attributes
-# from .altdss import Edit
 from .IDSS import IDSS
+from .Oddie import IOddieDSS, OddieOptions
 from .enums import *
 
 DssException = DSSException
@@ -44,4 +44,4 @@ try:
 except:
     __version__ = '0.0dev'
 
-__all__ = ['dss', 'DSS', 'DSS_GR', 'prime_api_util', 'api_util', 'DSSException', 'patch_dss_com', 'set_case_insensitive_attributes', 'enums', 'Edit']
+__all__ = ['dss', 'DSS', 'DSS_GR', 'prime_api_util', 'api_util', 'DSSException', 'patch_dss_com', 'set_case_insensitive_attributes', 'enums', 'IOddieDSS', 'OddieOptions']

{dss_python-0.15.7 → dss_python-0.15.8a1}/dss/_cffi_api_util.py

@@ -334,7 +334,8 @@ class CffiApiUtil(object):
     '''
     _ctx_to_util = WeakKeyDictionary()
 
-    def __init__(self, ffi, lib, ctx=None):
+    def __init__(self, ffi, lib, ctx=None, is_odd=False):
+        self._is_odd = is_odd
         self.owns_ctx = True
         self.codec = codec
         self.ctx = ctx
@@ -466,18 +467,26 @@ class CffiApiUtil(object):
 
 
     def register_callbacks(self):
+        if self._is_odd:
+            return
+
         mgr = get_manager_for_ctx(self.ctx)
         # if multiple calls, the extras are ignored
         mgr.register_func(AltDSSEvent.Clear, altdss_python_util_callback)
         mgr.register_func(AltDSSEvent.ReprocessBuses, altdss_python_util_callback)
 
     def unregister_callbacks(self):
+        if self._is_odd:
+            return
         mgr = get_manager_for_ctx(self.ctx)
         mgr.unregister_func(AltDSSEvent.Clear, altdss_python_util_callback)
         mgr.unregister_func(AltDSSEvent.ReprocessBuses, altdss_python_util_callback)
 
     # The context will die, no need to do anything else currently.
     def __del__(self):
+        if self._is_odd:
+            return
+
         self.clear_callback(0)
         self.clear_callback(1)
         self.unregister_callbacks()

dss_python-0.15.8a1/dss/_version.py

@@ -0,0 +1 @@
+__version__ = "0.15.8a1"

{dss_python-0.15.7 → dss_python-0.15.8a1}/pyproject.toml

@@ -24,7 +24,7 @@ packages = ["dss"]
 name = "dss-python"
 dynamic = ["version"]
 dependencies = [
-    "dss_python_backend==0.14.5",
+    "dss_python_backend==0.14.6a1",
     "numpy>=1.21.0",
     "typing_extensions>=4.5,<5",
 ]

dss_python-0.15.7/dss/_version.py

@@ -1 +0,0 @@
-__version__ = "0.15.7"