feat: package for pypi

Author: Corne Bester

.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+    "snyk.advanced.organization": "4d30615c-6bb3-4e73-9c86-2fce0ad942d2",
+    "snyk.advanced.autoSelectOrganization": true
+}

README.md

@@ -4,8 +4,6 @@ example
 
 ```
 from datetime import datetime, timezone
-from modules.time_functions import get_timestamp_unix_millis
-# OR
 from time_functions import get_timestamp_unix_millis
 # OR 
 import time_functions
@@ -17,30 +15,16 @@ unix_millis = get_timestamp_unix_millis(timestamp)  # create unix timestamp from
 
 ## local dev
 
-    pip install pytest build 
+    pip install -r requirements.txt
+
 
 ## test
 
     pytest
 
-## build ( create dist artifacts )
-
-    python -m build
-
-## install from location
-
-    python -m  pip install  "C:\Users\corne\Documents\GitHub\python_time_functions\dist\pythom_time_functions-2.1.0-py3-none-any.whl"
-
 
 ### other
 
     pip3 freeze > requirements.txt
 
-## bad formats I dreamed up for iot/psql. fix with sanitizer fx 
 
->>> time_functions.timestamp_sanitizer_psql(1729755232184)
-1729755232.184
->>> time_functions.timestamp_sanitizer_psql(1729765227856.3)
-1729765227.856
->>> time_functions.timestamp_sanitizer_psql(1729765228327.051)
-1729765228.327

test.py example_conversions.pytest.py renamed to example_conversions.py

@@ -1,7 +1,7 @@
 import logging
 
 from datetime import datetime, timezone
-import time_functions
+import src.python_time_fuctions.time_functions as time_functions
 
 logger = logging.getLogger(__name__)
 
@@ -41,7 +41,7 @@
 print(f"unix_micros: {unix_micros}")
 print(f"unix_with_subseconds: {unix_with_subseconds}")
 
-print("--- convertions ---")
+print("--- conversions ---")
 print(f"obj_from_iso: {obj_from_iso}", )
 print(f"obj_from_iso_millis: {obj_from_iso_millis}")
 print(f"obj_from_iso_micros: {obj_from_iso_micros}")
@@ -59,4 +59,4 @@
 dtstmp = (
     obj.strftime("%Y%m%d-%H%M%S.%f")[:-3] + " UTC,"
 )  # Chris format for psql
-print(f"CSIRO: {dtstmp}")
+print(f"custom: {dtstmp}")

pyproject.toml

@@ -3,12 +3,22 @@ requires = ["setuptools>=65.5.0"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "pythom_time_functions"
-version = "2.1.1"
+name = "python_time_functions"
+version = "2.1.2"
 description = "Common Python functions for time handling"
+readme = "README.md"
 authors = [{name = "Corne Bester", email = "corne.bester@gmail.com"}]
 dependencies = [
+    "datetime",
+    "timezone"
 ]
-
 license = "MIT"
-license-files = ["LICEN[CS]E*"]
+license-files = ["LICEN[CS]E*"]
+
+[project.urls]
+Homepage = "https://example.com"
+Documentation = "https://readthedocs.org"
+Repository = "https://github.com/cornebester/python_time_functions"
+Issues = "https://github.com/cornebester/python_time_functions/issues"
+Changelog = "https://github.com/cornebester/python_time_functions/blob/master/CHANGELOG.md"
+

requirements.txt

@@ -1,11 +1,35 @@
-build==1.3.0
+backports.tarfile==1.2.0
+build==1.4.0
+certifi==2026.2.25
+charset-normalizer==3.4.5
 colorama==0.4.6
-exceptiongroup==1.3.0
+docutils==0.22.4
+exceptiongroup==1.3.1
+id==1.6.1
+idna==3.11
+importlib_metadata==8.7.1
 iniconfig==2.3.0
-packaging==25.0
+jaraco.classes==3.4.0
+jaraco.context==6.1.1
+jaraco.functools==4.4.0
+keyring==25.7.0
+markdown-it-py==4.0.0
+mdurl==0.1.2
+more-itertools==10.8.0
+nh3==0.3.3
+packaging==26.0
 pluggy==1.6.0
 Pygments==2.19.2
 pyproject_hooks==1.2.0
-pytest==8.4.2
-tomli==2.3.0
-typing_extensions==4.15.0
+pytest==9.0.2
+pywin32-ctypes==0.2.3
+readme_renderer==44.0
+requests==2.32.5
+requests-toolbelt==1.0.0
+rfc3986==2.0.0
+rich==14.3.3
+tomli==2.4.0
+twine==6.2.0
+typing_extensions==4.15.0
+urllib3==2.6.3
+zipp==3.23.0

src/python_time_fuctions/__init__.py

@@ -241,8 +241,14 @@ def timestamp_parser_psql_millis(timestamp):
 def timestamp_sanitizer_psql(input):
     '''
     Normalize unix timestamps to postgresl friendly float with millisecond decimals. 14 digits
-    Attemps to fix/sanitize bad timestamps
-    handle timestamnp as:
+    Attemps to fix/sanitize bad timestamp format I dreamed up like
+    >>> time_functions.timestamp_sanitizer_psql(1729755232184)
+    1729755232.184
+    >>> time_functions.timestamp_sanitizer_psql(1729765227856.3)
+    1729765227.856
+    >>> time_functions.timestamp_sanitizer_psql(1729765228327.051)
+    1729765228.327
+    handle timestamp as:
     unix micros or millis in decimal format
     unix millis or micros in unix format 
     iso8601

time_functions.py …c/python_time_fuctions/time_functions.pytime_functions.py renamed to src/python_time_fuctions/time_functions.py time_functions.py renamed to src/python_time_fuctions/time_functions.py

@@ -1,4 +1,4 @@
-import time_functions
+import src.python_time_fuctions.time_functions as time_functions
 
 def test_convertions_from_sample23():
     assert float(time_functions.timestamp_sanitizer_psql(1742758997)) == 1742758997

tests/test_time_function_sanitizer.py

@@ -1,6 +1,6 @@
 import logging
 from datetime import datetime, timezone
-import time_functions
+import src.python_time_fuctions.time_functions as time_functions
 
 
 new_obj = datetime.now(timezone.utc)