{"id":34094451,"url":"https://github.com/nsco1/py-questdb-client","last_synced_at":"2026-04-08T17:32:05.322Z","repository":{"id":41220225,"uuid":"460899861","full_name":"nsco1/py-questdb-client","owner":"nsco1","description":"A Python3 API for ingesting data into QuestDB through the InfluxDB Line Protocol.","archived":false,"fork":false,"pushed_at":"2022-06-29T16:52:51.000Z","size":78,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-14T20:24:55.170Z","etag":null,"topics":["database","ilp","python","questdb","time-series"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nsco1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-18T15:12:42.000Z","updated_at":"2022-12-11T18:48:04.000Z","dependencies_parsed_at":"2022-09-04T01:10:55.937Z","dependency_job_id":null,"html_url":"https://github.com/nsco1/py-questdb-client","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nsco1/py-questdb-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsco1%2Fpy-questdb-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsco1%2Fpy-questdb-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsco1%2Fpy-questdb-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsco1%2Fpy-questdb-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nsco1","download_url":"https://codeload.github.com/nsco1/py-questdb-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsco1%2Fpy-questdb-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31566804,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","ilp","python","questdb","time-series"],"created_at":"2025-12-14T15:03:22.212Z","updated_at":"2026-04-08T17:32:05.311Z","avatar_url":"https://github.com/nsco1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Python QuestDB ILP TCP client\n\n## Requirements\n\nThis repository contains a Python3 API for ingesting data into QuestDB through the InfluxDB Line Protocol. \n\nWe use [make](https://www.gnu.org/software/make/) as a CLI to various convenient work developer flows.\nWe use [poetry](https://python-poetry.org/docs/) to manage dependencies.\n\n### Install Flow\n\nWe require **Python 3.9.\\*, or above** installed in your system, with `pip` up-to-date, as well as `poetry`: \n\n```shell\n$ python3 --version\n$ Python 3.9.\u003csome-integer\u003e\n$ pip3 install --upgrade pip\n$ curl -sSL https://install.python-poetry.org | python3 -\n```\n\nNow we can install the project's dependencies in a virtual environment and activate it:\n\n```shell\n$ make install-dependencies\n```\n\nOr for development (Required for code quality and test flows):\n\n```shell\n$ make install-dependencies-dev\n```\n\nTo activate the environment:\n\n```shell\n$ poetry shell\n$ echo $SHLVL\n2\n```\n\nTo deactivate the environment:\n\n```shell\n$ exit\n$ echo $SHLVL\n1\n```\n\n### Code Quality Flow (Requires dev dependencies)\n\nFor convenience, we can let standard tools apply standard code formatting; the second command will report\nissues that need to be addressed before using the client in production environments.\n\n```shell\n$ make format-code\n$ make check-code-quality\n```\n\n### Test Flow (Requires dev dependencies)\n\nTo run all tests in the `tests` module:\n\n```shell\n$ make test\n```\n\nNote: QuestDB must be running, see next section.\n\n### Start/stop QuestDB Docker container Flow\n\nTo start QuestDB:\n\n```shell\n$ make compose-up\n```\n\nThis creates a folder `questdb_root` to store QuestDB's table data/metadata, server configuration files,\nand the web UI. \n\n**The Web UI is avaliable at**: [localhost:9000](http://localhost:9000).\n\nLogs can be followed on the terminal:\n\n```shell\n$ docker logs -f questdb\n```\n\nTo stop QuestDB:\n\n```shell\n$ make compose-down\n```\n\nData are available, even when QuestDB is down, in folder `questdb_root`. \n\n## Basic usage\n\n```python\nfrom datetime import datetime\nfrom questdb_ilp_client.tcp import LineTcpSender\n\n# Single line send\nwith LineTcpSender(host_name=\"localhost\", port=9009, buffer_size=4096) as ls:\n    ls.table(\"metric_name\")\n    ls.symbol(\"Symbol\", \"value\")\n    ls.column_int(\"number\", 10)\n    ls.column_float(\"double\", 12.23)\n    ls.column_str(\"string\", \"born to shine\")\n    ls.at_utc_datetime(datetime(2022, 4, 23, 0, 46, 26))\n    ls.flush()\n\n# Multiple line send\nwith LineTcpSender(host_name=\"localhost\", port=9009, buffer_size=4096) as ls:\n    for i in range(int(1e6)):\n        ls.table(\"metric_name\")\n        ls.column_int(\"counter\", i)\n        ls.at_now()\n    ls.flush()\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnsco1%2Fpy-questdb-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnsco1%2Fpy-questdb-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnsco1%2Fpy-questdb-client/lists"}