{"id":13747362,"url":"https://github.com/chad/turbulence","last_synced_at":"2025-05-09T08:32:29.589Z","repository":{"id":66297546,"uuid":"1379282","full_name":"chad/turbulence","owner":"chad","description":"Hopefully-meaningful metrics","archived":false,"fork":false,"pushed_at":"2024-02-26T06:32:54.000Z","size":242,"stargazers_count":239,"open_issues_count":15,"forks_count":28,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-04-15T15:06:06.014Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://chadfowler.com","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/chad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2011-02-17T18:27:40.000Z","updated_at":"2024-08-03T06:04:07.350Z","dependencies_parsed_at":"2024-08-03T06:14:07.693Z","dependency_job_id":null,"html_url":"https://github.com/chad/turbulence","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chad%2Fturbulence","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chad%2Fturbulence/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chad%2Fturbulence/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chad%2Fturbulence/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chad","download_url":"https://codeload.github.com/chad/turbulence/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224842678,"owners_count":17379013,"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":[],"created_at":"2024-08-03T06:01:26.100Z","updated_at":"2024-11-15T20:31:37.405Z","avatar_url":"https://github.com/chad.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"Hopefully-meaningful Metrics\n============================\n\nBased on Michael Feathers' [recent work](http://www.stickyminds.com/sitewide.asp?Function=edetail\u0026ObjectType=COL\u0026ObjectId=16679\u0026tth=DYN\u0026tt=siteemail\u0026iDyn=2) in project churn and complexity.\n\nHere is how to read the graph (extracted from the above article):\n\n* The upper right quadrant is particularly important.\nThese files have a high degree of complexity, and they change quite frequently.\nThere are a number of reasons why this can happen.\nThe one to look out for, though, is something I call runaway conditionals.\nSometimes a class becomes so complex that refactoring seems too difficult.\nDevelopers hack if-then-elses into if-then-elses, and the rat’s nest grows. These classes are particularly ripe for a refactoring investment.\n\n* The lower left quadrant. is the healthy closure region.\nAbstractions here have low complexity and don't change much.\n\n* The upper left is what I call the cowboy region. This is complex code that sprang from someone's head and didn't seem to grow incrementally.\n\n* The bottom right is very interesting. I call it the fertile ground.\nIt can consist of files that are somewhat configurational, but often there are also files that act as incubators for new abstractions.\nPeople add code, it grows, and then they factor outward, extracting new classes. The files churn frequently, but their complexity remains low.\n\n\nInstallation\n------------\n\n    $ gem install turbulence\n\nUsage\n-----\nIn your project directory, run:\n\n    $ bule\n\nand it will generate (and open) turbulence/turbulence.html \n\nSupported SCM systems\n---------------------\nCurrently, bule defaults to using git. If you are using Perforce, call it like so:\n\n    $ bule --scm p4\n\nYou need to have an environment variable P4CLIENT set to the name of your client workspace.\n\nWARNING\n-------\nWhen you run bule, it creates a JavaScript file which contains your file paths and names.  If those are sensitive, be careful where you put these generated files and who you share them with.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchad%2Fturbulence","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchad%2Fturbulence","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchad%2Fturbulence/lists"}