Extensive updates to support multiple DSS instances, GR API, and exception mapping.

.github/workflows/dotnet.yml

@@ -0,0 +1,35 @@
+name: Build package
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Adjust versions
+      run: bash scripts/ci_update_versions.sh
+    - name: Download DSS C-API binaries
+      run: bash scripts/download_native_libs.sh
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v2
+      with:
+        dotnet-version: 6.0.x
+    - name: Restore dependencies
+      run: dotnet restore
+    - name: Build
+      run: dotnet build --no-restore -c Release
+    - name: Pack
+      run: dotnet pack -c Release
+#    - name: Test --- TODO!
+#      run: dotnet test --no-build --verbosity normal
+    - name: 'Upload artifacts'
+      uses: "actions/upload-artifact@v2"
+      with:
+        name: 'packages'
+        path: '${{ github.workspace }}/bin/Release/*.nupkg'
+

.gitignore

@@ -1,3 +1,6 @@
 .vs
 obj
-bin/
+bin/
+messages/
+runtimes/
+.vscode/

LICENSE

@@ -1,5 +1,5 @@
-Copyright (c) 2008-2018, Electric Power Research Institute, Inc.
-Copyright (c) 2017-2018, Paulo Meira
+Copyright (c) 2016-2022 Paulo Meira
+Copyright (c) 2018-2022 DSS Extensions contributors
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

OPENDSS_LICENSE

@@ -0,0 +1,27 @@
+* Copyright (c) 2008-2021, Electric Power Research Institute, Inc.
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without
+* modification, are permitted provided that the following conditions are met:
+*     * Redistributions of source code must retain the above copyright
+*       notice, this list of conditions and the following disclaimer.
+*     * Redistributions in binary form must reproduce the above copyright
+*       notice, this list of conditions and the following disclaimer in the
+*       documentation and/or other materials provided with the distribution.
+*     * Neither the name of the Electric Power Research Institute, Inc., nor
+*       the names of its contributors may be used to endorse or promote 
+*       products derived from this software without specific prior written 
+*       permission.
+*
+* THIS SOFTWARE IS PROVIDED BY Electric Power Research Institute, Inc., "AS IS"
+* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+* DISCLAIMED. IN NO EVENT SHALL Electric Power Research Institute, Inc., BE 
+* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
+* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
+* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
+* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
+* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
+* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
+* POSSIBILITY OF SUCH DAMAGE.
+

README.md

@@ -1,14 +1,29 @@
-[![Build status](https://ci.appveyor.com/api/projects/status/n5q0ddql063r2fkx/branch/master?svg=true)](https://ci.appveyor.com/project/PMeira/dss-sharp-h8r36/branch/master)
+[![Build](https://github.com/dss-extensions/dss_sharp/actions/workflows/dotnet.yml/badge.svg)](https://github.com/dss-extensions/dss_sharp/actions/workflows/dotnet.yml)
 
 # DSS Sharp
 
-This contain files for the C# bindings for dss_capi, an unofficial build with a custom C-API of EPRI's OpenDSS. With it, you can replace the COM module with very few code changes and reach multi-platform C# code easily!
+DSS Sharp is a C#/.NET wrapper library for DSS C-API, which is an open-source, multiplatform, multiarchitecture, extended alternative (unofficial, not provided by EPRI) OpenDSS engine, highly compatible with the official OpenDSS COM implementation and more.
+
+DSS Sharp tries to mimic the organization of the official OpenDSS COM interfaces, plus several extensions (new properties and methods, and whole new classes). If you find conflicting behavior, feel free to report.
+
+This projects exposes most of the funcionality implemented in DSS C-API, including performance benefits, ZIP file support, initial JSON exports, multi-platform (Linux, Windows, macOS) support, including Intel x86/x64 and ARM architectures. Contrary to the official implementation, DSS Sharp supports multiple OpenDSS instances ([`dss_sharp.DSS.NewContext()`](https://dss-extensions.org/dss_sharp/html/d0e4d400-3bd9-1244-3cac-8f1234cbad9f.htm)), effectively enabling user-controlled multi-threading applications. Most of the official [parallel-machine](https://dss-extensions.org/dss_sharp/html/f3440753-3e74-bdb2-81c6-9052f8742d7e.htm) functions are also available.
+
+For a general introduction visit https://dss-extensions.org and follow the development of the general documentation at https://github.com/dss-extensions/dss-extensions
 
 <p align="center">
-    <img alt="Overview of related repositories" src="https://raw.githubusercontent.com/PMeira/dss_sharp/master/docs/images/repomap.svg?sanitize=true" width=600>
+    <img alt="Overview of related repositories" src="https://raw.githubusercontent.com/dss-extensions/dss_capi/master/docs/images/repomap.png" width=600>
 </p>
 
-Previously, the source code here was hosted in https://github.com/PMeira/dss_capi/ itself. 
+If you are looking for the bindings to other languages:
+
+- [DSS C-API library](http://github.com/dss-extensions/dss_capi/): the base library that exposes a modified version of EPRI's OpenDSS through a more traditional C interface, built with the open-source Free Pascal compiler instead of Delphi. As of 2022, this base library includes several extensive changes, while retaining very good compatibility.
+- [DSS Python](http://github.com/dss-extensions/dss_python/) is a multi-platform Python module (Windows, Linux, MacOS) very compatible with the original COM DLL. See also [OpenDSSDirect.py](http://github.com/dss-extensions/OpenDSSDirect.py/) if you don't need COM compatibility, or just would like to check its extra functionalities (you can mix DSS Python and OpenDSSDirect.py). DSS Python includes preliminary plotting capabilites.
+[`opendssdirect.utils`](https://dss-extensions.org/OpenDSSDirect.py/opendssdirect.html#module-opendssdirect.utils) to generate some DataFrames.
+- [OpenDSSDirect.jl](http://github.com/dss-extensions/OpenDSSDirect.jl/): a Julia module, created by Tom Short (@tshort), recently migrated with the help of Dheepak Krishnamurthy (@kdheepak) to DSS C-API instead of the DDLL.
+- [DSS MATLAB](http://github.com/dss-extensions/dss_matlab/): presents multi-platform integration (Windows, Linux, MacOS) with DSS C-API and is also very compatible with the COM classes.
+
+# Documentation
 
-This code will be refactored and benchmarked, hence it's better to use a separate repository.
+We will grow general documentation at https://github.com/dss-extensions/dss-extensions
 
+Currently, users can rely on the official OpenDSS COM documentation (as seen in the official installation and from the [SVN repo](https://sourceforge.net/p/electricdss/code/HEAD/tree/trunk/Version8/Distrib/Doc/)). We provide C#/.NET class library docs at https://dss-extensions.org/dss_sharp/