Skip to content

Commit 8a28bf5

Browse files
authored
Merge branch 'main' into dependabot/pip/tqdm-4.66.3
2 parents 94c5649 + ef18099 commit 8a28bf5

37 files changed

+4470
-103
lines changed

.bumpversion.cfg

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[bumpversion]
2-
current_version = 10.2.6
2+
current_version = 11.1.0
33
commit = True
44
tag = True
55

.github/workflows/python.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ jobs:
2828
runs-on: ubuntu-latest
2929
strategy:
3030
matrix:
31-
python-version: ["3.8", "3.9", "3.10", "3.11"]
31+
python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
3232

3333
steps:
3434
- uses: actions/checkout@v3

README.md

Lines changed: 11 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -12,32 +12,28 @@
1212
[![downloads](https://img.shields.io/pypi/dm/terminusdb-client.svg?logo=pypi)](https://pypi.python.org/pypi/terminusdb-client/)
1313

1414
[![build status](https://img.shields.io/github/workflow/status/terminusdb/terminusdb-client-python/Python%20package?logo=github)](https://github.com/terminusdb/terminusdb-client-python/actions)
15-
[![documentation](https://img.shields.io/github/deployments/terminusdb/terminusdb-client-python/github-pages?label=documentation&logo=github)](https://terminusdb.com/docs/python)
15+
[![documentation](https://img.shields.io/github/deployments/terminusdb/terminusdb-client-python/github-pages?label=documentation&logo=github)](https://terminusdb.org/docs/python)
1616
[![code coverage](https://codecov.io/gh/terminusdb/terminusdb-client-python/branch/main/graph/badge.svg?token=BclAUaOPnQ)](https://codecov.io/gh/terminusdb/terminusdb-client-python)
1717
[![license](https://img.shields.io/github/license/terminusdb/terminusdb-client-python?color=pink&logo=apache)](https://github.com/terminusdb/terminusdb-client-python/blob/main/LICENSE)
1818

1919
> Python client for TerminusDB and TerminusCMS.
2020
2121
[**TerminusDB**][terminusdb] is an [open-source][terminusdb-repo] graph database
2222
and document store. It allows you to link JSON documents in a powerful knowledge
23-
graph all through a simple document API.
23+
graph all through a simple document API, with full git-for-data version control.
2424

25-
[terminusdb]: https://terminusdb.com/
26-
[terminusdb-docs]: https://terminusdb.com/docs/
25+
[terminusdb]: https://terminusdb.org/
26+
[terminusdb-docs]: https://terminusdb.org/docs/
2727
[terminusdb-repo]: https://github.com/terminusdb/terminusdb
2828

29-
[**TerminusCMS**](https://terminusdb.com/terminuscms/) is a hosted headless content management system. It is built upon TerminusDB and is a developer-focused data management platform for complex data and content infrastructure. [Sign up and clone a demo project to see how it works][dashboard].
30-
31-
[dashboard]: https://dashboard.terminusdb.com/
32-
3329
## Requirements
3430

35-
- [TerminusDB v10.0](https://github.com/terminusdb/terminusdb-server)
31+
- [TerminusDB v11.1](https://github.com/terminusdb/terminusdb-server)
3632
- [Python >=3.8](https://www.python.org/downloads)
3733

3834
## Release Notes and Previous Versions
3935

40-
TerminusDB Client v10.0 works with TerminusDB v10.0 and TerminusCMS. Please check the [Release Notes](RELEASE_NOTES.md) to find out what has changed.
36+
TerminusDB Client v11.1 works with TerminusDB v11.1 and the [DFRNT cloud service](https://dfrnt.com). Please check the [Release Notes](RELEASE_NOTES.md) to find out what has changed.
4137

4238
## Installation
4339
- TerminusDB Client can be downloaded from PyPI using pip:
@@ -76,16 +72,16 @@ client = Client("http://127.0.0.1:6363/")
7672
client.connect()
7773
```
7874

79-
Connect to TerminusCMS
75+
Connect to TerminusDB in the cloud
8076

81-
*check the documentation for TerminusCMS about how to add the [API token](https://terminusdb.com/docs/how-to-connect-terminuscms) to the environment variable*
77+
*check the documentation on the DFRNT support page about how to add your [API token](https://support.dfrnt.com/portal/en/kb/articles/api) to the environment variable*
8278

8379

8480
```Python
8581
from terminusdb_client import Client
8682

8783
team="MyTeam"
88-
client = Client(f"https://dashboard.terminusdb.com/{team}/")
84+
client = Client(f"https://studio.dfrnt.com/api/hosted/{team}/")
8985
client.connect(team="MyTeam", use_token=True)
9086
```
9187

@@ -185,11 +181,11 @@ Do you want to delete 'mydb'? WARNING: This operation is non-reversible. [y/N]:
185181
mydb deleted.
186182
```
187183

188-
### Please check the [full Documentation](https://terminusdb.com/docs/python) for more information.
184+
### Please check the [full Documentation](https://terminusdb.org/docs/python) for more information.
189185

190186
## Guides & Tutorials
191187

192-
Visit our documentation for a range of short how-to guides, [how-to use the Python Client](https://terminusdb.com/docs/use-the-python-client) and [how to use the collaboration features with the Python Client](https://terminusdb.com/docs/collaboration-with-python-client). Alternatively, undertake the [Getting Started with the Python Client Tutorial Series.](https://github.com/terminusdb/terminusdb-tutorials/blob/main/getting_started/python-client/README.md).
188+
Visit our documentation for a range of short how-to guides, [how-to use the Python Client](https://terminusdb.org/docs/use-the-python-client) and [how to use the collaboration features with the Python Client](https://terminusdb.org/docs/collaboration-with-python-client). Alternatively, undertake the [Getting Started with the Python Client Tutorial Series.](https://github.com/terminusdb/terminusdb-tutorials/blob/main/getting_started/python-client/README.md).
193189

194190
## Testing
195191

RELEASE_NOTES.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,14 @@
11
# TerminusDB Python Client Release Notes
22

3+
## v11.1.0
4+
5+
- Add support for python 3.12
6+
- Aligned with TerminusDB 11.1 overall and general preparation for v11.2.0
7+
8+
### Bug fixes
9+
10+
- Fix schema parameter to database construction
11+
312
## v10.2.6
413

514
### Bug fixes

docs/release_steps.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Release Steps
2+
3+
## Quick Release
4+
5+
1. Update release notes (`RELEASE_NOTES.md`)
6+
2. Bump version (bumpversion [patch|minor|major])
7+
3. Push new tag (`git push origin main --tags`)
8+
9+
### Bump version (updates files + creates tag)
10+
11+
To not create a tag, use `--no-tag`.
12+
13+
```bash
14+
bumpversion [patch|minor|major]
15+
```
16+
17+
### Create and push tag (triggers automated PyPI deployment)
18+
19+
```bash
20+
git push origin main --tags
21+
```
22+
23+
**Monitor**: https://github.com/terminusdb/terminusdb-client-python/actions
24+
25+
## Details
26+
27+
### What bumpversion updates
28+
- `terminusdb_client/__version__.py`
29+
- `pyproject.toml`
30+
- `.bumpversion.cfg`
31+
32+
### Automated deployment
33+
Pushing a tag triggers GitHub Actions to:
34+
- Run tests (Python 3.8-3.12)
35+
- Build with Poetry
36+
- Publish to PyPI
37+
38+
### Manual deployment (if needed)
39+
```bash
40+
poetry build
41+
poetry publish
42+
```
43+
44+
### Troubleshooting
45+
46+
**Version conflicts:** Never delete published PyPI versions. Create a new patch release instead.
47+
48+
## Prerequisites
49+
50+
- Install: `pip install bumpversion`
51+
- PyPI publishing handled via `PYPI_API_TOKEN` secret in GitHub Actions

poetry.lock

Lines changed: 43 additions & 43 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

pyproject.toml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
[tool.poetry]
22
name = "terminusdb-client"
3-
version = "10.2.6"
3+
version = "11.1.0"
44
description = "Python client for Terminus DB"
55
authors = ["TerminusDB group"]
66
license = "Apache Software License"
77
readme = "README.md"
88

99
[tool.poetry.dependencies]
10-
python = ">=3.8.0,<3.12"
10+
python = ">=3.8.0,<3.13"
1111
requests = "^2.31.0"
1212
numpy = ">= 1.13.0"
1313
numpydoc = "*"

terminusdb_client/__version__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
__title__ = "terminusdb-client"
22
__description__ = "TerminusDB client library for accessing the Terminus DB API"
33
__url__ = ""
4-
__version__ = "10.2.6"
4+
__version__ = "11.1.0"
55
__build__ = 00
66
__author__ = "TerminusDB group"
77
__author_email__ = "[email protected]"

0 commit comments

Comments
 (0)