Skip to content

Commit

Permalink
Add developer guide and api doc
Browse files Browse the repository at this point in the history
  • Loading branch information
eivindjahren committed Jun 25, 2022
1 parent 8666f10 commit 6aff2ba
Show file tree
Hide file tree
Showing 4 changed files with 40 additions and 2 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Getting started
===============

Ecl output files consist of a sequence of named arrays. ecl-data-io does not
interpret the names, but simply give you a touple of the name and a numpy array
interpret the names, but simply give you a tuple of the name and a numpy array
with the read function:

```
Expand Down
12 changes: 12 additions & 0 deletions docs/source/api_doc.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
API-Doc
=======

.. autofunction:: ecl_data_io.lazy_read

.. autofunction:: ecl_data_io.read

.. autofunction:: ecl_data_io.write

.. autoclass:: ecl_data_io.Format

.. autoclass:: ecl_data_io.MESS
26 changes: 26 additions & 0 deletions docs/source/developer_guide.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
Building from source and running the tests
==========================================

ecl-data-io is set up to use tox which can simplify development,
but all that is necessary in order to get started is git, pip and python:

First, install ecl-data-io in editable mode:

.. code-block:: console
git clone [email protected]:equinor/ecl-data-io.git
cd ecl-data-io
pip install -e .

Second, install the dev-requirements.txt, which contains the packages ecl-data-io
require in order to run tests:

.. code-block:: console
pip install -r dev-requirements.txt

At last, you can use pytest to run the tests

.. code-block:: console
pytest tests
2 changes: 1 addition & 1 deletion docs/source/example_usage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ and :meth:`ecl_data_io.write` functions:
read
----

The read function will open a given file and give you a list of touples
The read function will open a given file and give you a list of tuples
of the keywords and arrays.

>>> import ecl_data_io as eclio
Expand Down

0 comments on commit 6aff2ba

Please sign in to comment.