{"id":24534448,"url":"https://github.com/dogukanurker/tamga","last_synced_at":"2025-04-06T06:06:41.982Z","repository":{"id":273618318,"uuid":"916732157","full_name":"DogukanUrker/Tamga","owner":"DogukanUrker","description":"🌈 Modern, logging utility for Python with multiple output formats and colorful console output.","archived":false,"fork":false,"pushed_at":"2025-03-17T17:13:36.000Z","size":517,"stargazers_count":68,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T17:49:00.397Z","etag":null,"topics":["logger","pip","pip-package","tamga"],"latest_commit_sha":null,"homepage":"https://tamga.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DogukanUrker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-14T16:57:31.000Z","updated_at":"2025-03-24T22:55:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"0d931561-1e27-4b1c-95b4-cb801217690d","html_url":"https://github.com/DogukanUrker/Tamga","commit_stats":null,"previous_names":["dogukanurker/tamga"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DogukanUrker%2FTamga","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DogukanUrker%2FTamga/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DogukanUrker%2FTamga/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DogukanUrker%2FTamga/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DogukanUrker","download_url":"https://codeload.github.com/DogukanUrker/Tamga/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441042,"owners_count":20939239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["logger","pip","pip-package","tamga"],"created_at":"2025-01-22T11:17:18.651Z","updated_at":"2025-04-06T06:06:41.961Z","avatar_url":"https://github.com/DogukanUrker.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tamga [![PyPI Downloads](https://static.pepy.tech/badge/tamga)](https://pepy.tech/projects/tamga)\n\nA modern, logging utility for Python with multiple output formats and colorful console output.\n\n[![Installation](https://belg-api.vercel.app/badge/installation/pip3%20install%20tamga/neutral/dark)](https://pypi.org/project/tamga/)\n\ntam·ga / noun  \nAn ancient Turkic symbol or seal used for marking ownership, identity, or lineage.\n\n\u003cimg alt=\"Terminal\" src=\"https://github.com/DogukanUrker/Tamga/blob/main/Images/terminal.png?raw=true\" /\u003e\n\n## Features\n\n- 🎨 Colorful console output using Tailwind CSS color palette\n- 📁 File logging with rotation and backup\n- 📊 JSON logging with size limits and backup\n- 🗄️ SQLite database logging\n- 🚀 MongoDB integration\n- 📧 Email notifications for specific log levels\n- 🌐 API logging support\n- 🔄 Automatic file rotation and backup\n- 🎯 Multiple log levels with customizable colors\n\n## Installation\n\nTo install the `tamga` package, you can use the following commands based on your requirements:\n\n- Basic installation:\n\n  ```bash\n  pip install tamga\n  ```\n\n- With API logging support:\n\n  ```bash\n  pip install tamga[api]\n  ```\n\n- With MongoDB integration:\n\n  ```bash\n  pip install tamga[mongo]\n  ```\n\n- Full installation with all features:\n  ```bash\n  pip install tamga[full]\n  ```\n\n## Quick Start\n\n```python\nfrom tamga import Tamga\n\n# Initialize the logger\nlogger = Tamga(\n    logToFile=True,\n    logToJSON=True,\n    logToConsole=True\n)\n\n# Basic logging\nlogger.info(\"This is an info message\")\nlogger.warning(\"This is a warning\")\nlogger.error(\"This is an error\")\nlogger.success(\"This is a success message\")\nlogger.debug(\"This is a debug message\")\nlogger.critical(\"This is a critical message\")\n\n# Custom logging\nlogger.custom(\"This is a custom message\", \"CUSTOM\", \"orange\")\n```\n\n## Advanced Usage\n\n### MongoDB Integration\n\n```python\nlogger = Tamga(\n    logToMongo=True,\n    mongoURI=\"your_mongodb_uri\",\n    mongoDatabaseName=\"logs_db\",\n    mongoCollectionName=\"application_logs\"\n)\n```\n\n### Email Notifications\n\n```python\nlogger = Tamga(\n    sendMail=True,\n    smtpServer=\"smtp.gmail.com\",\n    smtpPort=587,\n    smtpMail=\"your_email@gmail.com\",\n    smtpPassword=\"your_password\",\n    smtpReceivers=[\"receiver@email.com\"],\n    mailLevels=[\"CRITICAL\", \"ERROR\"]\n)\n```\n\n### File Rotation and Backup\n\n```python\nlogger = Tamga(\n    logToFile=True,\n    logToJSON=True,\n    maxLogSize=10,  # MB\n    maxJsonSize=10,  # MB\n    enableBackup=True\n)\n```\n\n### API Integration\n\n```python\nlogger = Tamga(\n    logToAPI=True,\n    apiURL=\"http://your-api.com/logs\"\n)\n```\n\n## Available Log Levels\n\n- INFO (sky blue)\n- WARNING (amber)\n- ERROR (rose)\n- SUCCESS (emerald)\n- DEBUG (indigo)\n- CRITICAL (red)\n- DATABASE (green)\n- MAIL (neutral)\n- METRIC (cyan)\n- TRACE (gray)\n- Custom (user-defined)\n\n## Contributing\n\nContributions are welcome! Please feel free to 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## Author\n\n- Doğukan Ürker\n- Email: dogukanurker@icloud.com\n- GitHub: [@dogukanurker](https://github.com/dogukanurker)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdogukanurker%2Ftamga","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdogukanurker%2Ftamga","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdogukanurker%2Ftamga/lists"}