questdb 2.0.0__tar.gz → 2.0.1__tar.gz

{questdb-2.0.0 → questdb-2.0.1}/CHANGELOG.rst

@@ -1,7 +1,30 @@
+.. _changelog:
 
 Changelog
 =========
 
+2.0.1 (2024-03-22)
+------------------
+
+Patch release with bug fixes, no API changes and some documentation tweaks.
+
+Bug fixes
+~~~~~~~~~
+* Fixed a bug where an internal "last flushed" timestamp used
+  by ``auto_flush_interval`` wasn't updated correctly causing the auto-flush
+  logic to trigger after each row.
+
+* Removed two unnecessary debugging ``print()`` statements that were
+  accidentally left in the code in ``Sender.from_conf()`` and
+  ``Sender.from_env()``.
+
+Documentation
+~~~~~~~~~~~~~
+* Introduced the ability to optionally install ``pandas`` and ``pyarrow`` via
+  ``python3 -m pip install -U questdb[dataframe]`` and updated the documentation
+  to reflect this.
+
+
 2.0.0 (2024-03-19)
 ------------------
 
@@ -158,7 +181,7 @@ The following example shows how to migrate to the new API.
         'token_y=token_y=Dt5tbS1dEDMSYfym3fgMv0B99szno-dFc1rYF9t0aac;' +
         'auto_flush_rows=off;' +
         'auto_flush_interval=off;' +
-        'auto_flush_bytes=64512')
+        'auto_flush_bytes=64512;')
     with Sender.from_conf(conf) as sender:
         sender.row(
             'test_table',

{questdb-2.0.0 → questdb-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: questdb
-Version: 2.0.0
+Version: 2.0.1
 Summary: QuestDB client library for Python
 Author-email: Adam Cimarosti <adam@questdb.io>
 License: Apache License 2.0
@@ -31,6 +31,10 @@ Requires-Dist: twine; extra == "publish"
 Requires-Dist: wheel; extra == "publish"
 Provides-Extra: ci
 Requires-Dist: cibuildwheel; extra == "ci"
+Provides-Extra: dataframe
+Requires-Dist: pandas; extra == "dataframe"
+Requires-Dist: pyarrow; extra == "dataframe"
+Requires-Dist: numpy; extra == "dataframe"
 
 =================================
 QuestDB Client Library for Python
@@ -52,28 +56,15 @@ and full-connection encryption with
 Quickstart
 ==========
 
-The latest version of the library is 2.0.0.
+The latest version of the library is 2.0.1 (`changelog <https://py-questdb-client.readthedocs.io/en/latest/changelog.html>`_).
 
 ::
 
-    python3 -m pip install -U questdb
+    python3 -m pip install -U questdb[dataframe]
 
 Please start by `setting up QuestDB <https://questdb.io/docs/quick-start/>`_ . Once set up, you can use this library to insert data.
 
-.. code-block:: python
-
-    from questdb.ingress import Sender, TimestampNanos
-
-    conf = f'http::addr=localhost:9000;'
-    with Sender.from_conf(conf) as sender:
-        sender.row(
-            'sensors',
-            symbols={'id': 'toronto1'},
-            columns={'temperature': 20.0, 'humidity': 0.5},
-            at=TimestampNanos.now())
-        sender.flush()
-
-You can also send Pandas dataframes:
+The most common way to insert data is from a Pandas dataframe.
 
 .. code-block:: python
 
@@ -90,8 +81,25 @@ You can also send Pandas dataframes:
     with Sender.from_conf(conf) as sender:
         sender.dataframe(df, table_name='sensors', at='timestamp')
 
+You can also send individual rows. This only requires a more minimal installation::
+
+    python3 -m pip install -U questdb
+
+.. code-block:: python
+
+    from questdb.ingress import Sender, TimestampNanos
+
+    conf = f'http::addr=localhost:9000;'
+    with Sender.from_conf(conf) as sender:
+        sender.row(
+            'sensors',
+            symbols={'id': 'toronto1'},
+            columns={'temperature': 20.0, 'humidity': 0.5},
+            at=TimestampNanos.now())
+        sender.flush()
+
 
-To connect via TCP, set the
+To connect via the `older TCP protocol <https://py-questdb-client.readthedocs.io/en/latest/sender.html#ilp-tcp-or-ilp-http>`_, set the
 `configuration string <https://py-questdb-client.readthedocs.io/en/latest/conf.html>`_ to:
 
 .. code-block:: python

{questdb-2.0.0 → questdb-2.0.1}/README.rst

@@ -18,28 +18,15 @@ and full-connection encryption with
 Quickstart
 ==========
 
-The latest version of the library is 2.0.0.
+The latest version of the library is 2.0.1 (`changelog <https://py-questdb-client.readthedocs.io/en/latest/changelog.html>`_).
 
 ::
 
-    python3 -m pip install -U questdb
+    python3 -m pip install -U questdb[dataframe]
 
 Please start by `setting up QuestDB <https://questdb.io/docs/quick-start/>`_ . Once set up, you can use this library to insert data.
 
-.. code-block:: python
-
-    from questdb.ingress import Sender, TimestampNanos
-
-    conf = f'http::addr=localhost:9000;'
-    with Sender.from_conf(conf) as sender:
-        sender.row(
-            'sensors',
-            symbols={'id': 'toronto1'},
-            columns={'temperature': 20.0, 'humidity': 0.5},
-            at=TimestampNanos.now())
-        sender.flush()
-
-You can also send Pandas dataframes:
+The most common way to insert data is from a Pandas dataframe.
 
 .. code-block:: python
 
@@ -56,8 +43,25 @@ You can also send Pandas dataframes:
     with Sender.from_conf(conf) as sender:
         sender.dataframe(df, table_name='sensors', at='timestamp')
 
+You can also send individual rows. This only requires a more minimal installation::
+
+    python3 -m pip install -U questdb
+
+.. code-block:: python
+
+    from questdb.ingress import Sender, TimestampNanos
+
+    conf = f'http::addr=localhost:9000;'
+    with Sender.from_conf(conf) as sender:
+        sender.row(
+            'sensors',
+            symbols={'id': 'toronto1'},
+            columns={'temperature': 20.0, 'humidity': 0.5},
+            at=TimestampNanos.now())
+        sender.flush()
+
 
-To connect via TCP, set the
+To connect via the `older TCP protocol <https://py-questdb-client.readthedocs.io/en/latest/sender.html#ilp-tcp-or-ilp-http>`_, set the
 `configuration string <https://py-questdb-client.readthedocs.io/en/latest/conf.html>`_ to:
 
 .. code-block:: python

{questdb-2.0.0 → questdb-2.0.1}/pyproject.toml

@@ -2,7 +2,7 @@
 # See: https://packaging.python.org/en/latest/specifications/declaring-project-metadata/
 name = "questdb"
 requires-python = ">=3.8"
-version = "2.0.0"
+version = "2.0.1"
 description = "QuestDB client library for Python"
 readme = "README.rst"
 classifiers = [
@@ -29,6 +29,7 @@ email = "adam@questdb.io"
 [project.optional-dependencies]
 publish = ["twine", "wheel"]
 ci = ["cibuildwheel"]
+dataframe = ["pandas", "pyarrow", "numpy"]
 
 [project.urls]
 Homepage = "https://questdb.io/"

{questdb-2.0.0 → questdb-2.0.1}/setup.py

@@ -165,7 +165,7 @@ def readme():
 
 setup(
     name='questdb',
-    version='2.0.0',
+    version='2.0.1',
     platforms=['any'],
     python_requires='>=3.8',
     install_requires=[],

questdb-2.0.1/src/questdb/__init__.py

@@ -0,0 +1 @@
+__version__ = '2.0.1'

{questdb-2.0.0 → questdb-2.0.1}/src/questdb/dataframe.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<!-- Generated by Cython 3.0.9 -->
+<!-- Generated by Cython 3.0.10 -->
 <html>
 <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
@@ -289,7 +289,7 @@ body.cython { font-family: courier; font-size: 12; }
     </style>
 </head>
 <body class="cython">
-<p><span style="border-bottom: solid 1px grey;">Generated by Cython 3.0.9</span></p>
+<p><span style="border-bottom: solid 1px grey;">Generated by Cython 3.0.10</span></p>
 <p>
     <span style="background-color: #FFFF00">Yellow lines</span> hint at Python interaction.<br />
     Click on a line that starts with a "<code>+</code>" to see the C code that Cython generated for it.