# CrateDB Toolkit
[![Tests](https://github.com/crate/cratedb-toolkit/actions/workflows/main.yml/badge.svg)](https://github.com/crate/cratedb-toolkit/actions/workflows/main.yml)
[![Test coverage](https://img.shields.io/codecov/c/gh/crate/cratedb-toolkit.svg)](https://codecov.io/gh/crate/cratedb-toolkit/)
[![Python versions](https://img.shields.io/pypi/pyversions/cratedb-toolkit.svg)](https://pypi.org/project/cratedb-toolkit/)
[![License](https://img.shields.io/github/license/crate/cratedb-toolkit.svg)](https://github.com/crate/cratedb-toolkit/blob/main/LICENSE)
[![Status](https://img.shields.io/pypi/status/cratedb-toolkit.svg)](https://pypi.org/project/cratedb-toolkit/)
[![PyPI](https://img.shields.io/pypi/v/cratedb-toolkit.svg)](https://pypi.org/project/cratedb-toolkit/)
[![Downloads](https://pepy.tech/badge/cratedb-toolkit/month)](https://pepy.tech/project/cratedb-toolkit/)
ยป [Documentation]
| [Changelog]
| [Community Forum]
| [PyPI]
| [Issues]
| [Source code]
| [License]
| [CrateDB]
## About
This software package includes a range of modules and subsystems to work
with CrateDB and CrateDB Cloud efficiently.
You can use CrateDB Toolkit to run data I/O procedures and automation tasks
of different kinds around CrateDB and CrateDB Cloud. It can be used both as
a standalone program, and as a library.
It aims for [DWIM]-like usefulness and [UX], and provides CLI and HTTP
interfaces, and others.
## Status
Please note that the `cratedb-toolkit` package contains alpha-, beta- and
incubation-quality code, and as such, is considered to be a work in progress.
Contributions of all kinds are much welcome, in order to make it more solid,
and to add features.
Breaking changes should be expected until a 1.0 release, so version pinning is
strongly recommended, especially when using it as a library.
## Install
Install package.
```shell
pip install --upgrade cratedb-toolkit
```
Verify installation.
```shell
ctk --version
```
Run with Docker.
```shell
alias ctk="docker run --rm ghcr.io/crate/cratedb-toolkit ctk"
ctk --version
```
## Development
Contributions are very much welcome. Please visit the [](#sandbox)
documentation to learn about how to spin up a sandbox environment on your
workstation, or create a [ticket][Issues] to report a bug or share an idea
about a possible feature.
[Changelog]: https://github.com/crate/cratedb-toolkit/blob/main/CHANGES.md
[Community Forum]: https://community.crate.io/
[CrateDB]: https://crate.io/products/cratedb
[CrateDB Cloud]: https://console.cratedb.cloud/
[Documentation]: https://cratedb-toolkit.readthedocs.io/
[DWIM]: https://en.wikipedia.org/wiki/DWIM
[Issues]: https://github.com/crate/cratedb-toolkit/issues
[License]: https://github.com/crate/cratedb-toolkit/blob/main/LICENSE
[PyPI]: https://pypi.org/project/cratedb-toolkit/
[Source code]: https://github.com/crate/cratedb-toolkit
[UX]: https://en.wikipedia.org/wiki/User_experience
Raw data
{
"_id": null,
"home_page": null,
"name": "cratedb-toolkit",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "cratedb, data-processing, data-retention, toolkit",
"author": null,
"author_email": "Niklas Schmidtmer <niklas@crate.io>, Marija Selakovic <marija@crate.io>, Andreas Motl <andreas.motl@crate.io>",
"download_url": "https://files.pythonhosted.org/packages/13/c6/430b5e24d82c90c13942c23405cce77ad8db09e4a99b57fbd84f4cfebd04/cratedb_toolkit-0.0.29.tar.gz",
"platform": null,
"description": "# CrateDB Toolkit\n\n[![Tests](https://github.com/crate/cratedb-toolkit/actions/workflows/main.yml/badge.svg)](https://github.com/crate/cratedb-toolkit/actions/workflows/main.yml)\n[![Test coverage](https://img.shields.io/codecov/c/gh/crate/cratedb-toolkit.svg)](https://codecov.io/gh/crate/cratedb-toolkit/)\n[![Python versions](https://img.shields.io/pypi/pyversions/cratedb-toolkit.svg)](https://pypi.org/project/cratedb-toolkit/)\n\n[![License](https://img.shields.io/github/license/crate/cratedb-toolkit.svg)](https://github.com/crate/cratedb-toolkit/blob/main/LICENSE)\n[![Status](https://img.shields.io/pypi/status/cratedb-toolkit.svg)](https://pypi.org/project/cratedb-toolkit/)\n[![PyPI](https://img.shields.io/pypi/v/cratedb-toolkit.svg)](https://pypi.org/project/cratedb-toolkit/)\n[![Downloads](https://pepy.tech/badge/cratedb-toolkit/month)](https://pepy.tech/project/cratedb-toolkit/)\n\n\n\u00bb [Documentation]\n| [Changelog]\n| [Community Forum]\n| [PyPI]\n| [Issues]\n| [Source code]\n| [License]\n| [CrateDB]\n\n\n## About\n\nThis software package includes a range of modules and subsystems to work\nwith CrateDB and CrateDB Cloud efficiently.\n\nYou can use CrateDB Toolkit to run data I/O procedures and automation tasks\nof different kinds around CrateDB and CrateDB Cloud. It can be used both as\na standalone program, and as a library.\n\nIt aims for [DWIM]-like usefulness and [UX], and provides CLI and HTTP\ninterfaces, and others.\n\n\n## Status\n\nPlease note that the `cratedb-toolkit` package contains alpha-, beta- and\nincubation-quality code, and as such, is considered to be a work in progress.\nContributions of all kinds are much welcome, in order to make it more solid,\nand to add features.\n\nBreaking changes should be expected until a 1.0 release, so version pinning is\nstrongly recommended, especially when using it as a library.\n\n\n## Install\n\nInstall package.\n```shell\npip install --upgrade cratedb-toolkit\n```\n\nVerify installation.\n```shell\nctk --version\n```\n\nRun with Docker.\n```shell\nalias ctk=\"docker run --rm ghcr.io/crate/cratedb-toolkit ctk\"\nctk --version\n```\n\n\n## Development\n\nContributions are very much welcome. Please visit the [](#sandbox)\ndocumentation to learn about how to spin up a sandbox environment on your\nworkstation, or create a [ticket][Issues] to report a bug or share an idea\nabout a possible feature.\n\n\n\n[Changelog]: https://github.com/crate/cratedb-toolkit/blob/main/CHANGES.md\n[Community Forum]: https://community.crate.io/\n[CrateDB]: https://crate.io/products/cratedb\n[CrateDB Cloud]: https://console.cratedb.cloud/\n[Documentation]: https://cratedb-toolkit.readthedocs.io/\n[DWIM]: https://en.wikipedia.org/wiki/DWIM\n[Issues]: https://github.com/crate/cratedb-toolkit/issues\n[License]: https://github.com/crate/cratedb-toolkit/blob/main/LICENSE\n[PyPI]: https://pypi.org/project/cratedb-toolkit/\n[Source code]: https://github.com/crate/cratedb-toolkit\n[UX]: https://en.wikipedia.org/wiki/User_experience\n",
"bugtrack_url": null,
"license": "AGPL 3, EUPL 1.2",
"summary": "CrateDB Toolkit",
"version": "0.0.29",
"project_urls": {
"Changelog": "https://github.com/crate/cratedb-toolkit/blob/main/CHANGES.md",
"Documentation": "https://cratedb-toolkit.readthedocs.io/",
"Homepage": "https://cratedb-toolkit.readthedocs.io/",
"Issues": "https://github.com/crate/cratedb-toolkit/issues",
"Repository": "https://github.com/crate/cratedb-toolkit"
},
"split_keywords": [
"cratedb",
" data-processing",
" data-retention",
" toolkit"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "522ebac6c17194455df2730f4e6c53794e4c14f23d12281a2daf54382d62369d",
"md5": "75c72316888011151d4dd7a93458b017",
"sha256": "dd2e8795a85cc816a24f2bd4c2322cd0b1528b5c864d842147c745223abe5892"
},
"downloads": -1,
"filename": "cratedb_toolkit-0.0.29-py3-none-any.whl",
"has_sig": false,
"md5_digest": "75c72316888011151d4dd7a93458b017",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 150270,
"upload_time": "2024-10-13T19:52:46",
"upload_time_iso_8601": "2024-10-13T19:52:46.198816Z",
"url": "https://files.pythonhosted.org/packages/52/2e/bac6c17194455df2730f4e6c53794e4c14f23d12281a2daf54382d62369d/cratedb_toolkit-0.0.29-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "13c6430b5e24d82c90c13942c23405cce77ad8db09e4a99b57fbd84f4cfebd04",
"md5": "5e5068e28a613e3808acead1c7f1686f",
"sha256": "0bed066937157b55e53d3da8cf9554585096519ec0f83a91b09f9830e6703209"
},
"downloads": -1,
"filename": "cratedb_toolkit-0.0.29.tar.gz",
"has_sig": false,
"md5_digest": "5e5068e28a613e3808acead1c7f1686f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 155479,
"upload_time": "2024-10-13T19:52:47",
"upload_time_iso_8601": "2024-10-13T19:52:47.683293Z",
"url": "https://files.pythonhosted.org/packages/13/c6/430b5e24d82c90c13942c23405cce77ad8db09e4a99b57fbd84f4cfebd04/cratedb_toolkit-0.0.29.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-13 19:52:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "crate",
"github_project": "cratedb-toolkit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cratedb-toolkit"
}