tinyflux 1.2.0__tar.gz → 1.2.1__tar.gz

{tinyflux-1.2.0/tinyflux.egg-info → tinyflux-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tinyflux
-Version: 1.2.0
+Version: 1.2.1
 Summary: The Tiny Time-Series Database Optimized for Your Happiness
 Home-page: https://github.com/citrusvanilla/tinyflux
 Author: Justin Fung
@@ -17,15 +17,16 @@ Classifier: Topic :: Database
 Classifier: Topic :: Database :: Database Engines/Servers
 Classifier: Topic :: Utilities
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Operating System :: OS Independent
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
@@ -37,7 +38,7 @@ Dynamic: license-file
 
 TinyFlux is the tiny time series database optimized for your happiness 😎
 
-TinyFlux is the time series version of [TinyDB](https://tinydb.readthedocs.io/en/latest/index.html) that is written in Python and has no external dependencies. It consistently writes atomically to file at over 6,000 writes per second and supports greater than 100 queries per second for time-based range queries on datasets up to 100,000 points. It's a perfect companion for small analytics workflows and apps, as well as at-home IOT data stores. TinyFlux has 100% test coverage, over 150,000 downloads, and no open issues.
+TinyFlux is the time series version of [TinyDB](https://tinydb.readthedocs.io/en/latest/index.html) that is written in Python and has no external dependencies. It consistently writes atomically to file at over 6,000 writes per second and supports greater than 100 queries per second for time-based range queries on datasets up to 100,000 points. It's a perfect companion for small analytics workflows and apps, as well as at-home IOT data stores. TinyFlux has 100% test coverage, over 200,000 downloads, and no open issues.
 
 [![Documentation](https://readthedocs.org/projects/tinyflux/badge/?version=latest)](https://tinyflux.readthedocs.io/en/latest/?badge=latest)
 [![Version](https://img.shields.io/pypi/v/tinyflux.svg)](https://pypi.org/project/tinyflux/)
@@ -59,6 +60,8 @@ Install from PyPI:
 pip install tinyflux
 ```
 
+TinyFlux supports CPython 3.10 through 3.15.
+
 ## Quick Start
 
 ```python
@@ -238,13 +241,11 @@ TinyFlux automatic indexing provides:
 
 ## TinyFlux Across the Internet
 
-- **IoT Sensor Networks**: Collect and analyze device telemetry
-- **System Monitoring**: Track server metrics and application performance  
-- **Financial Data**: Store and query stock prices, trading volumes
-- **Scientific Research**: Log experimental measurements and observations
-- **Web Analytics**: Time-stamped user interaction data
+Articles, tutorials, and other instances of TinyFlux in the wild:
 
-*Perfect for prototyping, edge computing, embedded systems, and applications where simplicity matters.*
+- ["Introducing TinyFlux: The Tiny Time Series Database for Python-based IoT & Analytics Applications"](https://citrusvanilla.medium.com/introducing-tinyflux-the-tiny-time-series-database-for-python-based-iot-analytics-applications-c3ef3c3bedf): A Medium.com article announcing the release of TinyFlux
+- ["Storing Time Series Data in Python Using TinyFluxDB"](http://www.steves-internet-guide.com/storing-time-series-data-python-using-tinyflux-db/): A tutorial from [Steve's Internet Guide](http://www.steves-internet-guide.com/), a portal for learning MQTT and IoT development for Python
+- ["KaiCode 2024 Shortlist"](https://www.kaicode.org/2024.html): TinyFlux came in 10th place out of 412 entrants in the 7th edition of this open-source festival, a festival dedicated to recognizing projects with high-quality open-source principles
 
 ## Contributing
 

{tinyflux-1.2.0 → tinyflux-1.2.1}/README.md

@@ -5,7 +5,7 @@
 
 TinyFlux is the tiny time series database optimized for your happiness 😎
 
-TinyFlux is the time series version of [TinyDB](https://tinydb.readthedocs.io/en/latest/index.html) that is written in Python and has no external dependencies. It consistently writes atomically to file at over 6,000 writes per second and supports greater than 100 queries per second for time-based range queries on datasets up to 100,000 points. It's a perfect companion for small analytics workflows and apps, as well as at-home IOT data stores. TinyFlux has 100% test coverage, over 150,000 downloads, and no open issues.
+TinyFlux is the time series version of [TinyDB](https://tinydb.readthedocs.io/en/latest/index.html) that is written in Python and has no external dependencies. It consistently writes atomically to file at over 6,000 writes per second and supports greater than 100 queries per second for time-based range queries on datasets up to 100,000 points. It's a perfect companion for small analytics workflows and apps, as well as at-home IOT data stores. TinyFlux has 100% test coverage, over 200,000 downloads, and no open issues.
 
 [![Documentation](https://readthedocs.org/projects/tinyflux/badge/?version=latest)](https://tinyflux.readthedocs.io/en/latest/?badge=latest)
 [![Version](https://img.shields.io/pypi/v/tinyflux.svg)](https://pypi.org/project/tinyflux/)
@@ -27,6 +27,8 @@ Install from PyPI:
 pip install tinyflux
 ```
 
+TinyFlux supports CPython 3.10 through 3.15.
+
 ## Quick Start
 
 ```python
@@ -206,13 +208,11 @@ TinyFlux automatic indexing provides:
 
 ## TinyFlux Across the Internet
 
-- **IoT Sensor Networks**: Collect and analyze device telemetry
-- **System Monitoring**: Track server metrics and application performance  
-- **Financial Data**: Store and query stock prices, trading volumes
-- **Scientific Research**: Log experimental measurements and observations
-- **Web Analytics**: Time-stamped user interaction data
+Articles, tutorials, and other instances of TinyFlux in the wild:
 
-*Perfect for prototyping, edge computing, embedded systems, and applications where simplicity matters.*
+- ["Introducing TinyFlux: The Tiny Time Series Database for Python-based IoT & Analytics Applications"](https://citrusvanilla.medium.com/introducing-tinyflux-the-tiny-time-series-database-for-python-based-iot-analytics-applications-c3ef3c3bedf): A Medium.com article announcing the release of TinyFlux
+- ["Storing Time Series Data in Python Using TinyFluxDB"](http://www.steves-internet-guide.com/storing-time-series-data-python-using-tinyflux-db/): A tutorial from [Steve's Internet Guide](http://www.steves-internet-guide.com/), a portal for learning MQTT and IoT development for Python
+- ["KaiCode 2024 Shortlist"](https://www.kaicode.org/2024.html): TinyFlux came in 10th place out of 412 entrants in the 7th edition of this open-source festival, a festival dedicated to recognizing projects with high-quality open-source principles
 
 ## Contributing
 

{tinyflux-1.2.0 → tinyflux-1.2.1}/setup.cfg

@@ -30,18 +30,19 @@ classifiers =
 	Topic :: Database :: Database Engines/Servers
 	Topic :: Utilities
 	Programming Language :: Python :: 3
-	Programming Language :: Python :: 3.9
 	Programming Language :: Python :: 3.10
 	Programming Language :: Python :: 3.11
 	Programming Language :: Python :: 3.12
 	Programming Language :: Python :: 3.13
+	Programming Language :: Python :: 3.14
+	Programming Language :: Python :: 3.15
 	Programming Language :: Python :: Implementation :: CPython
 	Operating System :: OS Independent
 	Typing :: Typed
 
 [options]
 packages = tinyflux
-python_requires = >=3.9
+python_requires = >=3.10
 
 [options.package_data]
 tinyflux = py.typed

{tinyflux-1.2.0 → tinyflux-1.2.1}/tests/test_index.py

@@ -350,6 +350,23 @@ def test_search_field_query():
     assert rst.items == set({})
 
 
+def test_search_field_query_with_map():
+    """Test Index search applies map functions to field values."""
+    index = Index()
+    index._insert_fields(0, {"temp": 70.0})
+
+    rst = index.search(FieldQuery().temp.map(lambda x: x * 2) == 140.0)
+    assert rst.items == {0}
+
+    rst = index.search(
+        FieldQuery().map(lambda fields: fields["temp"] * 2) == 140.0
+    )
+    assert rst.items == {0}
+
+    rst = index.search(FieldQuery().temp.map(lambda _: 1 / 0) == 1)
+    assert rst.items == set({})
+
+
 def test_search_compound_query_not():
     """Test search_query of Index on compound 'not' queries."""
     # Some timestamps.

{tinyflux-1.2.0 → tinyflux-1.2.1}/tests/test_storages.py

@@ -352,7 +352,7 @@ def test_connect_to_existing_csv(tmpdir, csv_storage_with_counters):
 
     # Mock CSV store.  Insert points out of order.
     path = os.path.join(tmpdir, "test.csv")
-    with open(path, "w") as f:
+    with open(path, "w", newline="") as f:
         w = csv.writer(f)
         w.writerow(p2._serialize_to_list())
         w.writerow(p1._serialize_to_list())
@@ -478,7 +478,7 @@ def test_multiple_appends(
 
     # Mock CSV store.  Insert points out of order.
     path = os.path.join(tmpdir, "test.csv")
-    with open(path, "w") as f:
+    with open(path, "w", newline="") as f:
         w = csv.writer(f)
         w.writerow(p2._serialize_to_list())
         w.writerow(p1._serialize_to_list())
@@ -514,7 +514,7 @@ def test_multiple_reads(
     path = os.path.join(tmpdir, "test.csv")
     t = datetime.now(timezone.utc)
 
-    with open(path, "w") as f:
+    with open(path, "w", newline="") as f:
         w = csv.writer(f)
         for _ in range(10):
             w.writerow(Point(time=t)._serialize_to_list())
@@ -533,7 +533,7 @@ def test_multiple_reads(
 
     # Mock CSV store.  Insert points out-of-order.
     path = os.path.join(tmpdir, "test.csv")
-    with open(path, "w") as f:
+    with open(path, "w", newline="") as f:
         w = csv.writer(f)
         for _ in range(10):
             w.writerow(Point(time=t)._serialize_to_list())

{tinyflux-1.2.0 → tinyflux-1.2.1}/tests/test_tinyflux.py

@@ -657,7 +657,7 @@ def test_reindex(tmpdir, capsys):
 
     # Mock CSV store.  Insert points out of order.
     path = os.path.join(tmpdir, "test.csv")
-    f = open(path, "w")
+    f = open(path, "w", newline="")
     w = csv.writer(f)
     w.writerow(p2._serialize_to_list())
     w.writerow(p1._serialize_to_list())
@@ -842,6 +842,21 @@ def test_search():
     assert db.search(FieldQuery().a.exists()) == [p2]
 
 
+def test_search_field_map_index_storage_parity():
+    """Test mapped FieldQuery search matches with and without the index."""
+    point = Point(fields={"a": 70})
+    query = FieldQuery().a.map(lambda value: value * 2) == 140
+
+    db_storage = TinyFlux(storage=MemoryStorage, auto_index=False)
+    db_storage.insert(point)
+
+    db_index = TinyFlux(storage=MemoryStorage, auto_index=True)
+    db_index.insert(point)
+
+    assert db_storage.search(query) == [point]
+    assert db_index.search(query) == [point]
+
+
 def test_select():
     """Test select method."""
     db = TinyFlux(storage=MemoryStorage, auto_index=False)
@@ -1175,7 +1190,7 @@ def test_storage_index_initialization_with_autoindex_ON(tmpdir, capsys):
 
     # Mock CSV store.  Insert points out of order.
     path = os.path.join(tmpdir, "test.csv")
-    with open(path, "w") as f:
+    with open(path, "w", newline="") as f:
         w = csv.writer(f)
         w.writerow(p2._serialize_to_list())
         w.writerow(p1._serialize_to_list())
@@ -1217,7 +1232,7 @@ def test_open_unindexed_storage_with_autoindex_OFF(tmpdir):
 
     # Mock CSV store.
     path = os.path.join(tmpdir, "test.csv")
-    with open(path, "w") as f:
+    with open(path, "w", newline="") as f:
         w = csv.writer(f)
         w.writerow(p2._serialize_to_list())
         w.writerow(p1._serialize_to_list())

{tinyflux-1.2.0 → tinyflux-1.2.1}/tinyflux/index.py

@@ -600,17 +600,28 @@ class Index:
         """
         rst_items: Set[int] = set([])
 
-        for field_key, items in self._fields.items():
-            # Transform the key. We're only concerned with whether or not a
-            # storage item has a relevant field key before testing its value.
-            # It if does, then we the values, and add these items to results.
-            try:
-                query._path_resolver({field_key: 0.0})
-            except Exception:
-                continue
+        field_items: Iterable[Tuple[str, List[Tuple[int, FieldValue]]]]
+
+        if query._path and isinstance(query._path[0], str):
+            field_items = [
+                (query._path[0], self._fields.get(query._path[0], []))
+            ]
+        else:
+            field_items = self._fields.items()
 
+        for field_key, items in field_items:
             for idx, test_value in items:
-                if query._test(test_value):
+                if len(query._path) == 1 and isinstance(query._path[0], str):
+                    resolved_value = test_value
+                else:
+                    try:
+                        resolved_value = query._path_resolver(
+                            {field_key: test_value}
+                        )
+                    except Exception:
+                        continue
+
+                if query._test(resolved_value):
                     rst_items.add(idx)
 
         return rst_items

{tinyflux-1.2.0 → tinyflux-1.2.1}/tinyflux/queries.py

@@ -206,6 +206,7 @@ class SimpleQuery:
         rhs: Any,
         test: Callable[..., bool],
         path_resolver: Callable[..., Any],
+        path: Tuple[Union[str, Callable[..., Any]], ...],
         hashval: Any,
     ) -> None:
         """Initialize an SimpleQuery.
@@ -217,6 +218,7 @@ class SimpleQuery:
             test: The combined logic as a callable.
             path_resolver: A fetcher/translator for Point metadata that the
                            query will be evaluated on.
+            path: The query path from the point attribute to the tested value.
             hashval: The hash value for the query.
         """
         self._point_attr = point_attr
@@ -224,6 +226,7 @@ class SimpleQuery:
         self._rhs = rhs
         self._test = test
         self._path_resolver = path_resolver
+        self._path = path
         self._hash = hashval
 
     @property
@@ -509,6 +512,7 @@ class BaseQuery:
             rhs=rhs,
             test=test,
             path_resolver=path_resolver,
+            path=self._path,
             hashval=hashval if self.is_hashable() else None,
         )
 
@@ -732,6 +736,7 @@ class BaseQuery:
             rhs=None,
             test=lambda _: True,
             path_resolver=lambda x: x,
+            path=(),
             hashval=(),
         )
 

tinyflux-1.2.1/tinyflux/version.py

@@ -0,0 +1,3 @@
+"""Version."""
+
+__version__ = "1.2.1"  # pragma: no cover

{tinyflux-1.2.0 → tinyflux-1.2.1/tinyflux.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tinyflux
-Version: 1.2.0
+Version: 1.2.1
 Summary: The Tiny Time-Series Database Optimized for Your Happiness
 Home-page: https://github.com/citrusvanilla/tinyflux
 Author: Justin Fung
@@ -17,15 +17,16 @@ Classifier: Topic :: Database
 Classifier: Topic :: Database :: Database Engines/Servers
 Classifier: Topic :: Utilities
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Operating System :: OS Independent
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
@@ -37,7 +38,7 @@ Dynamic: license-file
 
 TinyFlux is the tiny time series database optimized for your happiness 😎
 
-TinyFlux is the time series version of [TinyDB](https://tinydb.readthedocs.io/en/latest/index.html) that is written in Python and has no external dependencies. It consistently writes atomically to file at over 6,000 writes per second and supports greater than 100 queries per second for time-based range queries on datasets up to 100,000 points. It's a perfect companion for small analytics workflows and apps, as well as at-home IOT data stores. TinyFlux has 100% test coverage, over 150,000 downloads, and no open issues.
+TinyFlux is the time series version of [TinyDB](https://tinydb.readthedocs.io/en/latest/index.html) that is written in Python and has no external dependencies. It consistently writes atomically to file at over 6,000 writes per second and supports greater than 100 queries per second for time-based range queries on datasets up to 100,000 points. It's a perfect companion for small analytics workflows and apps, as well as at-home IOT data stores. TinyFlux has 100% test coverage, over 200,000 downloads, and no open issues.
 
 [![Documentation](https://readthedocs.org/projects/tinyflux/badge/?version=latest)](https://tinyflux.readthedocs.io/en/latest/?badge=latest)
 [![Version](https://img.shields.io/pypi/v/tinyflux.svg)](https://pypi.org/project/tinyflux/)
@@ -59,6 +60,8 @@ Install from PyPI:
 pip install tinyflux
 ```
 
+TinyFlux supports CPython 3.10 through 3.15.
+
 ## Quick Start
 
 ```python
@@ -238,13 +241,11 @@ TinyFlux automatic indexing provides:
 
 ## TinyFlux Across the Internet
 
-- **IoT Sensor Networks**: Collect and analyze device telemetry
-- **System Monitoring**: Track server metrics and application performance  
-- **Financial Data**: Store and query stock prices, trading volumes
-- **Scientific Research**: Log experimental measurements and observations
-- **Web Analytics**: Time-stamped user interaction data
+Articles, tutorials, and other instances of TinyFlux in the wild:
 
-*Perfect for prototyping, edge computing, embedded systems, and applications where simplicity matters.*
+- ["Introducing TinyFlux: The Tiny Time Series Database for Python-based IoT & Analytics Applications"](https://citrusvanilla.medium.com/introducing-tinyflux-the-tiny-time-series-database-for-python-based-iot-analytics-applications-c3ef3c3bedf): A Medium.com article announcing the release of TinyFlux
+- ["Storing Time Series Data in Python Using TinyFluxDB"](http://www.steves-internet-guide.com/storing-time-series-data-python-using-tinyflux-db/): A tutorial from [Steve's Internet Guide](http://www.steves-internet-guide.com/), a portal for learning MQTT and IoT development for Python
+- ["KaiCode 2024 Shortlist"](https://www.kaicode.org/2024.html): TinyFlux came in 10th place out of 412 entrants in the 7th edition of this open-source festival, a festival dedicated to recognizing projects with high-quality open-source principles
 
 ## Contributing
 

tinyflux-1.2.0/tinyflux/version.py

@@ -1,3 +0,0 @@
-"""Version."""
-
-__version__ = "1.2.0"  # pragma: no cover