{"id":13819096,"url":"https://github.com/dgroup/lazylead","last_synced_at":"2025-04-10T05:10:26.899Z","repository":{"id":37576589,"uuid":"234557028","full_name":"dgroup/lazylead","owner":"dgroup","description":"Eliminate the annoying work within ticketing systems (Jira, GitHub, Trello). Allows automating (without admin access) daily actions like tickets fields verification, email notifications by JQL/GQL, meeting requests to your (or teammates) calendar.","archived":false,"fork":false,"pushed_at":"2023-12-05T08:09:42.000Z","size":942,"stargazers_count":72,"open_issues_count":159,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-03T01:12:18.353Z","etag":null,"topics":["annoying","automation","docker-image","eo-badge","github","jira","lazylead","management","mit-license","oop-principles","open-source","project-management","routine-tasks","ruby","ruby-gem","task","team","teamwork","ticketing-systems","trello"],"latest_commit_sha":null,"homepage":"https://lazylead.org","language":"Ruby","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/dgroup.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"license.txt","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-17T13:46:08.000Z","updated_at":"2024-09-13T20:17:32.000Z","dependencies_parsed_at":"2024-09-19T01:06:56.616Z","dependency_job_id":"7f62a705-c618-4872-9252-6f9478f059e7","html_url":"https://github.com/dgroup/lazylead","commit_stats":{"total_commits":657,"total_committers":5,"mean_commits":131.4,"dds":"0.27549467275494677","last_synced_commit":"56fdeae1287bc827d4f02b745af84c776b5b7cbd"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgroup%2Flazylead","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgroup%2Flazylead/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgroup%2Flazylead/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgroup%2Flazylead/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dgroup","download_url":"https://codeload.github.com/dgroup/lazylead/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248161274,"owners_count":21057555,"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":["annoying","automation","docker-image","eo-badge","github","jira","lazylead","management","mit-license","oop-principles","open-source","project-management","routine-tasks","ruby","ruby-gem","task","team","teamwork","ticketing-systems","trello"],"created_at":"2024-08-04T08:00:40.042Z","updated_at":"2025-04-10T05:10:26.866Z","avatar_url":"https://github.com/dgroup.png","language":"Ruby","readme":"[![Versions](https://img.shields.io/badge/semver-2.0-green)](https://semver.org/spec/v2.0.0.html)\n[![Gem Version](https://badge.fury.io/rb/lazylead.svg)](https://rubygems.org/gems/lazylead)\n\n[![Downloads](https://img.shields.io/gem/dt/lazylead)](https://rubygems.org/gems/lazylead)\n[![](https://img.shields.io/docker/pulls/dgroup/lazylead.svg)](https://hub.docker.com/r/dgroup/lazylead \"Image pulls\")\n[![](https://images.microbadger.com/badges/image/dgroup/lazylead.svg)](https://microbadger.com/images/dgroup/lazylead \"Image layers\")\n[![Commit activity](https://img.shields.io/github/commit-activity/y/dgroup/lazylead.svg?style=flat-square)](https://github.com/dgroup/lazylead/graphs/commit-activity)\n[![Hits-of-Code](https://hitsofcode.com/github/dgroup/lazylead)](https://hitsofcode.com/view/github/dgroup/lazylead)\n[![License: MIT](https://img.shields.io/github/license/mashape/apistatus.svg)](./license.txt)\n\n[![CI](https://github.com/dgroup/lazylead/actions/workflows/build.yml/badge.svg)](https://github.com/dgroup/lazylead/actions/workflows/build.yml)\n[![0pdd](http://www.0pdd.com/svg?name=dgroup/lazylead)](http://www.0pdd.com/p?name=dgroup/lazylead)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dgroup_lazylead\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=dgroup_lazylead)\n[![codebeat badge](https://codebeat.co/badges/f3bc8c19-5986-413f-89c4-c869b1e9b705)](https://codebeat.co/projects/github-com-dgroup-lazylead-master)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/e1ec2d63ff9040d99c934e3c05c24abe)](https://www.codacy.com/manual/dgroup/lazylead?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=dgroup/lazylead\u0026amp;utm_campaign=Badge_Grade)\n[![Maintainability](https://api.codeclimate.com/v1/badges/e873a41b1c76d7b2d6ae/maintainability)](https://codeclimate.com/github/dgroup/lazylead/maintainability)\n[![codecov](https://codecov.io/gh/dgroup/lazylead/branch/master/graph/badge.svg)](https://codecov.io/gh/dgroup/lazylead)\n\n### Overview\nTicketing systems (Github, Jira, etc.) are strongly integrated into our processes and everyone understands their necessity. As soon as a developer becomes a lead/technical manager, he or she faces a set of routine tasks that are related to ticketing work. On large projects this becomes a problem, more and more you spend time running around on dashboards and tickets, looking for incorrect deviations in tickets and performing routine tasks instead of solving technical problems.\n\nThe idea of automatic management is not new, but large companies/projects are not ready yet for such a decisive breakthrough and need step-by-step solutions such as [lazylead](https://github.com/dgroup/lazylead). \nI think you remember how [static code analysis](https://en.wikipedia.org/wiki/Static_program_analysis) treated at in the past; today we have a huge toolkit (pmd, checkstyle, qulice, rubocop, peon, etc) for each language that allows you to avoid routine issues and remove from the code reviewer the unnecessary load. The same logic we can apply to our day-to-day ticket management activities - let's reduce or even remove unnecessary routine actions.\n \nJoin our telegram chat [lazylead](https://t.me/lazyleads) for discussions.\n\nLegend:\n\n- 🚴🏽 in-progress \n- ⌛ planned \n- ✅ implemented \n- 🌵 implemented, but not tested\n- ❌ not supported/planned\n\n| Daily annoying task                                                                 | Jira  | Github | Trello | SVN | Git |\n| :---------------------------------------------------------------------------------- | :---: | :----: | :----: | :----: | :----: |\n| [Notify ticket's assignee](lib/lazylead/task/alert/alert.rb)                        | ✅ | ⌛ | ⌛ | ❌ | ❌ |  \n| [Notify ticket's reporter](lib/lazylead/task/alert/alert.rb)                        | ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| [Notify ticket's manager](lib/lazylead/task/alert/alert.rb)                         | ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| [Notify about illegal \"Fix Version\" modification](lib/lazylead/task/fix_version.rb) | ✅ | ❌ | ❌ | ❌ | ❌ |\n| [Expected comment in ticket is missing](lib/lazylead/task/missing_comment.rb)       | ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| [Propagate some fields from parent ticket into sub-tasks](.docs/propagate_down.md)  | ✅ | ❌ | ❌ | ❌ | ❌ |\n| [Evaluate the ticket formatting accuracy](.docs/accuracy.md)                        | ✅ | ⌛ | ⌛ | ❌ | ❌ |  \n| Print the current capacity of team into newly created tasks                         | ⌛ | ⌛ | ⌛ | ❌ | ❌ |  \n| Create/retrofit the defect automatically into latest release                        | ⌛ | ⌛ | ❌ | ❌ | ❌ |  \n| [Notify about expired(ing) due dates](.docs/duedate_expired.md)                     | ✅ | ❌ | ⌛ | ❌ | ❌ |\n| Notify about absent original estimations                                            | ⌛ | ⌛ | ⌛ | ❌ | ❌ |\n| Notify about 'Hot potato' tickets                                                   | ⌛ | ⌛ | ⌛ | ❌ | ❌ |\n| Notify about long live tickets (aging)                                              | ⌛ | ⌛ | ⌛ | ❌ | ❌ |\n| Create a meeting(s) automatically in case some tickets appeared (group by assignee/reporters/component/ticket type/etc) | ⌛ | ⌛ | ⌛ | ❌ | ❌ |\n| Propogate fields from parent tickets to sub-tasks | ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| Notify about tickets without comments with expected text | ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| [Notify about team loading (no tasks on teammates)](lib/lazylead/task/loading.rb) | ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| Notify about tickets matches predefined multiple conditions | ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| Link automatically the ticket and Confluence page if link found in ticket's comments/description | ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| Notify about tickets assigned to your team members not by effective managers| ✅ | ⌛ | ⌛ | ❌ | ❌ |\n| Notify about modifications of important files in VCS | ❌ | ⌛ | ❌ | ✅ | 🚴 | \n| Notify about diff changes for past X period in VCS | ❌ | ⌛ | ❌ | ✅ | 🚴 | \n| Notify about changes with some text for past X period in VCS | ❌ | ⌛ | ❌ | ✅ | 🚴 | \n| [Notify when someone outside of your team changed the due date on tickets for your team](lib/lazylead/task/micromanager.rb)| ✅ | ⌛ | ❌ | ❌ | ❌ | \n| [Notify when someone outside of your team assigned a ticket directly to the developer](lib/lazylead/task/assignment.rb)| ✅ | ⌛ | ❌ | ❌ | ❌ |  \n\n| Integration                                           | Type          | Status |\n| :---------------------------------------------------- | :-----------: | :----: |\n| [Microsoft Exchange Server](lib/lazylead/exchange.rb) | Emails        | ✅ |\n| [Microsoft Exchange Server](lib/lazylead/exchange.rb) | Calendar      | ⌛ |\n| [mail.yandex.com](lib/lazylead/postman.rb)            | Emails        | ✅ |\n| [mail.google.com](lib/lazylead/postman.rb)            | Emails        | 🌵 |\n| calendar.google.com                                   | Calendar      | ⌛ |\n| slack.com                                             | Notifications | ⌛ |\n| GitHub                                                | VCS + CI/CD   | ⌛ |\n| GitLab                                                | VCS + CI/CD   | ⌛ |\n| BitBucket                                             | VCS + CI/CD   | ⌛ |\n\nNew ideas, bugs, suggestions or questions are welcome [via GitHub issues](https://github.com/dgroup/lazylead/issues/new)!\n\n### Get started\n⚠️ We're still in a very early alpha version, the API may change frequently until we release version `1.0`.\n\nLet's assume that:\n- your team is using jira as a ticketing system\n- you defined a jira filter with tickets where actions need. The filter id is `555` and it has JQL like\n   ```text\n   project=XXXX and type=Bug and status not in (Closed, Cancelled, \"Ready For Testing\", \"On Hold) \n    and parent = YYYY and duedate \u003c startOfDay()\n   ```\n- you have `MS Exchange` server for email notifications\n- you want to notify your developers during working days at `8am (UTC)` time about tickets where due dates are expired\n\nFor simplicity, we are using [docker-compose](https://docs.docker.com/compose/):\n1.  Define yml file with configuration [tasks.yml](.github/tasks.yml)\n    ```yml\n    version: '2.3'\n    services:\n    \n      lazylead:\n        image: dgroup/lazylead:latest\n        container_name: lazylead\n        mem_limit: 128m\n        environment:\n          # The jira server details.\n          # Please ensure that your jira filter(s) grants this user to see issues.\n          # Sometimes jira filter(s) may be created with restricted visibility, thus\n          #  lazylead can't find the issues. \n          jira_url: https://your.jira.com\n          jira_user: theuser\n          jira_password: thepass\n          # The MS Exchange server details, please ensure that '/ews/Exchange.asm` \n          #  will be after your server url. Just change the url to your server.\n          exchange_url: https://your.ms.exchange.server/ews/Exchange.asmx\n          exchange_user: theuser\n          exchange_password: the password\n        volumes:\n          - ./:/lazylead/db\n        # db/ll.db is sqlite file with jira related annoying tasks\n        entrypoint: bin/lazylead --sqlite db/ll.db --trace --verbose\n    ```\n    or just download the project using git\n    ```bash\n    git clone https://github.com/dgroup/lazylead.git ll \u0026\u0026 cd ll\n    ```\n\n2.  Create a container, using `docker-compose -f .github/tasks.yml up`\n    The container will stop as there were no tasks provided:\n    ```bash\n    ll \u003e docker-compose -f .github/tasks.yml up                                                         \n    Creating lazylead ... done\n    Attaching to lazylead\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Version: 0.5.0\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Memory footprint at start is 52MB\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Database: '/lazylead/db/ll.db', sql migration dir: '/lazylead/upgrades/sqlite'\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Migration applied to /lazylead/db/ll.db from /lazylead/upgrades/sqlite\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Database connection established\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] SMTP connection established with {host} as {user}.\n    lazylead    | [2020-08-09T06:17:32] WARN  [main] ll-001: No tasks found.\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Memory footprint at the end is 67MB\n    lazylead exited with code 0\n    ll \u003e \n    ```\n\n3.  Define your team and tasks in database. \n    Yes, there are no UI yet, but its planned. Pull requests are welcome! \n    The tables structure defined [here](upgrades/sqlite/001-install-main-lazylead-tables.sql).\n    Modify you [sqlite](https://sqlite.com/index.html) file(`ll.db`) using [DB Browser](https://sqlitebrowser.org/) or any similar tool.\n    Please change the `\u003cyouremail.com\u003e` to your email address in order to be in CC when developer get the notification:\n    ```sql\n    insert into teams (id, name, properties) \n               values (1, 'Dream team with lazylead', '{}');\n    insert into systems(id, properties)    \n               values (1,'{\"type\":\"Lazylead::Jira\", \"username\":\"${jira_user}\", \"password\":\"${jira_password}\", \"site\":\"${jira_url}\", \"context_path\":\"\"}');\n    insert into tasks  (name, schedule, enabled, id, system, team_id, action, properties)\n               values ('Expired due dates', \n                       'cron:0 8 * * 1-5', \n                       'true',\n                       1, 1, 1, \n                       'Lazylead::Task::AssigneeAlert',\n                       '{\"sql\":\"filter=555\", \"cc\":\"\u003cyouremail.com\u003e\", \"subject\":\"[LL] Expired due dates\", \"template\":\"lib/messages/due_date_expired.erb\", \"postman\":\"Lazylead::Exchange\"}');\n    \n    ```\n    Yes, for task scheduling we are using [cron](https://crontab.guru) here, but you may use other scheduling types from [rufus-scheduler](https://github.com/jmettraux/rufus-scheduler).\n\n4.  Once you changed `./ll.db`, please restart the container using `docker-compose -f .github/tasks.yml restart`\n    ```bash\n    ll \u003e docker-compose -f .github/tasks.yml restart\n    Restarting lazylead ... done\n    ```\n    check the logs and stop container if needed\n    ```bash\n    ll \u003e docker logs lazylead\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Version: 0.5.0\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Memory footprint at start is 52MB\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Database: '/lazylead/db/ll.db', sql migration dir: '/lazylead/upgrades/sqlite'\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Migration applied to /lazylead/db/ll.db from /lazylead/upgrades/sqlite\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Database connection established\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] SMTP connection established with {host} as {user}.\n    lazylead    | [2020-08-09T06:17:32] DEBUG [main] Task scheduled: id='1', name='Expired due dates', cron='0 8 * * 1-5', system='1', action='Lazylead::Task::AssigneeAlert', team_id='1', description='', enabled='true', properties='{\"sql\":\"filter=555\", \"cc\":\"my.email@google.com\", \"subject\":\"[LL] Expired due dates\", \"template\":\"lib/messages/due_date_expired.erb\", \"postman\":\"Lazylead::Exchange\"}'\n    ...\n    ```\n\n### How to contribute?\n\n\u003ca href=\"https://www.buymeacoffee.com/lazylead\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" \u003e\u003c/a\u003e\n\nPull requests are welcome! Don't forget to add your name to contribution section and run this, beforehand:\n```ruby\nrake -A\n```\nEveryone interacting in this project’s codebases, issue trackers, chat rooms is expected to follow the [code of conduct](.github/CODE_OF_CONDUCT.md).\n","funding_links":["https://www.buymeacoffee.com/lazylead"],"categories":["Happy Exploring 🤘","Ruby"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgroup%2Flazylead","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdgroup%2Flazylead","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgroup%2Flazylead/lists"}