flowgraph 0.1.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. flowgraph/__init__.py +9 -0
  2. flowgraph/__main__.py +6 -0
  3. flowgraph/adapters/__init__.py +141 -0
  4. flowgraph/adapters/controls.py +96 -0
  5. flowgraph/adapters/cosapp.py +195 -0
  6. flowgraph/adapters/data_types.py +59 -0
  7. flowgraph/adapters/documentation.py +45 -0
  8. flowgraph/adapters/field_ops.py +121 -0
  9. flowgraph/adapters/file_conversion.py +393 -0
  10. flowgraph/adapters/files.py +191 -0
  11. flowgraph/adapters/filters.py +173 -0
  12. flowgraph/adapters/image_tools.py +394 -0
  13. flowgraph/adapters/mesh_creation_tools.py +431 -0
  14. flowgraph/adapters/mesh_generations.py +58 -0
  15. flowgraph/adapters/mesh_ops.py +362 -0
  16. flowgraph/adapters/paraview.py +39 -0
  17. flowgraph/adapters/plaid_bridge.py +205 -0
  18. flowgraph/adapters/readers.py +215 -0
  19. flowgraph/adapters/remote_files.py +118 -0
  20. flowgraph/adapters/simple_sources.py +199 -0
  21. flowgraph/adapters/sinks.py +80 -0
  22. flowgraph/adapters/user_code.py +196 -0
  23. flowgraph/adapters/workflow.py +176 -0
  24. flowgraph/adapters/workflow_interfaces.py +78 -0
  25. flowgraph/adapters/writers.py +159 -0
  26. flowgraph/application/__init__.py +1 -0
  27. flowgraph/application/node_registry.py +14 -0
  28. flowgraph/application/port_conversions.py +63 -0
  29. flowgraph/application/wasm_execution.py +132 -0
  30. flowgraph/application/workflow_cli.py +417 -0
  31. flowgraph/application/workflow_core.py +1193 -0
  32. flowgraph/application/workflow_history.py +93 -0
  33. flowgraph/application/workflow_io.py +393 -0
  34. flowgraph/application/workflow_layout.py +170 -0
  35. flowgraph/application/workflow_web_catalog.py +143 -0
  36. flowgraph/application/workflows.py +7 -0
  37. flowgraph/core_cli.py +81 -0
  38. flowgraph/domain/__init__.py +5 -0
  39. flowgraph/domain/mesh_document.py +91 -0
  40. flowgraph/examples/AllFilters.py +19 -0
  41. flowgraph/examples/convert_format.py +21 -0
  42. flowgraph/resources.py +29 -0
  43. flowgraph/testdata/AllFilters.json +390 -0
  44. flowgraph/testdata/FlowGraph.h5 +0 -0
  45. flowgraph/testdata/FlowGraph.stl +0 -0
  46. flowgraph/testdata/FlowGraph.xdmf +22 -0
  47. flowgraph/testdata/SimpleReadMesh.json +70 -0
  48. flowgraph/testdata/SpherePoints.csv +83 -0
  49. flowgraph/testdata/muscat-muscat-mesh-conversion.json +101 -0
  50. flowgraph/version.py +3 -0
  51. flowgraph-0.1.2.dist-info/METADATA +150 -0
  52. flowgraph-0.1.2.dist-info/RECORD +56 -0
  53. flowgraph-0.1.2.dist-info/WHEEL +5 -0
  54. flowgraph-0.1.2.dist-info/entry_points.txt +2 -0
  55. flowgraph-0.1.2.dist-info/licenses/LICENSE +29 -0
  56. flowgraph-0.1.2.dist-info/top_level.txt +1 -0
@@ -0,0 +1,150 @@
1
+ Metadata-Version: 2.4
2
+ Name: flowgraph
3
+ Version: 0.1.2
4
+ Summary: Headless typed workflow engine and execution runtime
5
+ Author: Felipe Bordeu
6
+ Maintainer: Felipe Bordeu
7
+ License-Expression: BSD-3-Clause
8
+ Project-URL: Homepage, https://github.com/FBW-Engineering-Solutions/FlowGraph
9
+ Project-URL: Repository, https://github.com/FBW-Engineering-Solutions/FlowGraph.git
10
+ Project-URL: Issues, https://github.com/FBW-Engineering-Solutions/FlowGraph/issues
11
+ Keywords: workflow,graph,mesh,scientific-computing,automation
12
+ Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Intended Audience :: Science/Research
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Programming Language :: Python :: 3.13
19
+ Classifier: Programming Language :: Python :: 3.14
20
+ Classifier: Operating System :: OS Independent
21
+ Classifier: Topic :: Scientific/Engineering
22
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
+ Requires-Python: >=3.11
24
+ Description-Content-Type: text/markdown
25
+ License-File: LICENSE
26
+ Requires-Dist: vtk>=9.2
27
+ Requires-Dist: muscat>=2.5.2
28
+ Requires-Dist: meshio>=5.3
29
+ Requires-Dist: meshlane>=5.5.0
30
+ Requires-Dist: scipy>=1.10
31
+ Requires-Dist: pandas
32
+ Requires-Dist: h5py
33
+ Requires-Dist: pillow>=10.0
34
+ Provides-Extra: dev
35
+ Requires-Dist: pytest>=8.0; extra == "dev"
36
+ Requires-Dist: pytest-cov>=5.0; extra == "dev"
37
+ Requires-Dist: ruff>=0.6; extra == "dev"
38
+ Provides-Extra: ml
39
+ Requires-Dist: pyplaid; extra == "ml"
40
+ Provides-Extra: cosapp
41
+ Requires-Dist: cosapp>=1.6.1; extra == "cosapp"
42
+ Provides-Extra: ci
43
+ Requires-Dist: cosapp>=1.6.1; extra == "ci"
44
+ Requires-Dist: pycgns; extra == "ci"
45
+ Dynamic: license-file
46
+
47
+ # FlowGraph Core
48
+
49
+ `FlowGraph` is the GUI-free Python workflow engine. It provides typed workflow
50
+ composition, validation, persistence, execution, adapters, mesh and image data
51
+ operations, browser-WASM execution support, and metadata-only catalog export
52
+ for compatible external clients.
53
+
54
+ > **Alpha status:** FlowGraph Core `0.1.x` is an alpha series for evaluation,
55
+ > development, experimentation, and early adopter feedback. APIs and workflow
56
+ > behavior may change before `1.0.0`. See [`Release Policy`](docs/policies/release-policy.md).
57
+
58
+ ## Development
59
+
60
+ ```bash
61
+ uv sync --extra dev
62
+ uv run pytest
63
+ uv run ruff check .
64
+ ```
65
+
66
+ See [`Contributing`](.github/CONTRIBUTING.md) for prerequisites, development
67
+ workflow, testing, documentation, and pull-request expectations.
68
+
69
+ ## Headless workflows
70
+
71
+ The `flowgraph` command is headless and has no GUI runtime dependency:
72
+
73
+ ```bash
74
+ uv run flowgraph inspect workflow.json
75
+ uv run flowgraph run workflow.json --input name=value
76
+ uv run flowgraph run workflow.json --override node-id.parameter=value
77
+ uv run flowgraph run workflow.json --json-output results.json
78
+ ```
79
+
80
+ Workflows use the versioned `flowgraph-workflow` JSON format. Core validation and
81
+ execution are UI-independent.
82
+
83
+ ## Package artifacts
84
+
85
+ Build the portable, pure-Python source distribution and wheel with:
86
+
87
+ ```bash
88
+ uv build --out-dir dist/
89
+ ```
90
+
91
+ The resulting wheel is compatible with all supported Python platforms. See
92
+ `packaging/README.md` for release details.
93
+
94
+ The initial supported publication channels are GitHub source releases and
95
+ PyPI. Conda, Docker, operating-system package managers, and third-party mirrors
96
+ are not supported release channels at this time. See
97
+ [`Release Channels`](docs/policies/release-channels.md) for the release policy.
98
+
99
+ FlowGraph Core declares Python 3.11 or newer. CI covers Python 3.11 and 3.13 on
100
+ GitHub-hosted Ubuntu, Windows, and macOS runners; a platform/version combination
101
+ is supported only after its release-candidate job passes. See
102
+ [`Support Policy`](docs/policies/support-policy.md) for compatibility, deprecation,
103
+ maintenance, and unsupported-use policies.
104
+
105
+ ## Catalog export
106
+
107
+ FlowGraph can export non-executable node metadata for tools that need to author
108
+ or structurally validate workflow JSON:
109
+
110
+ ```bash
111
+ uv run python -m flowgraph.application.workflow_web_catalog node-catalog.json
112
+ ```
113
+
114
+ The catalog intentionally excludes node executors and other callable runtime
115
+ behavior.
116
+
117
+ ## Documentation and support
118
+
119
+ - [`Architecture`](docs/architecture.md) describes the core boundaries and workflow
120
+ model.
121
+ - [`Support Policy`](docs/policies/support-policy.md) describes supported environments and
122
+ compatibility expectations.
123
+ - [`SECURITY.md`](SECURITY.md) explains private vulnerability reporting and the
124
+ security boundaries of workflows and adapters.
125
+ - [`Changelog`](docs/changelog.md) records release changes and known limitations.
126
+ - [`docs/workflow-format.md`](docs/workflow-format.md) documents persistence,
127
+ compatibility, and capability boundaries.
128
+
129
+ ## Optional integrations
130
+
131
+ The `ml` extra enables the PyPlaid adapter and the `cosapp` extra enables the
132
+ CoSApp adapter. Neither extra is part of the minimum core support guarantee.
133
+ Install an extra only when its upstream dependency, license terms, platform
134
+ requirements, and integration behavior have been reviewed for the target
135
+ release:
136
+
137
+ ```bash
138
+ uv sync --extra ml
139
+ uv sync --extra cosapp
140
+ ```
141
+
142
+ Optional adapters may execute external tools or user-provided models. Treat
143
+ their workflows as trusted input and test the exact dependency versions before
144
+ production use.
145
+
146
+ ## License
147
+
148
+ FlowGraph Core is licensed under the [BSD 3-Clause License](LICENSE). Release
149
+ compliance requires review of the exact dependency lockfile, build artifacts,
150
+ third-party notices, native dependencies, and applicable license obligations.
@@ -0,0 +1,56 @@
1
+ flowgraph/__init__.py,sha256=zsu9cVB6H9l4ck5hfE4qhDnZ6xA9WRbsjbjGBndBH-A,190
2
+ flowgraph/__main__.py,sha256=ANziOuUQAoXcE58F7cEDfMosDgZtOQp-_Aro2u-aUb0,163
3
+ flowgraph/core_cli.py,sha256=YQe0bvdkXtkACeny2wuR-OvZ56Te7hdr_SX_NTKoLq0,2686
4
+ flowgraph/resources.py,sha256=liGLUhOUeFgAgdIxSuxse7dXXEn6qMycfl5wZlj9Z8U,1137
5
+ flowgraph/version.py,sha256=479EZm3wP5kkx1q4DmA9sVdD16VBg5ZTI5lZRgU1It4,64
6
+ flowgraph/adapters/__init__.py,sha256=UHAlI9Jeiq8Wp5MGoR9Du4OgGr5sPI50rG_Q40ZY8Pk,5460
7
+ flowgraph/adapters/controls.py,sha256=ot3wnwiuaMBMLV_hgRUTKUHA0nLdV785skS1N2IH-GA,3454
8
+ flowgraph/adapters/cosapp.py,sha256=wugCV3gZahEiA0JE7lxVMhYs48Dn_y_v4g85Fx_5haQ,7466
9
+ flowgraph/adapters/data_types.py,sha256=bjQ5WEsR5I6g0iO48XEL-BU89DdpLOi660O_yzG42c8,2048
10
+ flowgraph/adapters/documentation.py,sha256=4XX5twFyXkjBUMnmY7d85mxKAqx5uxacL4e-0iOsSMk,1040
11
+ flowgraph/adapters/field_ops.py,sha256=uHXvh5k7uQHz1Fgvp9P3UgK97JN5j-KCom4UCn0j4wQ,4796
12
+ flowgraph/adapters/file_conversion.py,sha256=r2aYhnYqfHKdk-i41QQsvjbJlnL8Y7xjLMmHibtf3Ko,23687
13
+ flowgraph/adapters/files.py,sha256=WNnPw1gM1s-UiFAanBqhuIZVANyStGdq115O6pBp9G0,6283
14
+ flowgraph/adapters/filters.py,sha256=3w1An2xfktD-_CVKUSSXxH5-7XQSfrotnBNdiInWq80,5840
15
+ flowgraph/adapters/image_tools.py,sha256=7jnfKJ6UY7JmwlyPTrQ3G4TQV16BJqwmGT6w-Yd6LUk,13905
16
+ flowgraph/adapters/mesh_creation_tools.py,sha256=njuonmU6wvilYiETTYI_jWLIEDfEhz99qBNjWOZ8Has,14621
17
+ flowgraph/adapters/mesh_generations.py,sha256=GRaiMvlUUMijOWHtT6rb-7iD7pYxIHg9vhRbMuCoaNk,1574
18
+ flowgraph/adapters/mesh_ops.py,sha256=hjVsWmQcIbTKEX9xZXEXpCvxyeQ8hUok7FTrgzUpHu4,14260
19
+ flowgraph/adapters/paraview.py,sha256=_xjIujvqF2pk-pVSM7hFvT5rl1ud6BkR0r_4ozCMEn8,1118
20
+ flowgraph/adapters/plaid_bridge.py,sha256=XhyawVK5p1ksOLjG6t-UU2CFTcyT9tHUziwStjDVYks,7875
21
+ flowgraph/adapters/readers.py,sha256=6wEylG-6J7HvVyMlq409j39k3HReYFv-Ehh-Os6ma7s,7279
22
+ flowgraph/adapters/remote_files.py,sha256=3pZFYomutkDFLOnRq3S2stmSmfBT8GqkkUl7wIrvMHE,3930
23
+ flowgraph/adapters/simple_sources.py,sha256=Nnm70o1xiKZWFWXATLfG0OLzUlAc76OfwteIlPRDCvQ,7594
24
+ flowgraph/adapters/sinks.py,sha256=bDCkTVsO1w7jFWdDEhfvywhc6sF6jUZl21OL0D51lyQ,2307
25
+ flowgraph/adapters/user_code.py,sha256=RmrK8PVVAVxNPMen13t8vQgyKyurpsGLTPomReEZmyE,7226
26
+ flowgraph/adapters/workflow.py,sha256=T9RqrIeqFCJxuZ5wpiAvob1SI6cWDZFMrYV2_sy-VS4,6109
27
+ flowgraph/adapters/workflow_interfaces.py,sha256=FMl2ktQbRY8QXG5a5jR0sBwSNsjQ3bMPbLaZ7pJtuvU,2091
28
+ flowgraph/adapters/writers.py,sha256=LcoOX0QLcbB9xw9M_Cm6D2xCCKEEV2jtmtiLXxSuhZQ,5740
29
+ flowgraph/application/__init__.py,sha256=66RyuE0lr3x2yM2BsXCmFp_FWNPxOkZldZfRJPU7140,72
30
+ flowgraph/application/node_registry.py,sha256=GWX8OQ4V_wVeQjvEnw_iBPyW2WCVFmH5XmzrdIGj9ho,465
31
+ flowgraph/application/port_conversions.py,sha256=YHi1T56TYo2gunpcGht4QbwbjlDl6NGCFALJDko5qvQ,1923
32
+ flowgraph/application/wasm_execution.py,sha256=DGt9tpTvCSdmeMU_N5juJ0QYkH3GmFG6INfGQsVauvc,5095
33
+ flowgraph/application/workflow_cli.py,sha256=IRynrVuUOAzQ2EdFddoDO-SkbImJk1PvGawL22JA85E,16099
34
+ flowgraph/application/workflow_core.py,sha256=i_C8NJHTOQG9cnP5Rd82LqI-qndOONuLmOy7TYHjlcc,46593
35
+ flowgraph/application/workflow_history.py,sha256=wMQlbmkxEGllnplMWiqpXuBeWh0yHA7ploVu8WA-arg,2755
36
+ flowgraph/application/workflow_io.py,sha256=mGi-Xkraiu6K9RHsG9LQDcLqCzZh5EISsYfJw-42BrM,16465
37
+ flowgraph/application/workflow_layout.py,sha256=gCUNIMbg-czceNNPnbzGMDEiFdI9Rmcr7-A7Q0FcWnc,6796
38
+ flowgraph/application/workflow_web_catalog.py,sha256=29j4j-pBfNkgvbzQGS0jA-1JC8JXAcDkZh1psVmFtco,5138
39
+ flowgraph/application/workflows.py,sha256=BQdi-ApNyuNqPB1sXt0JnxjaO9yR4epBMM67CcwXQx0,205
40
+ flowgraph/domain/__init__.py,sha256=VZNM6JSED5RXd3GeOHroYC0HdmiKEUgV5RB9YMBgypU,127
41
+ flowgraph/domain/mesh_document.py,sha256=oqsuTDfL1us2qlTMM7qm8JrTzgSbZw8dsypQyjwLDqM,3142
42
+ flowgraph/examples/AllFilters.py,sha256=cAQlxZe7PJvh8hAN7iV6PMC2_6OCHI81WITBI8CXgxA,521
43
+ flowgraph/examples/convert_format.py,sha256=DMQJaCefsfUvOUTgBOTK2GKXhIhNtzSsYZ9tB9-_i24,636
44
+ flowgraph/testdata/AllFilters.json,sha256=TdI4GJKHnaxbeOcqq4KCNuWqwlOFBad59r0SKHuD1jc,8619
45
+ flowgraph/testdata/FlowGraph.h5,sha256=uYk8ISxfgVYhi205w7cJiglyKmrBLJtZsKh1hJXfOEs,1046104
46
+ flowgraph/testdata/FlowGraph.stl,sha256=I3XsdFztzj1qNPCw-01eq3mDgJ8kNcSRUefjEoW9zhE,811384
47
+ flowgraph/testdata/FlowGraph.xdmf,sha256=lryt5z4WKV524j-NJ8PS9KP5URfIPVTF1UOCwzSUbVA,1271
48
+ flowgraph/testdata/SimpleReadMesh.json,sha256=TKz0JO-g8f2ftTEKZBj_Ep4P4RjeG76RrR86RYCQADg,1530
49
+ flowgraph/testdata/SpherePoints.csv,sha256=Iivh1qjE4aBhAfv1pNmygRAbn_Kkd90tDCdvLKx-Lvc,5123
50
+ flowgraph/testdata/muscat-muscat-mesh-conversion.json,sha256=GokJUi5QFjlR9y5jwDRjKqKWR3Hqf4BBB8UCqxSwF60,2119
51
+ flowgraph-0.1.2.dist-info/licenses/LICENSE,sha256=9oMkzZ2BxFVBWUjR6gvM65C8oeLJBrELUkCp9SVUCYs,1520
52
+ flowgraph-0.1.2.dist-info/METADATA,sha256=PEWeKPH0hP4Ln_4accOm4OZ9BdxYXMKlD6zide5UNs0,5561
53
+ flowgraph-0.1.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
54
+ flowgraph-0.1.2.dist-info/entry_points.txt,sha256=OQpXDhKRTUTSH-TbrP_d2I79Jw5W0RlPcYsZt_xopSE,54
55
+ flowgraph-0.1.2.dist-info/top_level.txt,sha256=-tjxx6w_V-3Dh01OmyY-ayst6EmeSefGlA4EQ6T5XeI,10
56
+ flowgraph-0.1.2.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (84.0.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ flowgraph = flowgraph.core_cli:main
@@ -0,0 +1,29 @@
1
+ BSD 3-Clause License
2
+
3
+ Copyright (c) 2026, Felipe Bordeu
4
+ All rights reserved.
5
+
6
+ Redistribution and use in source and binary forms, with or without
7
+ modification, are permitted provided that the following conditions are met:
8
+
9
+ 1. Redistributions of source code must retain the above copyright notice, this
10
+ list of conditions and the following disclaimer.
11
+
12
+ 2. Redistributions in binary form must reproduce the above copyright notice,
13
+ this list of conditions and the following disclaimer in the documentation
14
+ and/or other materials provided with the distribution.
15
+
16
+ 3. Neither the name of the copyright holder nor the names of its
17
+ contributors may be used to endorse or promote products derived from
18
+ this software without specific prior written permission.
19
+
20
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
23
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
24
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
26
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
27
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
28
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
@@ -0,0 +1 @@
1
+ flowgraph