Skip to content

Commit aa8c94b

Browse files
committed
updated description and links
Updated links
1 parent 029b809 commit aa8c94b

File tree

2 files changed

+26
-7
lines changed

2 files changed

+26
-7
lines changed

README.md

Lines changed: 25 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,18 @@
11
# preCICE Config Graph
22

3-
A Python library that builds a graph from a preCICE configuration file for validation and visualization purposes.
3+
A Python library that builds a graph from a preCICE configuration file for validation and visualization purposes
4+
and enables to recreate a precice-config.xml from it.
45

5-
**How does this differ from [the preCICE Config-Visualizer](https://github.com/precice/config-visualizer)?** The graph built by this library is not (directly) meant to be displayed. The focus is on building a graph that represents the structure of a preCICE configuration in a way that is useful in checking for logical errors.
6+
**How does this differ from [the preCICE Config-Visualizer](https://github.com/precice/config-visualizer)?** The graph
7+
built by this library is not (directly) meant to be displayed. The focus is on building a graph that represents the
8+
structure of a preCICE configuration in a way that is useful in checking for logical errors.
9+
This logic can also be used to generate a precice-config.xml from a given set of nodes.
610

711
> [!NOTE]
812
> This library assumes the config file to follow some basic rules. For example, references by name are assumed to exist.
9-
> If the config file passes the preCICE-built-in checks (`precice-tools check`) without errors, then it is also read correctly by this library. If `precice-tools check` does not succeed, the behavior of this library is undefined (it will probably crash).
13+
> If the config file passes the preCICE-built-in checks (`precice-cli config check`) without errors, then it is also
14+
> read correctly by this library. If `precice-cli config check` does not succeed, the behavior of this library is
15+
> undefined (it will probably crash).
1016
1117
## Requirements
1218

@@ -18,16 +24,21 @@ A Python library that builds a graph from a preCICE configuration file for valid
1824
## Installation
1925

2026
1. Clone this repository:
27+
2128
```bash
2229
git clone https://github.com/precice/config-graph
2330
cd config-graph
2431
```
32+
2533
2. Create a new Python Virtual Environment (optional, but recommended):
34+
2635
```bash
2736
python -m venv venv
2837
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
2938
```
39+
3040
3. Install required dependencies:
41+
3142
```bash
3243
pip install .
3344
```
@@ -48,6 +59,7 @@ config-graph
4859
│ ├── edges.py # Definition of edge types
4960
│ ├── graph.py # Main logic for building the graph from parsed XML
5061
│ ├── nodes.py # Definition of node types
62+
│ ├── enums.py # Definition enums used for node-creation
5163
│ └── xml_processing.py # preCICE-specific utilities for reading XML files correctly
5264
5365
├── test # All files for automated testing
@@ -64,7 +76,14 @@ config-graph
6476

6577
## Using in your project
6678

67-
This library is not yet published to any package registry. Nonetheless, it can still be imported into your `pyproject.toml` like so:
79+
This library is published to PyPi as `precice-config-graph`.
80+
It can be installed via
81+
82+
```bash
83+
pip install precice-config-graph
84+
```
85+
86+
Otherwise, it can also be imported into your `pyproject.toml` like so:
6887

6988
```toml
7089
#
@@ -91,7 +110,8 @@ graph.print_graph(G)
91110

92111
## Debugging graph generation
93112

94-
This module includes a small utility that helps with debugging the output graph. You can pass a custom `precice-config.xml` and it displays the graph it built in a pop-up window.
113+
This module includes a small utility that helps with debugging the output graph. You can pass a custom
114+
`precice-config.xml` and it displays the graph it built in a pop-up window.
95115

96116
To get started, run
97117

pyproject.toml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,7 @@ dependencies = [
2121
]
2222

2323
[project.urls]
24-
Repository = "https://github.com/precice-forschungsprojekt/config-graph.git"
25-
Issues = "https://github.com/precice-forschungsprojekt/config-graph/issues"
24+
Repository = "https://github.com/precice/config-graph.git"
2625

2726
[tool.setuptools]
2827
packages = ["precice_config_graph"]

0 commit comments

Comments
 (0)