tracktolib 0.64.0__tar.gz → 0.65.0__tar.gz

{tracktolib-0.64.0 → tracktolib-0.65.0}/PKG-INFO

@@ -1,11 +1,15 @@
 Metadata-Version: 2.4
 Name: tracktolib
-Version: 0.64.0
+Version: 0.65.0
 Summary: Utility library for python
 Keywords: utility
 Author-email: julien.brayere@tracktor.fr
 License-Expression: MIT
 Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: fastapi>=0.103.2 ; extra == 'api'
 Requires-Dist: pydantic>=2 ; extra == 'api'
 Requires-Dist: httpx>=0.25.0 ; extra == 'http'
@@ -36,21 +40,25 @@ Description-Content-Type: text/markdown
 [![Latest PyPI version](https://img.shields.io/pypi/v/tracktolib?logo=pypi)](https://pypi.python.org/pypi/tracktolib)
 [![CircleCI](https://circleci.com/gh/Tracktor/tracktolib/tree/master.svg?style=shield)](https://app.circleci.com/pipelines/github/Tracktor/tracktolib?branch=master)
 
-Utility library for python
+Utility library for Python 3.12+
 
-# Installation
+## Installation
 
-Just run:
+```bash
+uv add tracktolib
+```
+
+With specific extras:
 
 ```bash
-uv add tracktolib@latest 
+uv add tracktolib[pg,api]
 ```
 
-# Utilities
+## Modules
 
-- **log**
+### logs
 
-Utility functions for logging.
+Utility functions to initialize logging formatting and streams.
 
 ```python
 import logging
@@ -60,56 +68,87 @@ logger = logging.getLogger()
 formatter, stream_handler = init_logging(logger, 'json', version='0.0.1')
 ```
 
-- **pg**
+### pg
 
-Utility functions for [asyncpg](https://github.com/MagicStack/asyncpg)
+Async PostgreSQL helpers using [asyncpg](https://github.com/MagicStack/asyncpg).
 
-- **pg-sync**
+```bash
+uv add tracktolib[pg]
+```
 
-Utility functions based on psycopg such as `fetch_one`, `insert_many`, `fetch_count` ...
+### pg-sync
 
-To use the functions, create a `Connection` using psycopg: `conn = psycopg2.connect()`
+Sync PostgreSQL helpers using [psycopg](https://www.psycopg.org/psycopg3/) (v3).
 
-*fetch_one*
+```bash
+uv add tracktolib[pg-sync]
+```
 
 ```python
-from tracktolib.pg.pg_sync import (
-    insert_many, fetch_one, fetch_count, fetch_all
-)
+from psycopg import connect
+from tracktolib.pg_sync import insert_many, fetch_one, fetch_count, fetch_all
+
+conn = connect('postgresql://user:pass@localhost/db')
 
 data = [
     {'foo': 'bar', 'value': 1},
     {'foo': 'baz', 'value': 2}
 ]
-insert_many(conn, 'public.test', data)  # Will insert the 2 dict
+insert_many(conn, 'public.test', data)
+
 query = 'SELECT foo from public.test order by value asc'
-value = fetch_one(conn, query, required=True)  # Will return {'foo': 'bar'}, raise an error is not found
+value = fetch_one(conn, query, required=True)  # {'foo': 'bar'}, raises if not found
+
 assert fetch_count(conn, 'public.test') == 2
+
 query = 'SELECT * from public.test order by value asc'
 assert fetch_all(conn, query) == data
+```
+
+### s3
+
+Async S3 helpers using [aiobotocore](https://github.com/aio-libs/aiobotocore).
 
+```bash
+uv add tracktolib[s3]
 ```
 
-- **tests**
+### s3-minio
 
-Utility functions for testing
+S3 helpers using [minio](https://min.io/docs/minio/linux/developers/python/API.html).
 
-- **s3-minio**
+```bash
+uv add tracktolib[s3-minio]
+```
 
-Utility functions for [minio](https://min.io/docs/minio/linux/developers/python/API.html)
+### http
 
-- **s3**
+HTTP client helpers using [httpx](https://www.python-httpx.org/).
 
-Utility functions for [aiobotocore](https://github.com/aio-libs/aiobotocore)
+```bash
+uv add tracktolib[http]
+```
 
-- **logs**
+### api
 
-Utility functions to initialize the logging formatting and streams
+FastAPI utilities using [fastapi](https://fastapi.tiangolo.com/) and [pydantic](https://docs.pydantic.dev/).
 
-- **http**
+```bash
+uv add tracktolib[api]
+```
 
-Utility functions using [httpx](https://www.python-httpx.org/)
+### notion
 
-- **api**
+Notion API helpers using [niquests](https://github.com/jawah/niquests).
 
-Utility functions using [fastapi](https://fastapi.tiangolo.com/)
+```bash
+uv add tracktolib[notion]
+```
+
+### tests
+
+Testing utilities using [deepdiff](https://github.com/seperman/deepdiff).
+
+```bash
+uv add tracktolib[tests]
+```

tracktolib-0.65.0/README.md

@@ -0,0 +1,118 @@
+# Tracktolib
+
+[![Python versions](https://img.shields.io/pypi/pyversions/tracktolib)](https://pypi.python.org/pypi/tracktolib)
+[![Latest PyPI version](https://img.shields.io/pypi/v/tracktolib?logo=pypi)](https://pypi.python.org/pypi/tracktolib)
+[![CircleCI](https://circleci.com/gh/Tracktor/tracktolib/tree/master.svg?style=shield)](https://app.circleci.com/pipelines/github/Tracktor/tracktolib?branch=master)
+
+Utility library for Python 3.12+
+
+## Installation
+
+```bash
+uv add tracktolib
+```
+
+With specific extras:
+
+```bash
+uv add tracktolib[pg,api]
+```
+
+## Modules
+
+### logs
+
+Utility functions to initialize logging formatting and streams.
+
+```python
+import logging
+from tracktolib.logs import init_logging
+
+logger = logging.getLogger()
+formatter, stream_handler = init_logging(logger, 'json', version='0.0.1')
+```
+
+### pg
+
+Async PostgreSQL helpers using [asyncpg](https://github.com/MagicStack/asyncpg).
+
+```bash
+uv add tracktolib[pg]
+```
+
+### pg-sync
+
+Sync PostgreSQL helpers using [psycopg](https://www.psycopg.org/psycopg3/) (v3).
+
+```bash
+uv add tracktolib[pg-sync]
+```
+
+```python
+from psycopg import connect
+from tracktolib.pg_sync import insert_many, fetch_one, fetch_count, fetch_all
+
+conn = connect('postgresql://user:pass@localhost/db')
+
+data = [
+    {'foo': 'bar', 'value': 1},
+    {'foo': 'baz', 'value': 2}
+]
+insert_many(conn, 'public.test', data)
+
+query = 'SELECT foo from public.test order by value asc'
+value = fetch_one(conn, query, required=True)  # {'foo': 'bar'}, raises if not found
+
+assert fetch_count(conn, 'public.test') == 2
+
+query = 'SELECT * from public.test order by value asc'
+assert fetch_all(conn, query) == data
+```
+
+### s3
+
+Async S3 helpers using [aiobotocore](https://github.com/aio-libs/aiobotocore).
+
+```bash
+uv add tracktolib[s3]
+```
+
+### s3-minio
+
+S3 helpers using [minio](https://min.io/docs/minio/linux/developers/python/API.html).
+
+```bash
+uv add tracktolib[s3-minio]
+```
+
+### http
+
+HTTP client helpers using [httpx](https://www.python-httpx.org/).
+
+```bash
+uv add tracktolib[http]
+```
+
+### api
+
+FastAPI utilities using [fastapi](https://fastapi.tiangolo.com/) and [pydantic](https://docs.pydantic.dev/).
+
+```bash
+uv add tracktolib[api]
+```
+
+### notion
+
+Notion API helpers using [niquests](https://github.com/jawah/niquests).
+
+```bash
+uv add tracktolib[notion]
+```
+
+### tests
+
+Testing utilities using [deepdiff](https://github.com/seperman/deepdiff).
+
+```bash
+uv add tracktolib[tests]
+```

{tracktolib-0.64.0 → tracktolib-0.65.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tracktolib"
-version = "0.64.0"
+version = "0.65.0"
 authors = [
     { email = "julien.brayere@tracktor.fr" }
 ]
@@ -11,7 +11,11 @@ homepage = "https://github.com/tracktor/tracktolib"
 repository = "https://github.com/tracktor/tracktolib"
 keywords = ["utility"]
 classifiers = [
-    "Operating System :: OS Independent"
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 include = [
     "LICENSE"
@@ -87,12 +91,12 @@ filterwarnings = [
 include = ["tracktolib", "tests"]
 exclude = []
 
-pythonVersion = "3.13"
+pythonVersion = "3.14"
 pythonPlatform = "Linux"
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "0.64.0"
+version = "0.65.0"
 tag_format = "$version"
 version_files = [
     "pyproject.toml:version"
@@ -102,7 +106,7 @@ bump_message = "release $current_version → $new_version [skip ci]"
 
 [tool.ruff]
 line-length = 120
-target-version = "py313"
+target-version = "py314"
 
 
 [tool.ruff.lint.per-file-ignores]

tracktolib-0.64.0/README.md

@@ -1,83 +0,0 @@
-# Tracktolib
-
-[![Python versions](https://img.shields.io/pypi/pyversions/tracktolib)](https://pypi.python.org/pypi/tracktolib)
-[![Latest PyPI version](https://img.shields.io/pypi/v/tracktolib?logo=pypi)](https://pypi.python.org/pypi/tracktolib)
-[![CircleCI](https://circleci.com/gh/Tracktor/tracktolib/tree/master.svg?style=shield)](https://app.circleci.com/pipelines/github/Tracktor/tracktolib?branch=master)
-
-Utility library for python
-
-# Installation
-
-Just run:
-
-```bash
-uv add tracktolib@latest 
-```
-
-# Utilities
-
-- **log**
-
-Utility functions for logging.
-
-```python
-import logging
-from tracktolib.logs import init_logging
-
-logger = logging.getLogger()
-formatter, stream_handler = init_logging(logger, 'json', version='0.0.1')
-```
-
-- **pg**
-
-Utility functions for [asyncpg](https://github.com/MagicStack/asyncpg)
-
-- **pg-sync**
-
-Utility functions based on psycopg such as `fetch_one`, `insert_many`, `fetch_count` ...
-
-To use the functions, create a `Connection` using psycopg: `conn = psycopg2.connect()`
-
-*fetch_one*
-
-```python
-from tracktolib.pg.pg_sync import (
-    insert_many, fetch_one, fetch_count, fetch_all
-)
-
-data = [
-    {'foo': 'bar', 'value': 1},
-    {'foo': 'baz', 'value': 2}
-]
-insert_many(conn, 'public.test', data)  # Will insert the 2 dict
-query = 'SELECT foo from public.test order by value asc'
-value = fetch_one(conn, query, required=True)  # Will return {'foo': 'bar'}, raise an error is not found
-assert fetch_count(conn, 'public.test') == 2
-query = 'SELECT * from public.test order by value asc'
-assert fetch_all(conn, query) == data
-
-```
-
-- **tests**
-
-Utility functions for testing
-
-- **s3-minio**
-
-Utility functions for [minio](https://min.io/docs/minio/linux/developers/python/API.html)
-
-- **s3**
-
-Utility functions for [aiobotocore](https://github.com/aio-libs/aiobotocore)
-
-- **logs**
-
-Utility functions to initialize the logging formatting and streams
-
-- **http**
-
-Utility functions using [httpx](https://www.python-httpx.org/)
-
-- **api**
-
-Utility functions using [fastapi](https://fastapi.tiangolo.com/)