# Snakemake Logger Plugin - Flowo
A Snakemake logger plugin that stores workflow execution data in PostgreSQL, making your workflow management more efficient and fun! 🎉
## 🎈 Features
- Stores Snakemake workflow execution data in PostgreSQL database
- Tracks jobs, rules, files, and errors
- Provides comprehensive logging and monitoring capabilities
- Easy integration with existing Snakemake workflows
## 💻 Installation
```bash
pip install snakemake-logger-plugin-flowo
```
## 🔧 Configuration
```bash
# To generate the default configuration file, run the following command:
# This will create the default .env configuration file in your $HOME/.config/flowo/ directory.
flowo --generate-config
# After generating the .env file, open it with your preferred text editor to adjust the settings:
vim $HOME/.config/flowo/.env
```
The following environment variables are available for configuration in the `.env` file:
- `POSTGRES_USER`: PostgreSQL username (default: flowo)
- `POSTGRES_PASSWORD`: PostgreSQL password (default: flowo_password)
- `POSTGRES_DB`: PostgreSQL database name (default: flowo_logs)
- `POSTGRES_HOST`: PostgreSQL host (default: localhost)
- `POSTGRES_PORT`: PostgreSQL port (default: localhost: 5432)
- `FLOWO_USER`: User displayed in Flowo
- `FLOWO_WORKING_PATH`: Snakemake execution project path
## 🚀 Usage
Basic usage
```bash
snakemake --logger flowo
```
config `flowo_project_name` or `flowo_tags`
```
snakemake \
--config flowo_project_name=your_project_name flowo_tags="tagA,tagB,tagC" \
--logger flowo
```
or config in --configfile
```
flowo_project_name: your_project_name
flowo_tags: "tagA,tagB,tagC"
```
## 📜 License
MIT License
Raw data
{
"_id": null,
"home_page": null,
"name": "snakemake-logger-plugin-flowo",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "logger, plugin, postgresql, snakemake, workflow",
"author": null,
"author_email": "Haomiao Zhang <zhanghm@iregene.com>, Jingmin Zhang <zhangjm@iregene.com>",
"download_url": "https://files.pythonhosted.org/packages/04/0a/74f2d4cbf92c0c73c90216471f4c3c6d143a2351f2f22f265295a5849236/snakemake_logger_plugin_flowo-0.1.5.tar.gz",
"platform": null,
"description": "# Snakemake Logger Plugin - Flowo\n\nA Snakemake logger plugin that stores workflow execution data in PostgreSQL, making your workflow management more efficient and fun! \ud83c\udf89\n\n## \ud83c\udf88 Features\n\n- Stores Snakemake workflow execution data in PostgreSQL database\n- Tracks jobs, rules, files, and errors\n- Provides comprehensive logging and monitoring capabilities\n- Easy integration with existing Snakemake workflows\n\n## \ud83d\udcbb Installation\n\n```bash\npip install snakemake-logger-plugin-flowo\n```\n## \ud83d\udd27 Configuration\n\n```bash\n# To generate the default configuration file, run the following command:\n# This will create the default .env configuration file in your $HOME/.config/flowo/ directory.\nflowo --generate-config\n\n# After generating the .env file, open it with your preferred text editor to adjust the settings:\nvim $HOME/.config/flowo/.env\n```\nThe following environment variables are available for configuration in the `.env` file:\n\n- `POSTGRES_USER`: PostgreSQL username (default: flowo)\n- `POSTGRES_PASSWORD`: PostgreSQL password (default: flowo_password)\n- `POSTGRES_DB`: PostgreSQL database name (default: flowo_logs)\n- `POSTGRES_HOST`: PostgreSQL host (default: localhost)\n- `POSTGRES_PORT`: PostgreSQL port (default: localhost: 5432)\n- `FLOWO_USER`: User displayed in Flowo\n- `FLOWO_WORKING_PATH`: Snakemake execution project path\n\n## \ud83d\ude80 Usage\nBasic usage\n```bash\nsnakemake --logger flowo\n```\nconfig `flowo_project_name` or `flowo_tags`\n```\nsnakemake \\\n --config flowo_project_name=your_project_name flowo_tags=\"tagA,tagB,tagC\" \\\n --logger flowo\n```\nor config in --configfile\n```\nflowo_project_name: your_project_name\nflowo_tags: \"tagA,tagB,tagC\"\n```\n\n\n## \ud83d\udcdc License\n\nMIT License\n",
"bugtrack_url": null,
"license": null,
"summary": "A Snakemake logger plugin that stores workflow execution data in PostgreSQL",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://github.com/your-org/snakemake-logger-plugin-flowo",
"Issues": "https://github.com/your-org/snakemake-logger-plugin-flowo/issues",
"Repository": "https://github.com/your-org/snakemake-logger-plugin-flowo"
},
"split_keywords": [
"logger",
" plugin",
" postgresql",
" snakemake",
" workflow"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "00176cfc0d2d39dee96f4fb688a4342ade03fd62fb71c1cac8a6629e6f2586eb",
"md5": "a0e9b584023e7bf89eb3f15bcafc61fa",
"sha256": "f309d00ec107204053eb6b8e90e43e44edd1fdfc224c700aaba338b6986e8607"
},
"downloads": -1,
"filename": "snakemake_logger_plugin_flowo-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a0e9b584023e7bf89eb3f15bcafc61fa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 17021,
"upload_time": "2025-07-10T03:08:49",
"upload_time_iso_8601": "2025-07-10T03:08:49.259142Z",
"url": "https://files.pythonhosted.org/packages/00/17/6cfc0d2d39dee96f4fb688a4342ade03fd62fb71c1cac8a6629e6f2586eb/snakemake_logger_plugin_flowo-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "040a74f2d4cbf92c0c73c90216471f4c3c6d143a2351f2f22f265295a5849236",
"md5": "b8f0fcc13a1487a568105eacac7b7ee3",
"sha256": "72095295b69d0560b71f56e48e1cf67a4bceac5122d1aade655d5df3bfa50d47"
},
"downloads": -1,
"filename": "snakemake_logger_plugin_flowo-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "b8f0fcc13a1487a568105eacac7b7ee3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 51798,
"upload_time": "2025-07-10T03:08:50",
"upload_time_iso_8601": "2025-07-10T03:08:50.241574Z",
"url": "https://files.pythonhosted.org/packages/04/0a/74f2d4cbf92c0c73c90216471f4c3c6d143a2351f2f22f265295a5849236/snakemake_logger_plugin_flowo-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-10 03:08:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "your-org",
"github_project": "snakemake-logger-plugin-flowo",
"github_not_found": true,
"lcname": "snakemake-logger-plugin-flowo"
}
JSON
