Skip to content

Commit 657df58

Browse files
authored
Merge pull request #7 from michaeltryby/master
Moving files into subfolder
2 parents dcfc375 + 03ed564 commit 657df58

File tree

10 files changed

+937
-920
lines changed

10 files changed

+937
-920
lines changed

README.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,17 @@
11
# epanet-python
2-
python wrapper for epanet library
3-
Works with both Python 2.7 and 3.x
2+
Is home for Python packages related to the EPANET engine.
43

5-
## epamodule
6-
A Python module that permits Epanet toolkit library calls from pure Python programs.
7-
Dropped interface generated by ctypesgen from epanet2.h (beacause not working with 2.x and 3.x)
4+
## Contents
5+
*epanet-module - A ctypes based wrapper for the EPANET Toolkit (with support for reading EPANET binary output files).
6+
*epanet-output - A SWIG based wrapper for the EPANET C Output library.
7+
*epanet-toolkit - A SWIG based wrapper for the EPANET Toolkit.
8+
*nrtest-epanet - A plugin for performing numerical regression tests on EPANET (requires epanet-output).
9+
* ...
810

9-
Example2.py is example2.c from toolkit help rewritten in Python as example of epamodule use.
11+
## Motivation
12+
These Python wrappers for EPANET are available to developers interested in building higher level functionality on top. Starting with a clean, auto-generated python API wrapper is a good foundation for building more abstractions. This also intersects with the near-term needs of the GUI work (which uses python and QT) - SWIG-wrapping will mean that the epanet library becomes scriptable from within the GUI.
1013

11-
## outbin
12-
Python module for reading EpanetBinaryOutputFiles in OO mode
13-
See help of class EpanetOutBin.
14-
At present it is a self contained pure Py module: a partial rewriting is planned
15-
in a near future for use of outputapi C library.
14+
Another benefit of auto-generating the wrapper is that it's fairly unambiguous; nobody's personal preferences get involved until we get to slightly higher-level abstractions, but everyone can share and benefit from the foundational SWIG layer.
15+
16+
## Contributing
17+
There are many ways for those interested in contributing to participate - providing software development support, helping with documentation, finding bugs, or contributing feature requests. Feel free to get involved!
File renamed without changes.

epanet-module/README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# epanet-python
2+
python wrapper for epanet library
3+
Works with both Python 2.7 and 3.x
4+
5+
## epamodule
6+
A Python module that permits Epanet toolkit library calls from pure Python programs.
7+
Dropped interface generated by ctypesgen from epanet2.h (beacause not working with 2.x and 3.x)
8+
9+
Example2.py is example2.c from toolkit help rewritten in Python as example of epamodule use.
10+
11+
## outbin
12+
Python module for reading EpanetBinaryOutputFiles in OO mode
13+
See help of class EpanetOutBin.
14+
At present it is a self contained pure Py module: a partial rewriting is planned
15+
in a near future for use of outputapi C library.

0 commit comments

Comments
 (0)