Metadata-Version: 2.4
Name: e3series
Version: 26.30.0
Summary: Python wrapper and utilities for the E3.series COM interface.
Project-URL: Homepage, https://www.zuken.com/e3series
Project-URL: Issues, https://support.zuken.com/global/
Project-URL: Documentation, https://github.com/Zuken-E3-GmbH/E3SeriesPythonExamples/tree/main
Author-email: Zuken E3 GmbH <e3-support@de.zuken.com>
License-File: LICENSE
Keywords: CAE,E3.series,E3.series COM interface,ECAD,Electrical CAD,Electrical CAD scripting,Electrical cabinet,Electrical engineering,Formboard,Harness,Zuken
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
Requires-Python: >=3.9
Requires-Dist: psutil>=5.7.3
Requires-Dist: pywin32>=306
Requires-Dist: typing-extensions>=4.13.1
Provides-Extra: projectdata
Requires-Dist: flatbuffers; extra == 'projectdata'
Description-Content-Type: text/markdown

# Python wrapper for the E3.series API

python e3series is a wrapper library for the E3.series API.
The library enhances the automatic code completion and static program verification for python programs that automate E3.series.

This library requires a working instance of the software Zuken E3.series.

## Getting Started

### Which  version to install

The first two sections of the E3.series python libraries version are equal to the version of E3.series version they are meant to be used with.
Which means, it is best to use a library version 26.21.XX with a E3.series version 26.21. It is possible to a library version that does not match your E3.series version. 

If the version of the library is higher than the version of your E3.series version the library may contain functions your E3.series does not support. In this case you will get an exception whn using such a function. This can be avoided by checking the minimum version required by the function, which is given at the bottom of tooltip of each function.

If the version of your E3.series is higher than the version of your library there might be some functions the library does not support. In this case you cannot use those functions via the library. It is also important to note that, in addition to COM functions, newer versions of the library provide further independent functionality. In addition there might be some bugfixes available only in newer versions.

Some examples:
| E3.series version | Python library version |  |
| --- | --- | --- |
| 23.20 | 26.10.0 | The library works for every function supported in E3.series 23.20. It will raise an excption for unsupported functioality. For example dbe.CreateDbeJobObject() |
| 26.10 | 26.10.0 | Everything in the library is supported by E3.series 26.10, and all functios in E3.series 26.10 are supported by the library. But e3series.tools.Translation is not contained and there might be unfixed bugs. |
| 26.21 | 26.10.0 | All function in the E3.series version are available in the library. There might be functions in the library that are unsupported by your E3.series version. Using them leads to an exception. |

### Installing the library

If neccessary activate your virtual environment first. To do so open your powershell and run "activate":
    
    .\.venv\Scripts\activate

Afterwards your powershell should look like this (note the .venv on the left side):

    (.venv) C:\your\active\path\>

Pip will install the package to the currently active virtual enironment. If none was activated the package will be installed to the global environment of your active python installation.
If you have installed multiple python installations you can find the active one by executing

    Get-Command python

or

    (Get-Command python).path

to get only the path.

**From Pypi**

    pip install e3series

**From local file**

    pip install --force-reinstall "C:\Users\<user>\Downloads\e3series-26.0.0.tar.gz"

The option "--force-reinstall" ensures the package is reinstalled, even if it already is up to date

**Install a specific version**

    pip install --force-reinstall "e3series==26.10.0"

In the given example the --force-reinstall ensures to install the specified package even if there is a newer version already installed.
By adding "=26.10.0" the version to install in specified.

### Using the library

Use the library:
```python
import e3series as e3

app = e3.Application()
app.PutInfo(0, "hello, world!")
```

The documentation is currently optimised for use with VSCode and may appear poorly formatted in other IDEs.

For more samples you can visit the git repository [https://github.com/Zuken-E3-GmbH/E3SeriesPythonExamples](https://github.com/Zuken-E3-GmbH/E3SeriesPythonExamples).

The Changelog can also be found on github: [Link](https://github.com/Zuken-E3-GmbH/E3SeriesPythonExamples/tree/main/Changelog)