docs: Fixed examples removing bug-prone usage of utcnow. (#38)

Author: amunra

ci/pip_install_deps.py

@@ -25,7 +25,10 @@ def pip_install(package):
     if res.returncode == 0:
         return
     output = res.stdout.decode('utf-8')
-    if 'Could not find a version that satisfies the requirement' in output:
+    is_unsupported = (
+        ('Could not find a version that satisfies the requirement' in output) or
+        ('The conflict is caused by' in output))
+    if is_unsupported:
         raise UnsupportedDependency(output)
     else:
         sys.stderr.write(output + '\n')

examples/auth.py

@@ -1,4 +1,4 @@
-from questdb.ingress import Sender, IngressError
+from questdb.ingress import Sender, IngressError, TimestampNanos
 import sys
 import datetime
 
@@ -28,7 +28,7 @@ def example(host: str = 'localhost', port: int = 9009):
                     'traded_ts': datetime.datetime(
                         2022, 8, 6, 7, 35, 23, 189062,
                         tzinfo=datetime.timezone.utc)},
-                at=datetime.datetime.utcnow())
+                at=TimestampNanos.now())
 
             # If no 'at' param is passed, the server will use its own timestamp.
             sender.row(

examples/auth_and_tls.py

@@ -1,4 +1,4 @@
-from questdb.ingress import Sender, IngressError
+from questdb.ingress import Sender, IngressError, TimestampNanos
 import sys
 import datetime
 
@@ -28,7 +28,7 @@ def example(host: str = 'localhost', port: int = 9009):
                     'traded_ts': datetime.datetime(
                         2022, 8, 6, 7, 35, 23, 189062,
                         tzinfo=datetime.timezone.utc)},
-                at=datetime.datetime.utcnow())
+                at=TimestampNanos.now())
 
             # If no 'at' param is passed, the server will use its own timestamp.
             sender.row(

examples/basic.py

@@ -1,4 +1,4 @@
-from questdb.ingress import Sender, IngressError
+from questdb.ingress import Sender, IngressError, TimestampNanos
 import sys
 import datetime
 
@@ -22,7 +22,7 @@ def example(host: str = 'localhost', port: int = 9009):
                     'traded_ts': datetime.datetime(
                         2022, 8, 6, 7, 35, 23, 189062,
                         tzinfo=datetime.timezone.utc)},
-                at=datetime.datetime.utcnow())
+                at=TimestampNanos.now())
 
             # If no 'at' param is passed, the server will use its own timestamp.
             sender.row(

src/questdb/dataframe.md

@@ -97,6 +97,7 @@ We need to extract:
 ```python
 import pandas as pd
 import pyarrow as pa
+import datetime as dt
 ```
 
 ### Booleans
@@ -519,8 +520,8 @@ though they are all UTF-8 buffers already so.. little gain.
 #### Timezone-free timestamp
 
 ```python
->>> n1 = pd.Timestamp(dt.datetime.utcnow())
->>> n2 = pd.Timestamp(dt.datetime.utcnow())
+>>> n1 = pd.Timestamp(dt.datetime.now())
+>>> n2 = pd.Timestamp(dt.datetime.now())
 >>> df = pd.DataFrame({'a': [n1, n2]})
 >>> df
                            a