{"id":17842277,"url":"https://github.com/feanya/gitlab-issue-visualizer","last_synced_at":"2025-03-20T03:30:24.432Z","repository":{"id":230741539,"uuid":"779974736","full_name":"Feanya/gitlab-issue-visualizer","owner":"Feanya","description":"Drawing issue- and epic-dependency graphs and some more useful graphs for Gitlab issues in a group. ","archived":false,"fork":false,"pushed_at":"2024-12-31T11:32:03.000Z","size":123,"stargazers_count":4,"open_issues_count":7,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T22:47:42.945Z","etag":null,"topics":["gitlab"],"latest_commit_sha":null,"homepage":"","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/Feanya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2024-03-31T10:33:21.000Z","updated_at":"2025-02-20T15:07:26.000Z","dependencies_parsed_at":"2024-03-31T16:29:27.758Z","dependency_job_id":"30fd72f6-79bf-4775-a152-1eee7f355d7f","html_url":"https://github.com/Feanya/gitlab-issue-visualizer","commit_stats":null,"previous_names":["feanya/gitlab-issue-visualizer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Feanya%2Fgitlab-issue-visualizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Feanya%2Fgitlab-issue-visualizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Feanya%2Fgitlab-issue-visualizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Feanya%2Fgitlab-issue-visualizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Feanya","download_url":"https://codeload.github.com/Feanya/gitlab-issue-visualizer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244047544,"owners_count":20389203,"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":["gitlab"],"created_at":"2024-10-27T21:11:48.538Z","updated_at":"2025-03-20T03:30:24.107Z","avatar_url":"https://github.com/Feanya.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gitlab-issue-visualizer\nDrawing issue- and epic-dependency graphs and some more useful graphs for Gitlab issues in a Gitlab group. \nThis tool uses graphviz.\n\nI wrote this tool to help with project management.\n\n## What can be visualized?\n### issues \u0026 issues_slim: The big issue graph\nHere we see all issues and their dependencies (blocked and related links).\nAlso all epics are rendered, and the issues are connected to their epic. \nThe graph is modeled with the `neato` spring model, so issues that are related are next to each other and issues are next to their epic.\n\nComes in a slim version that cleans up the visuals by shrinking closed issue nodes to only their ids (instead of including their title).\n\n#### Usecases\n- Identify and get an overview of issues that are not connected to anything (no epic or cluster)\n- Find issues that might belong to an epic but are not yet added to one yet.\n- Identify big groups of issues that are connected to each other\n- Identify connections between epics (they are next to each other if their issues are connected)\n\n### epics\nBased on the configured epic-clusters (see Configuration options) the epics are shown using the `fdp` algorithm.\nThe epic rendering includes how many issues are closed out of all issues and groups the issues into clusters based on their labels.\n\n#### Usecases\n- Look at the progress of epics that are sorted into releases.\n- Look at the progress of epics that are sorted by team, or feature, ...\n\n\n### epics_relationships\nOnly useful for Gitlab Premium:\nShow the epics and their relationships. \nSince epic-relationships are only include in Gitlab Ultimate, this graph is description-based.\n\n#### Usecases\n- Visualize relationships between epics\n- Identify epics blocking other epics\n- Identify epics that are not yet linked to other epics\n- Get an overview over size of epics that depend on each other\n\n\n### clustered_issues_by_epic\nBased on the configured epic-clusters, but the issues are also rendered into the clusters. \nIssues without an epic (and therefore without a cluster) are shown divided by project.\n\nComes in a slim version that cleans up the visuals by shrinking closed issue nodes to only their ids (instead of including their title).\n\n#### Usecases\n- Identify which issues are blocking a release\n- Identify which project has the most issues without an epic (for cleanup purposes)\n\n\n## What is planned?\nSee https://github.com/Feanya/gitlab-issue-visualizer/labels/%E2%9C%A8%20Feature issues.\n\n## How to use\n1. Clone the repo\n2. Install dependencies with `requirements.txt`\n3. Copy `settings/config.example.toml` to `settings/config.toml` and insert your configuration\n4. Run `src/download.py`\n5. Run `src/render.py`\n6. Look at your beautiful graphs in `renders/`. It is advised to use a browser to look at the svgs \n   - a) because they tend to be big and\n   - b) because every epic and issue is neatly hyperlinked to the original Gitlab so you can easily read up more there.\n\n## Configuration options\n- The Gitlab `group` to look at. At the moment there is only single-group-support.\n- Which projects to use from the group\n- `Clusters`: Used in the epics-rendering: Group epics together in colored clusters.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeanya%2Fgitlab-issue-visualizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffeanya%2Fgitlab-issue-visualizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeanya%2Fgitlab-issue-visualizer/lists"}