# Amazon Timestream Database Table Cleanup Tool
This Python CLI tool allows you to delete all tables in a specified Amazon Timestream database.
## Features
- List all tables in a Timestream database
- Delete multiple tables (with user confirmation)
- Detailed logging
## Requirements
- Python 3.12+
- AWS credentials with Timestream permissions
## Installation
1. Clone this repository:
```bash
git clone https://github.com/jbsilva/timestream-cleaner.git
cd timestream-cleaner
```
2. Install the required dependencies:
```bash
uv sync
```
Or use the `Setup Python Environment` VS Code task.
## Usage
To delete all tables in a Timestream database:
```bash
timestream-cleaner [OPTIONS] DATABASE_NAME
```
Options:
- `--region TEXT`: AWS region for Timestream database (default: eu-west-1)
- `--help`: Show help message and exit
Example:
```bash
timestream-cleaner --region eu-west-2 my-database
```
## Permissions
Required IAM permissions:
- `timestream:ListTables`
- `timestream:DeleteTable`
## Development
To contribute to this project:
1. Fork the repository
2. Create a new branch for your feature
3. Implement your changes
4. Run tests
5. Submit a pull request
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Disclaimer
This tool can permanently delete data. Use with caution and always backup your data before running
deletion operations.
Raw data
{
"_id": null,
"home_page": null,
"name": "timestream-cleaner",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "aws, cleaner, cleanup, cli, database, timestream, tool",
"author": null,
"author_email": "Julio Batista Silva <python@juliobs.com>",
"download_url": "https://files.pythonhosted.org/packages/5b/e3/4bca21e752420ff84975385d4cca84c0b818b4b689262f621ffd6c37d59f/timestream_cleaner-0.1.0.tar.gz",
"platform": null,
"description": "# Amazon Timestream Database Table Cleanup Tool\n\nThis Python CLI tool allows you to delete all tables in a specified Amazon Timestream database.\n\n## Features\n\n- List all tables in a Timestream database\n- Delete multiple tables (with user confirmation)\n- Detailed logging\n\n## Requirements\n\n- Python 3.12+\n- AWS credentials with Timestream permissions\n\n## Installation\n\n1. Clone this repository:\n\n ```bash\n git clone https://github.com/jbsilva/timestream-cleaner.git\n cd timestream-cleaner\n ```\n\n2. Install the required dependencies:\n\n ```bash\n uv sync\n ```\n\n Or use the `Setup Python Environment` VS Code task.\n\n## Usage\n\nTo delete all tables in a Timestream database:\n\n```bash\ntimestream-cleaner [OPTIONS] DATABASE_NAME\n```\n\nOptions:\n\n- `--region TEXT`: AWS region for Timestream database (default: eu-west-1)\n- `--help`: Show help message and exit\n\nExample:\n\n```bash\ntimestream-cleaner --region eu-west-2 my-database\n```\n\n## Permissions\n\nRequired IAM permissions:\n\n- `timestream:ListTables`\n- `timestream:DeleteTable`\n\n## Development\n\nTo contribute to this project:\n\n1. Fork the repository\n2. Create a new branch for your feature\n3. Implement your changes\n4. Run tests\n5. Submit a pull request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Disclaimer\n\nThis tool can permanently delete data. Use with caution and always backup your data before running\ndeletion operations.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Amazon Timestream Database Table Cleanup Tool",
"version": "0.1.0",
"project_urls": {
"CI": "https://github.com/jbsilva/timestream-cleaner/actions",
"Documentation": "https://github.com/jbsilva/timestream-cleaner#readme",
"Homepage": "https://juliobs.com/project/timestream-cleaner",
"Issues": "https://github.com/jbsilva/timestream-cleaner/issues",
"Repository": "https://github.com/jbsilva/timestream-cleaner"
},
"split_keywords": [
"aws",
" cleaner",
" cleanup",
" cli",
" database",
" timestream",
" tool"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "aa5dac034af7754185d617dbae55222a7a0767eef2931b859d37f2b31a789c6d",
"md5": "7b9119a7eba27ff79a9327b6e9c1eb0a",
"sha256": "b626a1b33733045fa5b796bf008fb854db3308908e744e9c301ad2d275ce82d1"
},
"downloads": -1,
"filename": "timestream_cleaner-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7b9119a7eba27ff79a9327b6e9c1eb0a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 5208,
"upload_time": "2025-02-03T18:38:23",
"upload_time_iso_8601": "2025-02-03T18:38:23.512323Z",
"url": "https://files.pythonhosted.org/packages/aa/5d/ac034af7754185d617dbae55222a7a0767eef2931b859d37f2b31a789c6d/timestream_cleaner-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5be34bca21e752420ff84975385d4cca84c0b818b4b689262f621ffd6c37d59f",
"md5": "5461f630ec1c88430103afee1023b992",
"sha256": "ffd2210b9c1beacec80db93e1b092ac7aba692007c4a664a6ef966221d38b0b8"
},
"downloads": -1,
"filename": "timestream_cleaner-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "5461f630ec1c88430103afee1023b992",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 5169,
"upload_time": "2025-02-03T18:38:25",
"upload_time_iso_8601": "2025-02-03T18:38:25.783904Z",
"url": "https://files.pythonhosted.org/packages/5b/e3/4bca21e752420ff84975385d4cca84c0b818b4b689262f621ffd6c37d59f/timestream_cleaner-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-03 18:38:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jbsilva",
"github_project": "timestream-cleaner",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "timestream-cleaner"
}
JSON
