{"id":15692620,"url":"https://github.com/jj/literaturame","last_synced_at":"2025-05-08T02:44:42.090Z","repository":{"id":66374583,"uuid":"65461318","full_name":"JJ/literaturame","owner":"JJ","description":"Measuring progress in literature","archived":false,"fork":false,"pushed_at":"2020-11-25T10:09:00.000Z","size":89357,"stargazers_count":7,"open_issues_count":4,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-31T16:52:51.914Z","etag":null,"topics":["complex","complex-systems","knitr","literature","perl","self-organized-criticality","yapc"],"latest_commit_sha":null,"homepage":null,"language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JJ.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2016-08-11T10:35:07.000Z","updated_at":"2024-03-19T16:51:36.000Z","dependencies_parsed_at":"2023-02-21T21:30:42.287Z","dependency_job_id":null,"html_url":"https://github.com/JJ/literaturame","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JJ%2Fliteraturame","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JJ%2Fliteraturame/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JJ%2Fliteraturame/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JJ%2Fliteraturame/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JJ","download_url":"https://codeload.github.com/JJ/literaturame/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252989681,"owners_count":21836663,"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":["complex","complex-systems","knitr","literature","perl","self-organized-criticality","yapc"],"created_at":"2024-10-03T18:36:37.201Z","updated_at":"2025-05-08T02:44:42.081Z","avatar_url":"https://github.com/JJ.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# literatura.me\n\nMeasuring progress in literature and in other creative endeavours, like programming. Preparing a paper/presentation for YAPC::EU 2016.\n\nThis repo and branch contain scripts to process repositories and generate time series of lines changed in commits, as well as, if it is a literary work that has been continously integrated, to extract the number of words changed. You need to use the `Test::Text` module in order to process it in this way.\n\n## Maybe you are looking for the YAPC::EU 2016 presentations\n\nThe talk on\n[analyzing creativity, or progress when writing books, is in this repo and also published as a GitHub page by means of reveal.js](https://jj.github.io/literaturame). The\n[lightning talk the next day, focusing on several famous Perl modules, Dancer2, Moose, Mojo and Catalyst](https://jj.github.io/literaturame/☇.html),\nsame repo (this one). Take a look at it for a shorter intro.\n\n## How to use this on your repo (or any other, for that matter)\n\nPerl needs to be installed. Do it the usual way or, better yet, using\n[`perlbrew`](https://perlbrew.pl/). I'll be using `cpanm` in the\ninstructions, so that is needed too. If you use `perlbrew`, which you\nshould, you will have both. \n\nScripts for processing repositories are contained in the appropriately named `scripts` repository. So\n\n\tcd scripts\n\tcpanm --installdeps .\n\t\nAnd then, to run the script itself, you can `cd` to the repo you want analyzed and\n\n\t/path/to/scripts/get-diffs.pl \u003cglob including all files you want to analyze\u003e \n\t\nThe repository has to be downloaded to your drive. By default, you will analyze the current repo, but you can also analyze others:\n\n\t./get-diffs.pl \u003cglob including all files you want to analyze\u003e \u003crepo directory\u003e\n\t\nThis will generate a `.csv` file with `lines` as preffix and a name related to the repo name and glob. This file will contain a single column with the size of the commit, with size being the maximum of lines added/deleted. \n\nThere is no rule to what the glob should include, other than you should try and include only files that have been typed *by hand*, not those automatically generated by, well, code generators or `LICENSE` files, that kind of thing. The whole point of this is to analyze coding patterns as reflected by commit sizes, so non-human files make no sense. \n\n## What to do with this file\n\n`cd` to `../stats`. You can plug the file name into the first lines of\n`creativity.Rmd` and, if you have R and knitr, generate the file from\nrstudio or directly from R using knitr. Please check the knitr size\nfor how to do this, or directly share your file in a repo, tell me via\ntwitter to `@jjmerelo`, and I'll do it for you. Of course, that file\nincludes author and stuff, so if you want to change conclusions,\nauthor or whatever, feel free to do so, it has the same license as the\nwhole repo. \n\nYou can also add a link to these results in [`data.md`](data.md) if you so desire. Take a look at [CONTRIBUTING.md](CONTRIBUTING.md) to do it properly (don't worry, just a minimal set of rules).\n\n## What kind of repos will be *interesting*\n\nYou will need a repo with more than a few hundred commits to have some\nreal effect showing up. And by *real effect* I mean power laws, maybe\npink noise, all that adding up to *self-organized criticality*. Which\nis kind of cool. \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjj%2Fliteraturame","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjj%2Fliteraturame","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjj%2Fliteraturame/lists"}