pgtern 0.4.0__tar.gz → 0.4.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. {pgtern-0.4.0 → pgtern-0.4.1}/CHANGELOG.md +13 -0
  2. {pgtern-0.4.0 → pgtern-0.4.1}/CONTRIBUTING.md +1 -1
  3. {pgtern-0.4.0 → pgtern-0.4.1}/PKG-INFO +10 -4
  4. {pgtern-0.4.0 → pgtern-0.4.1}/README.md +5 -3
  5. {pgtern-0.4.0 → pgtern-0.4.1}/SECURITY.md +2 -2
  6. {pgtern-0.4.0 → pgtern-0.4.1}/pyproject.toml +7 -1
  7. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/__init__.py +1 -1
  8. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern.egg-info/PKG-INFO +10 -4
  9. {pgtern-0.4.0 → pgtern-0.4.1}/LICENSE +0 -0
  10. {pgtern-0.4.0 → pgtern-0.4.1}/MANIFEST.in +0 -0
  11. {pgtern-0.4.0 → pgtern-0.4.1}/scripts/start-test-postgres.sh +0 -0
  12. {pgtern-0.4.0 → pgtern-0.4.1}/setup.cfg +0 -0
  13. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_auth.py +0 -0
  14. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_binary.py +0 -0
  15. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_composite.py +0 -0
  16. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_conn.py +0 -0
  17. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_copy.py +0 -0
  18. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_cursor.py +0 -0
  19. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_dsn.py +0 -0
  20. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_protocol.py +0 -0
  21. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_query.py +0 -0
  22. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_scram.py +0 -0
  23. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/_types.py +0 -0
  24. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/adapters.py +0 -0
  25. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/aio.py +0 -0
  26. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/errors.py +0 -0
  27. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/hooks.py +0 -0
  28. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/pipeline.py +0 -0
  29. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/pool.py +0 -0
  30. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/py.typed +0 -0
  31. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/rows.py +0 -0
  32. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/sql.py +0 -0
  33. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/types/__init__.py +0 -0
  34. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern/types/json.py +0 -0
  35. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern.egg-info/SOURCES.txt +0 -0
  36. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern.egg-info/dependency_links.txt +0 -0
  37. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern.egg-info/requires.txt +0 -0
  38. {pgtern-0.4.0 → pgtern-0.4.1}/src/pgtern.egg-info/top_level.txt +0 -0
  39. {pgtern-0.4.0 → pgtern-0.4.1}/tests/conftest.py +0 -0
  40. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_adapters.py +0 -0
  41. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_async.py +0 -0
  42. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_binary.py +0 -0
  43. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_executemany.py +0 -0
  44. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_executemany_async.py +0 -0
  45. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_features.py +0 -0
  46. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_integration.py +0 -0
  47. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_journey.py +0 -0
  48. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_low_items.py +0 -0
  49. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_medium.py +0 -0
  50. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_pipeline.py +0 -0
  51. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_pool_gaps.py +0 -0
  52. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_regressions.py +0 -0
  53. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_restart.py +0 -0
  54. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_scram_plus.py +0 -0
  55. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_session_state.py +0 -0
  56. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_transaction_pooler.py +0 -0
  57. {pgtern-0.4.0 → pgtern-0.4.1}/tests/test_unit.py +0 -0
@@ -4,6 +4,19 @@ All notable changes to pgtern are documented in this file.
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.4.1] - 2026-11-06
8
+
9
+ ### Fixed
10
+
11
+ - The notifications example in the README connects with `autocommit=True`, so `LISTEN` takes effect.
12
+ - The package index now shows project links (homepage, source, issues and changelog).
13
+
14
+ ### Documentation
15
+
16
+ - The README follows the usual project layout, with absolute links and a status note.
17
+ - The security support table lists 0.4.x as supported.
18
+ - The contributing guide has the real clone URL.
19
+
7
20
  ## [0.4.0] - 2026-11-06
8
21
 
9
22
  ### Changed (behaviour)
@@ -7,7 +7,7 @@ these in mind when you propose a change.
7
7
  ## Getting started
8
8
 
9
9
  ```
10
- git clone <repository-url> pgtern
10
+ git clone https://github.com/karawash-projects/pgtern.git pgtern
11
11
  cd pgtern
12
12
  python -m venv .venv && . .venv/bin/activate
13
13
  pip install -e ".[dev]"
@@ -1,9 +1,13 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pgtern
3
- Version: 0.4.0
3
+ Version: 0.4.1
4
4
  Summary: A zero-dependency, pure-Python PostgreSQL client with blocking and asyncio APIs.
5
5
  Author: Ahmad Karawash
6
6
  License-Expression: Apache-2.0
7
+ Project-URL: Homepage, https://github.com/karawash-projects/pgtern
8
+ Project-URL: Source, https://github.com/karawash-projects/pgtern
9
+ Project-URL: Issues, https://github.com/karawash-projects/pgtern/issues
10
+ Project-URL: Changelog, https://github.com/karawash-projects/pgtern/blob/main/CHANGELOG.md
7
11
  Keywords: postgresql,postgres,database,driver,dbapi,scram,pure-python,zero-dependency
8
12
  Classifier: Development Status :: 4 - Beta
9
13
  Classifier: Intended Audience :: Developers
@@ -29,10 +33,12 @@ Dynamic: license-file
29
33
  # pgtern
30
34
 
31
35
  [![CI](https://github.com/karawash-projects/pgtern/actions/workflows/ci.yml/badge.svg)](https://github.com/karawash-projects/pgtern/actions/workflows/ci.yml)
32
- [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
36
+ [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/karawash-projects/pgtern/blob/main/LICENSE)
33
37
 
34
38
  pgtern is a PostgreSQL client for Python. It speaks the PostgreSQL wire protocol directly and uses only the Python standard library, so there are no runtime dependencies, no C extensions and no build step. It provides a DB-API style interface in two forms: blocking, and `asyncio`.
35
39
 
40
+ > **Status: Beta.** pgtern is at version 0.x. The API may change before 1.0; changes are listed in the [CHANGELOG](https://github.com/karawash-projects/pgtern/blob/main/CHANGELOG.md).
41
+
36
42
  ```python
37
43
  import pgtern
38
44
  from pgtern.rows import dict_row
@@ -164,7 +170,7 @@ Server-side cursors support `scrollable`, `withhold` and `scroll()`.
164
170
  ## Notifications
165
171
 
166
172
  ```python
167
- with pgtern.connect(dsn) as conn:
173
+ with pgtern.connect(dsn, autocommit=True) as conn: # LISTEN takes effect at once only in autocommit
168
174
  conn.execute("LISTEN orders")
169
175
  for note in conn.notifies(timeout=30):
170
176
  print(note.channel, note.payload)
@@ -277,7 +283,7 @@ with pgtern.connect(dsn) as conn:
277
283
 
278
284
  - **PostgreSQL:** 14, 15, 16, 17 and 18.
279
285
  - **Python:** 3.11, 3.12 and 3.13 are tested in continuous integration.
280
- - **Platforms:** anywhere CPython runs.
286
+ - **Platforms:** tested on Linux. Unix sockets, `fork()` and `.pgpass` permission checks behave differently on Windows, so check those yourself there.
281
287
 
282
288
  ## Development
283
289
 
@@ -1,10 +1,12 @@
1
1
  # pgtern
2
2
 
3
3
  [![CI](https://github.com/karawash-projects/pgtern/actions/workflows/ci.yml/badge.svg)](https://github.com/karawash-projects/pgtern/actions/workflows/ci.yml)
4
- [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
4
+ [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/karawash-projects/pgtern/blob/main/LICENSE)
5
5
 
6
6
  pgtern is a PostgreSQL client for Python. It speaks the PostgreSQL wire protocol directly and uses only the Python standard library, so there are no runtime dependencies, no C extensions and no build step. It provides a DB-API style interface in two forms: blocking, and `asyncio`.
7
7
 
8
+ > **Status: Beta.** pgtern is at version 0.x. The API may change before 1.0; changes are listed in the [CHANGELOG](https://github.com/karawash-projects/pgtern/blob/main/CHANGELOG.md).
9
+
8
10
  ```python
9
11
  import pgtern
10
12
  from pgtern.rows import dict_row
@@ -136,7 +138,7 @@ Server-side cursors support `scrollable`, `withhold` and `scroll()`.
136
138
  ## Notifications
137
139
 
138
140
  ```python
139
- with pgtern.connect(dsn) as conn:
141
+ with pgtern.connect(dsn, autocommit=True) as conn: # LISTEN takes effect at once only in autocommit
140
142
  conn.execute("LISTEN orders")
141
143
  for note in conn.notifies(timeout=30):
142
144
  print(note.channel, note.payload)
@@ -249,7 +251,7 @@ with pgtern.connect(dsn) as conn:
249
251
 
250
252
  - **PostgreSQL:** 14, 15, 16, 17 and 18.
251
253
  - **Python:** 3.11, 3.12 and 3.13 are tested in continuous integration.
252
- - **Platforms:** anywhere CPython runs.
254
+ - **Platforms:** tested on Linux. Unix sockets, `fork()` and `.pgpass` permission checks behave differently on Windows, so check those yourself there.
253
255
 
254
256
  ## Development
255
257
 
@@ -6,8 +6,8 @@ Security fixes are released for the most recent minor version of pgtern.
6
6
 
7
7
  | Version | Supported |
8
8
  |---------|-----------|
9
- | 0.3.x | Yes |
10
- | < 0.3 | No |
9
+ | 0.4.x | Yes |
10
+ | < 0.4 | No |
11
11
 
12
12
  ## Reporting a vulnerability
13
13
 
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "pgtern"
7
- version = "0.4.0"
7
+ version = "0.4.1"
8
8
  description = "A zero-dependency, pure-Python PostgreSQL client with blocking and asyncio APIs."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
@@ -27,6 +27,12 @@ classifiers = [
27
27
  # Zero runtime dependencies: the standard library is all pgtern needs.
28
28
  dependencies = []
29
29
 
30
+ [project.urls]
31
+ Homepage = "https://github.com/karawash-projects/pgtern"
32
+ Source = "https://github.com/karawash-projects/pgtern"
33
+ Issues = "https://github.com/karawash-projects/pgtern/issues"
34
+ Changelog = "https://github.com/karawash-projects/pgtern/blob/main/CHANGELOG.md"
35
+
30
36
  [project.optional-dependencies]
31
37
  dev = ["pytest>=8", "pytest-timeout>=2", "build>=1.2", "pyflakes>=3", "mypy>=1.10"]
32
38
 
@@ -24,7 +24,7 @@ from .errors import (
24
24
  from .hooks import QueryInfo, add_query_hook
25
25
  from .pool import ConnectionPool, PoolClosed, PoolTimeout
26
26
 
27
- __version__ = "0.4.0"
27
+ __version__ = "0.4.1"
28
28
 
29
29
  # DB-API 2.0 module globals
30
30
  apilevel = "2.0"
@@ -1,9 +1,13 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pgtern
3
- Version: 0.4.0
3
+ Version: 0.4.1
4
4
  Summary: A zero-dependency, pure-Python PostgreSQL client with blocking and asyncio APIs.
5
5
  Author: Ahmad Karawash
6
6
  License-Expression: Apache-2.0
7
+ Project-URL: Homepage, https://github.com/karawash-projects/pgtern
8
+ Project-URL: Source, https://github.com/karawash-projects/pgtern
9
+ Project-URL: Issues, https://github.com/karawash-projects/pgtern/issues
10
+ Project-URL: Changelog, https://github.com/karawash-projects/pgtern/blob/main/CHANGELOG.md
7
11
  Keywords: postgresql,postgres,database,driver,dbapi,scram,pure-python,zero-dependency
8
12
  Classifier: Development Status :: 4 - Beta
9
13
  Classifier: Intended Audience :: Developers
@@ -29,10 +33,12 @@ Dynamic: license-file
29
33
  # pgtern
30
34
 
31
35
  [![CI](https://github.com/karawash-projects/pgtern/actions/workflows/ci.yml/badge.svg)](https://github.com/karawash-projects/pgtern/actions/workflows/ci.yml)
32
- [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
36
+ [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/karawash-projects/pgtern/blob/main/LICENSE)
33
37
 
34
38
  pgtern is a PostgreSQL client for Python. It speaks the PostgreSQL wire protocol directly and uses only the Python standard library, so there are no runtime dependencies, no C extensions and no build step. It provides a DB-API style interface in two forms: blocking, and `asyncio`.
35
39
 
40
+ > **Status: Beta.** pgtern is at version 0.x. The API may change before 1.0; changes are listed in the [CHANGELOG](https://github.com/karawash-projects/pgtern/blob/main/CHANGELOG.md).
41
+
36
42
  ```python
37
43
  import pgtern
38
44
  from pgtern.rows import dict_row
@@ -164,7 +170,7 @@ Server-side cursors support `scrollable`, `withhold` and `scroll()`.
164
170
  ## Notifications
165
171
 
166
172
  ```python
167
- with pgtern.connect(dsn) as conn:
173
+ with pgtern.connect(dsn, autocommit=True) as conn: # LISTEN takes effect at once only in autocommit
168
174
  conn.execute("LISTEN orders")
169
175
  for note in conn.notifies(timeout=30):
170
176
  print(note.channel, note.payload)
@@ -277,7 +283,7 @@ with pgtern.connect(dsn) as conn:
277
283
 
278
284
  - **PostgreSQL:** 14, 15, 16, 17 and 18.
279
285
  - **Python:** 3.11, 3.12 and 3.13 are tested in continuous integration.
280
- - **Platforms:** anywhere CPython runs.
286
+ - **Platforms:** tested on Linux. Unix sockets, `fork()` and `.pgpass` permission checks behave differently on Windows, so check those yourself there.
281
287
 
282
288
  ## Development
283
289
 
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes