Some minor docstring/readme updates

This commit is contained in:
Jan Petykiewicz 2020-04-17 13:51:43 -07:00
parent b5a7c9a7ad
commit 58b4f4a40f
2 changed files with 12 additions and 6 deletions

View File

@ -1,4 +1,4 @@
# fatamorgana # fatamorgana
**fatamorgana** is a Python package for reading and writing OASIS format layout files. **fatamorgana** is a Python package for reading and writing OASIS format layout files.
@ -6,7 +6,7 @@
**Capabilities:** **Capabilities:**
* This package is a work-in-progress and is largely untested -- it works for * This package is a work-in-progress and is largely untested -- it works for
the tasks I usually use it for, but I can't guarantee I've even the tasks I usually use it for, but I can't guarantee I've even
tried the features you happen to use! Use at your own risk! tried the features you happen to use! Use at your own risk!
* Interfaces and datastructures are subject to change! * Interfaces and datastructures are subject to change!
* That said the following work for me: * That said the following work for me:
@ -26,12 +26,12 @@
Install with pip from PyPi (preferred): Install with pip from PyPi (preferred):
```bash ```bash
pip install fatamorgana pip3 install fatamorgana
``` ```
Install directly from git repository: Install directly from git repository:
```bash ```bash
pip install git+https://mpxd.net/code/jan/fatamorgana.git@release pip3 install git+https://mpxd.net/code/jan/fatamorgana.git@release
``` ```
## Documentation ## Documentation
@ -53,7 +53,7 @@ Read an OASIS file and write it back out:
with open('test.oas', 'rb') as f: with open('test.oas', 'rb') as f:
layout = fatamorgana.OasisLayout.read(f) layout = fatamorgana.OasisLayout.read(f)
with open('test_write.oas', 'wb') as f: with open('test_write.oas', 'wb') as f:
layout.write(f) layout.write(f)
``` ```

View File

@ -16,7 +16,13 @@
Dependencies: Dependencies:
- Python 3.5 or later - Python 3.5 or later
- numpy (optional, no additional functionality) - numpy (optional, faster but no additional functionality)
To get started, try:
```python3
import fatamorgana
help(fatamorgana.OasisLayout)
```
""" """
import pathlib import pathlib