feldera 0.129.0__py3-none-any.whl → 0.131.0__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.
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: feldera
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.131.0
|
|
4
4
|
Summary: The feldera python client
|
|
5
5
|
Author-email: Feldera Team <dev@feldera.com>
|
|
6
6
|
License: MIT
|
|
@@ -59,6 +59,12 @@ source .venv/activate
|
|
|
59
59
|
uv pip install .
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
+
You also have to install the `pytest` module:
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
python3 -m pip install pytest
|
|
66
|
+
```
|
|
67
|
+
|
|
62
68
|
## Documentation
|
|
63
69
|
|
|
64
70
|
The Python SDK documentation is available at
|
|
@@ -78,73 +84,6 @@ make html
|
|
|
78
84
|
|
|
79
85
|
To clean the build, run `make clean`.
|
|
80
86
|
|
|
81
|
-
## Testing
|
|
82
|
-
|
|
83
|
-
To run unit tests:
|
|
84
|
-
|
|
85
|
-
```bash
|
|
86
|
-
cd python && python3 -m pytest tests/
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
- This will detect and run all test files that match the pattern `test_*.py` or
|
|
90
|
-
`*_test.py`.
|
|
91
|
-
- By default, the tests expect a running Feldera instance at `http://localhost:8080`.
|
|
92
|
-
To override the default endpoint, set the `FELDERA_HOST` environment variable.
|
|
93
|
-
|
|
94
|
-
To run tests from a specific file:
|
|
95
|
-
|
|
96
|
-
```bash
|
|
97
|
-
(cd python && python3 -m pytest ./tests/path-to-file.py)
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
To run a specific test:
|
|
101
|
-
|
|
102
|
-
```bash
|
|
103
|
-
uv run python -m pytest tests/test_shared_pipeline.py::TestPipeline::test_adhoc_query_hash -v
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
#### Running All Tests
|
|
107
|
-
|
|
108
|
-
The tests validate end-to-end correctness of SQL functionality. To
|
|
109
|
-
run the tests use:
|
|
110
|
-
|
|
111
|
-
```bash
|
|
112
|
-
cd python
|
|
113
|
-
PYTHONPATH=`pwd` ./tests/run-all-tests.sh
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
### Reducing Compilation Cycles
|
|
117
|
-
|
|
118
|
-
To reduce redundant compilation cycles during testing:
|
|
119
|
-
|
|
120
|
-
* **Inherit from `SharedTestPipeline`** instead of `unittest.TestCase`.
|
|
121
|
-
* **Define DDLs** (e.g., `CREATE TABLE`, `CREATE VIEW`) in the **docstring** of each test method.
|
|
122
|
-
* All DDLs from all test functions in the class are combined and compiled into a single pipeline.
|
|
123
|
-
* If a table or view is already defined in one test, it can be used directly in others without redefinition.
|
|
124
|
-
* Ensure that all table and view names are unique within the class.
|
|
125
|
-
* Use `@enterprise_only` on tests that require Enterprise features. Their DDLs will be skipped on OSS builds.
|
|
126
|
-
* Use `self.set_runtime_config(...)` to override the default pipeline config.
|
|
127
|
-
* Reset it at the end using `self.reset_runtime_config()`.
|
|
128
|
-
* Access the shared pipeline via `self.pipeline`.
|
|
129
|
-
|
|
130
|
-
#### Example
|
|
131
|
-
|
|
132
|
-
```python
|
|
133
|
-
from tests.shared_test_pipeline import SharedTestPipeline
|
|
134
|
-
|
|
135
|
-
class TestAverage(SharedTestPipeline):
|
|
136
|
-
def test_average(self):
|
|
137
|
-
"""
|
|
138
|
-
CREATE TABLE students(id INT, name STRING);
|
|
139
|
-
CREATE MATERIALIZED VIEW v AS SELECT * FROM students;
|
|
140
|
-
"""
|
|
141
|
-
...
|
|
142
|
-
self.pipeline.start()
|
|
143
|
-
self.pipeline.input_pandas("students", df)
|
|
144
|
-
self.pipeline.wait_for_completion(True)
|
|
145
|
-
...
|
|
146
|
-
```
|
|
147
|
-
|
|
148
87
|
## Linting and formatting
|
|
149
88
|
|
|
150
89
|
Use [Ruff] to run the lint checks that will be executed by the
|
|
@@ -17,7 +17,7 @@ feldera/rest/feldera_config.py,sha256=1pnGbLFMSLvp7Qh_OlPLALSKCSHIktNWKvx6gYU00U
|
|
|
17
17
|
feldera/rest/pipeline.py,sha256=Rmbflbwjvd86iZ5aSJ5b_bTSs6vgvEKQFwMZDtm0nxE,2835
|
|
18
18
|
feldera/rest/sql_table.py,sha256=qrw-YwMzx5T81zDefNO1KOx7EyypFz1vPwGBzSUB7kc,652
|
|
19
19
|
feldera/rest/sql_view.py,sha256=hN12mPM0mvwLCIPYywpb12s9Hd2Ws31IlTMXPriMisw,644
|
|
20
|
-
feldera-0.
|
|
21
|
-
feldera-0.
|
|
22
|
-
feldera-0.
|
|
23
|
-
feldera-0.
|
|
20
|
+
feldera-0.131.0.dist-info/METADATA,sha256=wqRKF-g1N0ZL6INiAWfBxw5BVyZzBzcroTzoUXSAaN8,2368
|
|
21
|
+
feldera-0.131.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
22
|
+
feldera-0.131.0.dist-info/top_level.txt,sha256=fB6yTqrQiO6RCbY1xP2T_mpPoTjDFtJvkJJodiee7d0,8
|
|
23
|
+
feldera-0.131.0.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|