# kiarina
[](https://www.python.org/downloads/)
[](https://badge.fury.io/py/kiarina)
[](https://github.com/kiarina/kiarina-python/blob/main/LICENSE)
> 🐍 **kiarina's Python utility collection** - A comprehensive namespace package collection providing essential utilities for modern Python development.
## 🚀 Quick Install
Install all kiarina packages with a single command:
```bash
pip install kiarina
```
This meta-package installs all kiarina utilities:
- **kiarina-utils-common** - Common utilities and helper functions
- **kiarina-utils-file** - Advanced file I/O operations with encoding detection
- **kiarina-lib-falkordb** - FalkorDB integration utilities
- **kiarina-lib-redis** - Redis integration with configuration management
- **kiarina-lib-redisearch** - RediSearch integration and query builders
- **kiarina-llm** - LLM integration utilities
## 📖 Usage
After installation, you can use any kiarina package:
```python
# Configuration parsing
from kiarina.utils.common import parse_config_string
config = parse_config_string("app.debug:true,db.port:5432")
# File operations with encoding detection
import kiarina.utils.file as kf
blob = kf.read_file("document.txt") # Auto-detects encoding
data = kf.read_json_dict("config.json", default={})
# Async file operations
import kiarina.utils.file.asyncio as kfa
blob = await kfa.read_file("large_file.dat")
# Redis integration
from kiarina.lib.redis import create_redis_client
redis = create_redis_client("redis://localhost:6379")
```
## 🎯 Individual Package Installation
If you only need specific functionality, you can install individual packages:
```bash
# Core utilities only
pip install kiarina-utils-common kiarina-utils-file
# Database libraries
pip install kiarina-lib-redis kiarina-lib-falkordb kiarina-lib-redisearch
# LLM utilities
pip install kiarina-llm
```
## 📚 Documentation
For detailed documentation, examples, and API reference, visit the main repository:
**[📖 Full Documentation](https://github.com/kiarina/kiarina-python#readme)**
## 🤝 Contributing
This is primarily a personal project, but contributions are welcome! Visit the [main repository](https://github.com/kiarina/kiarina-python) for contribution guidelines.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/kiarina/kiarina-python/blob/main/LICENSE) file for details.
---
<div align="center">
**Made with ❤️ by [kiarina](https://github.com/kiarina)**
*Building better Python utilities, one package at a time.*
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "kiarina",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": "kiarina <kiarinadawa@gmail.com>",
"keywords": "utilities, namespace-package, file-io, llm, redis, falkordb, redisearch, async, pydantic",
"author": null,
"author_email": "kiarina <kiarinadawa@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/98/d1/732be18f0c0fd3cb5a14d054c98bdb2718f77a7b6bb228314e9608a98e5e/kiarina-1.6.1.tar.gz",
"platform": null,
"description": "# kiarina\n\n[](https://www.python.org/downloads/)\n[](https://badge.fury.io/py/kiarina)\n[](https://github.com/kiarina/kiarina-python/blob/main/LICENSE)\n\n> \ud83d\udc0d **kiarina's Python utility collection** - A comprehensive namespace package collection providing essential utilities for modern Python development.\n\n## \ud83d\ude80 Quick Install\n\nInstall all kiarina packages with a single command:\n\n```bash\npip install kiarina\n```\n\nThis meta-package installs all kiarina utilities:\n\n- **kiarina-utils-common** - Common utilities and helper functions\n- **kiarina-utils-file** - Advanced file I/O operations with encoding detection\n- **kiarina-lib-falkordb** - FalkorDB integration utilities\n- **kiarina-lib-redis** - Redis integration with configuration management\n- **kiarina-lib-redisearch** - RediSearch integration and query builders\n- **kiarina-llm** - LLM integration utilities\n\n## \ud83d\udcd6 Usage\n\nAfter installation, you can use any kiarina package:\n\n```python\n# Configuration parsing\nfrom kiarina.utils.common import parse_config_string\nconfig = parse_config_string(\"app.debug:true,db.port:5432\")\n\n# File operations with encoding detection\nimport kiarina.utils.file as kf\nblob = kf.read_file(\"document.txt\") # Auto-detects encoding\ndata = kf.read_json_dict(\"config.json\", default={})\n\n# Async file operations\nimport kiarina.utils.file.asyncio as kfa\nblob = await kfa.read_file(\"large_file.dat\")\n\n# Redis integration\nfrom kiarina.lib.redis import create_redis_client\nredis = create_redis_client(\"redis://localhost:6379\")\n```\n\n## \ud83c\udfaf Individual Package Installation\n\nIf you only need specific functionality, you can install individual packages:\n\n```bash\n# Core utilities only\npip install kiarina-utils-common kiarina-utils-file\n\n# Database libraries\npip install kiarina-lib-redis kiarina-lib-falkordb kiarina-lib-redisearch\n\n# LLM utilities\npip install kiarina-llm\n```\n\n## \ud83d\udcda Documentation\n\nFor detailed documentation, examples, and API reference, visit the main repository:\n\n**[\ud83d\udcd6 Full Documentation](https://github.com/kiarina/kiarina-python#readme)**\n\n## \ud83e\udd1d Contributing\n\nThis is primarily a personal project, but contributions are welcome! Visit the [main repository](https://github.com/kiarina/kiarina-python) for contribution guidelines.\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/kiarina/kiarina-python/blob/main/LICENSE) file for details.\n\n---\n\n<div align=\"center\">\n\n**Made with \u2764\ufe0f by [kiarina](https://github.com/kiarina)**\n\n*Building better Python utilities, one package at a time.*\n\n</div>\n",
"bugtrack_url": null,
"license": null,
"summary": "A comprehensive namespace package collection providing essential utilities for modern Python development",
"version": "1.6.1",
"project_urls": {
"Changelog": "https://github.com/kiarina/kiarina-python/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/kiarina/kiarina-python#readme",
"Homepage": "https://github.com/kiarina/kiarina-python",
"Issues": "https://github.com/kiarina/kiarina-python/issues",
"Repository": "https://github.com/kiarina/kiarina-python.git"
},
"split_keywords": [
"utilities",
" namespace-package",
" file-io",
" llm",
" redis",
" falkordb",
" redisearch",
" async",
" pydantic"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9751d7a787de655b518e4b8b1a7b4cf74b53ab1f006d3bc73cfbeec1671a1235",
"md5": "37d87c21f4524de0e477fe165bd5b2b4",
"sha256": "fe7f78fee4eff455094637174ad9fc3ea94f84435a8cf19910e47ad709536d69"
},
"downloads": -1,
"filename": "kiarina-1.6.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "37d87c21f4524de0e477fe165bd5b2b4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 2558,
"upload_time": "2025-10-10T03:44:31",
"upload_time_iso_8601": "2025-10-10T03:44:31.155909Z",
"url": "https://files.pythonhosted.org/packages/97/51/d7a787de655b518e4b8b1a7b4cf74b53ab1f006d3bc73cfbeec1671a1235/kiarina-1.6.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "98d1732be18f0c0fd3cb5a14d054c98bdb2718f77a7b6bb228314e9608a98e5e",
"md5": "06cf6575ae119b88d6e0288690f72913",
"sha256": "301c58505e6cce5b15d969992afe1a834e52cbcb58e304157d6801e63f0c688f"
},
"downloads": -1,
"filename": "kiarina-1.6.1.tar.gz",
"has_sig": false,
"md5_digest": "06cf6575ae119b88d6e0288690f72913",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 2818,
"upload_time": "2025-10-10T03:44:41",
"upload_time_iso_8601": "2025-10-10T03:44:41.939114Z",
"url": "https://files.pythonhosted.org/packages/98/d1/732be18f0c0fd3cb5a14d054c98bdb2718f77a7b6bb228314e9608a98e5e/kiarina-1.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-10 03:44:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kiarina",
"github_project": "kiarina-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kiarina"
}
JSON
