gitlogstats 1.5.2__tar.gz → 1.7.0__tar.gz

{gitlogstats-1.5.2 → gitlogstats-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: gitlogstats
-Version: 1.5.2
+Version: 1.7.0
 Summary: Track developers' contributions to one or more git repositories within a particular time range.
 Project-URL: Homepage, https://github.com/bloombar/gitlogstats
 Project-URL: Repository, https://github.com/bloombar/gitlogstats.git
@@ -726,7 +726,8 @@ The command `gitlogstats --help` shows the usage instructions:
 ```
 usage: gitlogstats [-h] (-r REPOSITORY | -rf REPOFILE) [-u USER] [-s START]
                    [-e END] [-x EXCLUSIONS] [-f {csv,json,markdown}]
-                   [-b BRANCH] [-v] [-c] [--github] [--clobber]
+                   [-b BRANCH] [-v] [-c] [-a {developer,repository,day}]
+                   [--github] [--clobber]
 
 options:
   -h, --help            show this help message and exit
@@ -751,6 +752,11 @@ options:
                         The branch to parse, if not the default branch
   -v, --verbose         Whether to output debugging info
   -c, --clean           Remove contributors without any contribuition
+  -a {developer,repository,day}, --aggregate {developer,repository,day}
+                        Combine the results into one row per developer, summed
+                        over all repositories, one row per repository, summed
+                        over its contributors, or one row per day with
+                        activity, summed over everyone
   --github              Also report GitHub pull requests opened, merged,
                         closed and self-merged per contributor, with their git
                         and GitHub emails, their pushes to the analyzed branch
@@ -840,6 +846,27 @@ By default, every contributor in a repository's history is listed, with zeros fo
 gitlogstats -rf repos.txt -c
 ```
 
+### Totals per developer or per repository
+
+By default there is one row per contributor per repository. Add `-a developer` to get one row per developer with their statistics summed over every repository, or `-a repository` to get one row per repository summed over its contributors.
+
+```
+gitlogstats -rf repos.txt -a developer
+gitlogstats -rf repos.txt -a repository
+```
+
+Developer rows have no `repository` column; instead a `repositories` column counts the repositories the developer was active in during the date range. Repository rows have no username or email columns; a `contributors` column counts the contributors who were active in the repository during the date range. `-u` and `-c` are applied first, so `-u alice -a repository` shows Alice's share of each repository. With `--github`, a developer's rows are combined by GitHub username, so different git names linked to one GitHub account become one row, and their email addresses are listed together. A developer matched to a GitHub account in one repository but not in another (for example a repository not on GitHub) keeps a separate row for each.
+
+### Activity per day
+
+Add `-a day` to get one row per day on which anything happened, summed over every contributor and repository, in date order:
+
+```
+gitlogstats -rf repos.txt -a day
+```
+
+The columns are `date`, the usual counts, `repositories` (how many repositories had activity that day) and `contributors` (how many developers were active that day; someone active in several repositories counts once, but, as with `-a developer`, someone matched to a GitHub account in one repository and not in another counts twice). Every event is counted on its own day in local time: commits and merges on their commit date and, with `--github`, pull requests on the day they were opened, merged or closed and pushes on the day they were pushed. The days therefore add up to the totals printed without `-a`. Days without activity are left out. Combine with `-u` to see one contributor's days.
+
 ### Cloned repositories
 
 Each repository is cloned into a `repos/` directory under the directory you run the command from, and later runs update (`git pull`) the existing clone instead of cloning again, which makes them much faster. Add `--clobber` to delete the clones the run used, once the results have been printed; `repos/` itself is removed too if nothing else is left in it. Clones from other runs are kept, and nothing is deleted if the run fails before printing, so you can inspect it. With `-v`, each deleted path is listed on standard error.

{gitlogstats-1.5.2 → gitlogstats-1.7.0}/README.md

@@ -29,7 +29,8 @@ The command `gitlogstats --help` shows the usage instructions:
 ```
 usage: gitlogstats [-h] (-r REPOSITORY | -rf REPOFILE) [-u USER] [-s START]
                    [-e END] [-x EXCLUSIONS] [-f {csv,json,markdown}]
-                   [-b BRANCH] [-v] [-c] [--github] [--clobber]
+                   [-b BRANCH] [-v] [-c] [-a {developer,repository,day}]
+                   [--github] [--clobber]
 
 options:
   -h, --help            show this help message and exit
@@ -54,6 +55,11 @@ options:
                         The branch to parse, if not the default branch
   -v, --verbose         Whether to output debugging info
   -c, --clean           Remove contributors without any contribuition
+  -a {developer,repository,day}, --aggregate {developer,repository,day}
+                        Combine the results into one row per developer, summed
+                        over all repositories, one row per repository, summed
+                        over its contributors, or one row per day with
+                        activity, summed over everyone
   --github              Also report GitHub pull requests opened, merged,
                         closed and self-merged per contributor, with their git
                         and GitHub emails, their pushes to the analyzed branch
@@ -143,6 +149,27 @@ By default, every contributor in a repository's history is listed, with zeros fo
 gitlogstats -rf repos.txt -c
 ```
 
+### Totals per developer or per repository
+
+By default there is one row per contributor per repository. Add `-a developer` to get one row per developer with their statistics summed over every repository, or `-a repository` to get one row per repository summed over its contributors.
+
+```
+gitlogstats -rf repos.txt -a developer
+gitlogstats -rf repos.txt -a repository
+```
+
+Developer rows have no `repository` column; instead a `repositories` column counts the repositories the developer was active in during the date range. Repository rows have no username or email columns; a `contributors` column counts the contributors who were active in the repository during the date range. `-u` and `-c` are applied first, so `-u alice -a repository` shows Alice's share of each repository. With `--github`, a developer's rows are combined by GitHub username, so different git names linked to one GitHub account become one row, and their email addresses are listed together. A developer matched to a GitHub account in one repository but not in another (for example a repository not on GitHub) keeps a separate row for each.
+
+### Activity per day
+
+Add `-a day` to get one row per day on which anything happened, summed over every contributor and repository, in date order:
+
+```
+gitlogstats -rf repos.txt -a day
+```
+
+The columns are `date`, the usual counts, `repositories` (how many repositories had activity that day) and `contributors` (how many developers were active that day; someone active in several repositories counts once, but, as with `-a developer`, someone matched to a GitHub account in one repository and not in another counts twice). Every event is counted on its own day in local time: commits and merges on their commit date and, with `--github`, pull requests on the day they were opened, merged or closed and pushes on the day they were pushed. The days therefore add up to the totals printed without `-a`. Days without activity are left out. Combine with `-u` to see one contributor's days.
+
 ### Cloned repositories
 
 Each repository is cloned into a `repos/` directory under the directory you run the command from, and later runs update (`git pull`) the existing clone instead of cloning again, which makes them much faster. Add `--clobber` to delete the clones the run used, once the results have been printed; `repos/` itself is removed too if nothing else is left in it. Clones from other runs are kept, and nothing is deleted if the run fails before printing, so you can inspect it. With `-v`, each deleted path is listed on standard error.

{gitlogstats-1.5.2 → gitlogstats-1.7.0}/docs/SPEC.md

@@ -202,6 +202,24 @@ When several repositories are analyzed, the results are printed once, after all
 
 **Status:** Done
 
+#### OUT-6 Aggregated results
+
+`-a/--aggregate developer` prints one row per developer, summed over every repository analyzed, instead of one row per contributor per repository. Its columns are `username, start_date, end_date, commits, insertions, deletions, files, merges, repositories`, where `repositories` is the number of repositories in which the developer has any activity in the date range (a non-zero count, git or GitHub, as for `-c`); there is no `repository` column. With `--github`, the columns `github_username, prs_opened, prs_merged, prs_closed_unmerged, prs_self_merged, git_email, github_email, pushes_to_default, web_commits` follow. Rows are combined when they share a GitHub username (ignoring case), or, for rows without one, the same git `username` exactly; a developer matched to a GitHub user in one repository but not in another is reported as two rows. `username` is the git username of the developer's row with the most commits (ties alphabetical, as in STAT-11), `github_username` the first non-empty one among the developer's rows, and `git_email` and `github_email` list every distinct email of the combined rows, sorted alphabetically (ignoring case) and separated by `; `.
+
+`-a/--aggregate repository` prints one row per repository, summed over its contributors. Its columns are `repository, start_date, end_date, commits, insertions, deletions, files, merges, contributors`, where `contributors` is the number of its contributors with any activity in the date range; with `--github`, `prs_opened, prs_merged, prs_closed_unmerged, prs_self_merged, pushes_to_default, web_commits` follow. There are no `username`, `github_username`, `git_email` or `github_email` columns.
+
+In both modes every count is the sum of the combined rows, so each total equals the sum of the rows printed without `--aggregate`. A GitHub count is empty (`null` in JSON) only when it is empty in every combined row (CLI-3). Aggregation is applied after `-u` and `-c`, so it combines only the rows those options keep. Rows are sorted by `username` (or `github_username`, for a developer with no git username) or by `repository`, ignoring case. The aggregated columns are printed in every output format, and in the CSV header even when there are no rows. Without `-a`, the output is unchanged.
+
+**Status:** Done
+
+#### OUT-7 Results by day
+
+`-a/--aggregate day` prints one row per day on which anything was counted, summed over every contributor and repository analyzed, in date order. Its columns are `date, commits, insertions, deletions, files, merges, repositories, contributors`, where `date` is the day in `mm/dd/yyyy` format, `repositories` is the number of repositories with any activity that day and `contributors` the number of developers with any activity that day (a developer is identified as in OUT-6, so one person active in several repositories counts once, while one matched to a GitHub user in one repository but not in another counts twice). With `--github`, the columns `prs_opened, prs_merged, prs_closed_unmerged, prs_self_merged, pushes_to_default, web_commits` follow. There are no `username`, `repository`, `start_date`, `end_date`, `github_username`, `git_email` or `github_email` columns.
+
+Each event is counted on the day it happened, in local time, the same way FILT-1 limits the date range: a commit, merge or website commit on its commit date; a pull request as opened on the day it was created, as merged (and self-merged) on the day it was merged, and as closed without merging on the day it was closed; a push on the day it was pushed. So the day totals add up to the totals printed without `-a`. Days without any activity are left out. `-u` limits the counts to that contributor (as in CLI-3 with `--github`); `-c` changes nothing, since inactive contributors add nothing to a day. A GitHub count is empty (`null` in JSON) only when no repository with activity that day could be asked about (CLI-3). The columns are printed in the CSV header even when there are no rows.
+
+**Status:** Done
+
 ### 5. Command-Line Interface
 
 #### CLI-1 Help and usage

gitlogstats-1.7.0/docs/examples/project-1-stats.csv

@@ -0,0 +1,126 @@
+username,repository,start_date,end_date,commits,insertions,deletions,files,merges,github_username,prs_opened,prs_merged,prs_closed_unmerged,prs_self_merged,git_email,github_email,pushes_to_default,web_commits
+Jade Leong,specification-phase-exercise-sakjp,09/01/2026,10/16/2026,4,124,45,4,0,Jade-Leong,1,1,0,0,jyl9618@nyu.edu,,2,0
+Khidir Ahmed,specification-phase-exercise-sakjp,09/01/2026,10/16/2026,4,9,6,4,0,khidirahmed,2,2,0,1,kka6822@nyu.edu,kka6822@nyu.edu,2,1
+Pope,specification-phase-exercise-sakjp,09/01/2026,10/16/2026,6,31,5,6,3,pope-cruz,4,4,0,3,168572503+pope-cruz@users.noreply.github.com; popecruz822@gmail.com,,1,0
+sethderusha,specification-phase-exercise-sakjp,09/01/2026,10/16/2026,10,55,34,10,7,sethderusha,2,2,0,2,165086066+sethderusha@users.noreply.github.com; srd6665@nyu.edu,,8,0
+alissawu,specification-phase-exercise-sakjp,09/01/2026,10/16/2026,1,1,0,1,0,alissawu,1,1,0,0,alissawu77@gmail.com,alissawu77@gmail.com,0,0
+bloombar,specification-phase-exercise-sakjp,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+Dialloni,specification-phase-exercise-leodiajulce,09/01/2026,10/16/2026,5,130,6,6,3,Dialloni,0,0,0,0,119769795+Dialloni@users.noreply.github.com; dialoabo@gmail.com,,0,0
+Jrleitersdorf,specification-phase-exercise-leodiajulce,09/01/2026,10/16/2026,4,437,13,5,2,Jrleitersdorf,0,0,0,0,jrleitersdorf@gmail.com,,0,0
+Leonid2004,specification-phase-exercise-leodiajulce,09/01/2026,10/16/2026,3,189,6,3,3,Leonid2004,0,0,0,0,72578139+Leonid2004@users.noreply.github.com; leophilo7@gmail.com,,0,0
+bloombar,specification-phase-exercise-leodiajulce,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+carinutza,specification-phase-exercise-leodiajulce,09/01/2026,10/16/2026,13,146,33,18,4,carinutza,0,0,0,0,ilie.carina@gmail.com,,1,0
+YusefMoustafa,specification-phase-exercise-waterfall,09/01/2026,10/16/2026,6,119,7,6,0,YusefMoustafa,0,0,0,0,158067706+YusefMoustafa@users.noreply.github.com,,6,6
+bloombar,specification-phase-exercise-waterfall,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+krishivseth,specification-phase-exercise-waterfall,09/01/2026,10/16/2026,7,555,23,10,1,krishivseth,2,2,0,2,93362198+krishivseth@users.noreply.github.com,,1,7
+monica9482,specification-phase-exercise-waterfall,09/01/2026,10/16/2026,15,77,97,15,1,monica9482,0,0,0,0,ml9482@nyu.edu,,16,0
+sing1179,specification-phase-exercise-waterfall,09/01/2026,10/16/2026,5,91,19,5,0,sing1179,0,0,0,0,143670921+sing1179@users.noreply.github.com,,5,5
+Sarah Toussaint,specification-phase-exercise-tigers,09/01/2026,10/16/2026,3,50,2,3,0,sarahtoussaint,1,0,1,0,sat10002@nyu.edu,,3,3
+bloombar,specification-phase-exercise-tigers,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+izz04,specification-phase-exercise-tigers,09/01/2026,10/16/2026,14,175,70,14,4,izz04,6,6,0,2,73780798+izz04@users.noreply.github.com,,9,14
+jk8308-jpg,specification-phase-exercise-tigers,09/01/2026,10/16/2026,2,48,1,2,3,jk8308-jpg,2,2,0,0,jk8308@nyu.edu,,0,0
+nonyembaezue,specification-phase-exercise-tigers,09/01/2026,10/16/2026,7,32,6,7,1,nonyembaezue,0,0,0,0,cam9137@nyu.edu,,7,7
+bloombar,specification-exercise-project-1,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+sallyhegab,specification-exercise-project-1,09/01/2026,10/16/2026,5,109,14,5,1,sallyhegab,0,0,0,0,158313024+sallyhegab@users.noreply.github.com; sh6568@nyu.edu,,5,0
+sar9249,specification-exercise-project-1,09/01/2026,10/16/2026,1,1,1,1,0,sar9249,1,1,0,0,sar9249@nyu.edu,,0,1
+Ryan Lin,specification-phase-exercise-codekitchen,09/01/2026,10/16/2026,2,3,1,2,0,ryanwlin,0,0,0,0,ryanandlin@gmail.com,,2,2
+berrizy,specification-phase-exercise-codekitchen,09/01/2026,10/16/2026,2,2,3,2,0,berrizy,0,0,0,0,nahasselma@gmail.com,,2,0
+bloombar,specification-phase-exercise-codekitchen,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+rishachada,specification-phase-exercise-codekitchen,09/01/2026,10/16/2026,6,114,37,6,0,rishachada,0,0,0,0,rc5294@nyu.edu,,6,2
+schauhans,specification-phase-exercise-codekitchen,09/01/2026,10/16/2026,2,24,3,2,0,schauhans,0,0,0,0,139730145+schauhans@users.noreply.github.com; sc10486@nyu.edu,,2,1
+yufeiihuang,specification-phase-exercise-codekitchen,09/01/2026,10/16/2026,9,65,13,9,0,yufeiihuang,0,0,0,0,yufeixyhuang@gmail.com,,9,9
+AmitavNarayan,specification-phase-exercise-no-ai-team,09/01/2026,10/16/2026,26,489,443,26,7,AmitavNarayan,6,6,0,6,amitavnarayan2@gmail.com,,21,8
+Trisolis,specification-phase-exercise-no-ai-team,09/01/2026,10/16/2026,8,221,109,8,3,Trisolis,3,3,0,2,papijackwaiter@gmail.com,papijackwaiter@gmail.com,5,0
+bloombar,specification-phase-exercise-no-ai-team,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+rfang1224,specification-phase-exercise-no-ai-team,09/01/2026,10/16/2026,3,9,5,3,0,rfang1224,1,1,0,0,rf2789@nyu.edu,,2,2
+Abel200595,specification-phase-exercise-smart_monkeys-,09/01/2026,10/16/2026,1,507,1,4,0,Abel200595,0,0,0,0,ym3057@nyu.edu,,0,0
+Jialiang Cao,specification-phase-exercise-smart_monkeys-,09/01/2026,10/16/2026,4,9,19,4,0,jialiangcao,0,0,0,0,jcao2080@gmail.com,,3,0
+RayyanAhmed21,specification-phase-exercise-smart_monkeys-,09/01/2026,10/16/2026,7,252,111,7,5,RayyanAhmed21,5,5,0,5,ra4073@nyu.edu,,0,3
+bloombar,specification-phase-exercise-smart_monkeys-,09/01/2026,10/16/2026,1,15,0,1,1,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+rz3007,specification-phase-exercise-smart_monkeys-,09/01/2026,10/16/2026,2,54,4,2,0,rz3007,0,0,0,0,rz3007@nyu.edu,,0,2
+Asritha Pannem,specification-phase-exercise-controller,09/01/2026,10/16/2026,1,42,0,1,0,,0,0,0,0,asp9404@nyu.edu,,0,0
+NISUN05,specification-phase-exercise-controller,09/01/2026,10/16/2026,6,106,7,6,0,NISUN05,0,0,0,0,na3755@nyu.edu,,6,0
+Nishika Gorla,specification-phase-exercise-controller,09/01/2026,10/16/2026,3,32,4,3,0,nishikagorla,2,2,0,0,nishika.gorla@gmail.com,nishika.gorla@gmail.com,3,0
+Pranay Engineer,specification-phase-exercise-controller,09/01/2026,10/16/2026,6,70,11,6,5,PranayEng,3,3,0,3,88552049+PranayEng@users.noreply.github.com; Pme7634@nyu.edu,,1,1
+ai2652-png,specification-phase-exercise-controller,09/01/2026,10/16/2026,8,317,213,8,5,ai2652-png,5,5,0,5,ai2652@nyu.edu,,6,8
+bloombar,specification-phase-exercise-controller,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+,specification-phase-exercise-controller,09/01/2026,10/16/2026,0,0,0,0,0,scanfasri,0,0,0,0,,,1,0
+ShuoWu6529,specification-phase-exercise-forked,09/01/2026,10/16/2026,7,24,6,7,11,ShuoWu6529,6,6,0,4,sw6529@nyu.edu,sw6529@nyu.edu,1,0
+bloombar,specification-phase-exercise-forked,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+ew2725,specification-phase-exercise-forked,09/01/2026,10/16/2026,6,24,14,6,6,ew2725,5,5,0,1,ew2725@nyu.edu,,0,0
+jack-k-jiang,specification-phase-exercise-forked,09/01/2026,10/16/2026,8,37,14,8,6,jack-k-jiang,8,8,0,6,82908596+jack-k-jiang@users.noreply.github.com; jackj12358@gmail.com,,0,0
+ronaldszeto,specification-phase-exercise-forked,09/01/2026,10/16/2026,7,24,3,7,1,ronaldszeto,5,5,0,1,rs9316@nyu.edu,,1,2
+xuruikun,specification-phase-exercise-forked,09/01/2026,10/16/2026,23,93,61,23,3,xuruikun,7,7,0,7,88195416+xuruikun@users.noreply.github.com,,8,23
+MarcoHGulino,specification-phase-exercise-team2,09/01/2026,10/16/2026,5,81,36,5,0,MarcoHGulino,0,0,0,0,mg6378@nyu.edu,,3,5
+Sai Shettar,specification-phase-exercise-team2,09/01/2026,10/16/2026,12,46,14,12,0,saishettar,0,0,0,0,sai.r.shettar@gmail.com,saishettar@nyu.edu,4,12
+SiennaSSM,specification-phase-exercise-team2,09/01/2026,10/16/2026,14,122,48,14,0,SiennaSSM,0,0,0,0,sm12131@nyu.edu,,4,14
+bloombar,specification-phase-exercise-team2,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+elbow74,specification-phase-exercise-team2,09/01/2026,10/16/2026,5,86,48,5,0,elbow74,0,0,0,0,92692888+elbow74@users.noreply.github.com,,5,5
+Abyssjac,specification-phase-exercise-sth,09/01/2026,10/16/2026,7,229,183,8,1,Abyssjac,0,0,0,0,131870078+Abyssjac@users.noreply.github.com; zuzhou.abyss@gmail.com,,7,0
+Jessie Zhang,specification-phase-exercise-sth,09/01/2026,10/16/2026,7,24,10,7,0,jessiezhang218,1,1,0,1,jessiezhang0218@gmail.com; jz6102@nyu.edu,jessiezhang0218@gmail.com,1,7
+Shiqi Wang,specification-phase-exercise-sth,09/01/2026,10/16/2026,5,132,66,5,4,ShiqiWang1115,4,4,0,4,sw6423@nyu.edu,,0,0
+Sinu112,specification-phase-exercise-sth,09/01/2026,10/16/2026,2,74,2,2,0,Sinu112,2,2,0,2,xs2471@nyu.edu,,0,2
+bloombar,specification-phase-exercise-sth,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+TracyWang0904,specification-phase-exercise-byteme,09/01/2026,10/16/2026,8,226,43,21,0,TracyWang0904,0,0,0,0,yw8252@nyu.edu,,8,0
+bloombar,specification-phase-exercise-byteme,09/01/2026,10/16/2026,0,0,0,0,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+AliG643,specification-phase-exercise-purple-sasquatch,09/01/2026,10/16/2026,4,90,9,4,4,AliG643,1,1,0,0,sg7920@nyu.edu,sg7920@nyu.edu,0,0
+S1rius-Yang,specification-phase-exercise-purple-sasquatch,09/01/2026,10/16/2026,1,3,1,1,0,S1rius-Yang,0,0,0,0,hy2743@nyu.edu,,0,1
+Sirius,specification-phase-exercise-purple-sasquatch,09/01/2026,10/16/2026,3,6,4,3,0,,0,0,0,0,s1rius@SiriusdeMacBook-Pro.local,,0,0
+Yuyang-Ding1102,specification-phase-exercise-purple-sasquatch,09/01/2026,10/16/2026,4,425,63,4,7,Yuyang-Ding1102,2,1,1,1,yd2734@nyu.edu,,0,4
+Yvonne,specification-phase-exercise-purple-sasquatch,09/01/2026,10/16/2026,2,80,27,2,0,Lyvoj,0,0,0,0,261538801+Lyvoj@users.noreply.github.com,,0,0
+Zihan Chen,specification-phase-exercise-purple-sasquatch,09/01/2026,10/16/2026,6,148,88,6,0,Vent1Zzz,0,0,0,0,203582969+Vent1Zzz@users.noreply.github.com,,1,0
+bloombar,specification-phase-exercise-purple-sasquatch,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+Dizay-53,specification-exercise-hibiscus,09/01/2026,10/16/2026,3,46,3,3,0,Dizay-53,2,2,0,1,Ya2522@nyu.edu,,0,3
+LefeiKe,specification-exercise-hibiscus,09/01/2026,10/16/2026,4,54,6,4,3,LefeiKe,4,4,0,1,87459566+LefeiKe@users.noreply.github.com; lk3104@nyu.edu,,0,0
+ange285,specification-exercise-hibiscus,09/01/2026,10/16/2026,1,2,1,1,1,ange285,1,1,0,0,enjelia126@gmail.com,,0,1
+bloombar,specification-exercise-hibiscus,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+sofia-matari,specification-exercise-hibiscus,09/01/2026,10/16/2026,2,46,11,2,6,sofia-matari,2,2,0,0,sbm9838@nyu.edu,,0,0
+yasminek27,specification-exercise-hibiscus,09/01/2026,10/16/2026,9,118,28,9,5,yasminek27,9,9,0,0,yk2154@nyu.edu,,0,0
+aw4580,specification-phase-exercise-search,09/01/2026,10/16/2026,6,57,30,6,0,aw4580,0,0,0,0,134334340+aw4580@users.noreply.github.com; aw4580@nyu.edu,,7,5
+benzaslavsky,specification-phase-exercise-search,09/01/2026,10/16/2026,1,17,2,1,2,benzaslavsky,1,1,0,1,62486098+benzaslavsky@users.noreply.github.com; benzy.venue@gmail.com,,0,0
+bloombar,specification-phase-exercise-search,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+iindes,specification-phase-exercise-search,09/01/2026,10/16/2026,1,1,1,1,1,iindes,1,1,0,1,59502115+iindes@users.noreply.github.com,,0,1
+lkykathy,specification-phase-exercise-search,09/01/2026,10/16/2026,7,338,61,7,6,lkykathy,7,7,0,6,67247076+lkykathy@users.noreply.github.com; linkeying0425@gmail.com,,0,0
+saramhersch,specification-phase-exercise-search,09/01/2026,10/16/2026,1,4,0,1,0,saramhersch,0,0,0,0,smh9864@nyu.edu,,1,1
+SparkFan-ui,specification-phase-exercise-sttke,09/01/2026,10/16/2026,4,271,28,5,0,SparkFan-ui,0,0,0,0,jf4832@nyu.edu,,6,4
+bloombar,specification-phase-exercise-sttke,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+kevinhan923,specification-phase-exercise-sttke,09/01/2026,10/16/2026,3,116,185,3,0,kevinhan923,0,0,0,0,69257524+kevinhan923@users.noreply.github.com,,4,0
+23matthewc,specification-phase-exercise-nocturnal,09/01/2026,10/16/2026,0,0,0,0,2,23matthewc,0,0,0,0,76405126+23matthewc@users.noreply.github.com,,0,0
+ajoykumarrishi,specification-phase-exercise-nocturnal,09/01/2026,10/16/2026,14,310,24,14,0,ajoykumarrishi,1,1,0,0,151567609+ajoykumarrishi@users.noreply.github.com; rishi.ajoykumar9@gmail.com,,0,14
+bloombar,specification-phase-exercise-nocturnal,09/01/2026,10/16/2026,0,0,0,0,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+christinalin06,specification-phase-exercise-nocturnal,09/01/2026,10/16/2026,7,119,31,7,1,christinalin06,2,2,0,0,Christinalin006@gmail.com,,3,1
+DyingRavioli,specification-phase-exercise-goodTeam,09/01/2026,10/16/2026,5,147,87,5,3,DyingRavioli,5,5,0,5,109256424+DyingRavioli@users.noreply.github.com,,1,5
+RayyanAhmed21,specification-phase-exercise-goodTeam,09/01/2026,10/16/2026,4,121,17,4,0,RayyanAhmed21,0,0,0,0,ra4073@nyu.edu,,0,0
+UIYrj,specification-phase-exercise-goodTeam,09/01/2026,10/16/2026,3,38,4,3,2,UIYrj,2,2,0,2,158982316+UIYrj@users.noreply.github.com,,0,3
+bloombar,specification-phase-exercise-goodTeam,09/01/2026,10/16/2026,1,15,0,1,1,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+rz3007,specification-phase-exercise-goodTeam,09/01/2026,10/16/2026,2,54,4,2,0,rz3007,0,0,0,0,rz3007@nyu.edu,,0,2
+sanay-d-nyu,specification-phase-exercise-goodTeam,09/01/2026,10/16/2026,6,77,9,6,1,sanay-d-nyu,1,1,0,1,sd5113@nyu.edu,sd5113@nyu.edu,1,0
+DaniyalMl,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,1,1,0,1,0,DaniyalMlk,0,0,0,0,103329154+DaniyalMlk@users.noreply.github.com,,1,1
+Jayyu2005,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,1,6,1,1,0,Jayyu2005,0,0,0,0,jy4886@nyu.edu,,1,1
+LefeiKe,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,2,2,2,2,0,LefeiKe,0,0,0,0,lk3104@nyu.edu,,2,0
+bloombar,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,1,1,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+catw1thtea,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,3,5,3,3,0,catw1thtea,0,0,0,0,ds7746@nyu.edu,danialsagymbayev@gmail.com,3,3
+denisekos,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,1,129,5,1,0,denisekos,0,0,0,0,denise.koswara28@gmail.com,,1,1
+manzim7,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,3,9,3,3,5,manzim7,0,0,0,0,mm13507@nyu.edu,,3,0
+,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,0,0,0,0,0,mosada2515,1,0,1,0,,,0,0
+,specification-phase-exercise-ddjz,09/01/2026,10/16/2026,0,0,0,0,0,Yded21,1,0,0,0,,,0,0
+LefeiKe,specification-phase-exercise-team1,09/01/2026,10/16/2026,2,2,2,2,0,LefeiKe,0,0,0,0,lk3104@nyu.edu,,0,0
+Yded21,specification-phase-exercise-team1,09/01/2026,10/16/2026,1,187,14,1,0,Yded21,1,1,0,0,eddyzzy@outlook.com,,0,1
+ac11238,specification-phase-exercise-team1,09/01/2026,10/16/2026,9,29,12,9,0,ac11238,0,0,0,0,ac11348@nyu.edu,,12,9
+bloombar,specification-phase-exercise-team1,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+manzim7,specification-phase-exercise-team1,09/01/2026,10/16/2026,1,5,1,1,0,manzim7,0,0,0,0,mm13507@nyu.edu,,0,0
+uwtz,specification-phase-exercise-team1,09/01/2026,10/16/2026,8,189,37,8,1,uwtz,0,0,0,0,86273231+uwtz@users.noreply.github.com,,8,8
+SeanA12,specification-phase-exercise-GitLost,09/01/2026,10/16/2026,2,36,2,2,2,SeanA12,2,2,0,0,106447402+SeanA12@users.noreply.github.com; seanalliman112@gmai.com,,0,0
+bloombar,specification-phase-exercise-GitLost,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+layan-al,specification-phase-exercise-GitLost,09/01/2026,10/16/2026,4,161,5,4,0,layan-al,5,4,1,0,103759519+layan-al@users.noreply.github.com,,0,0
+ogngnaoh,specification-phase-exercise-GitLost,09/01/2026,10/16/2026,0,0,0,0,4,ogngnaoh,0,0,0,0,ngoviethoang9@gmail.com,,0,0
+rayyang262,specification-phase-exercise-GitLost,09/01/2026,10/16/2026,1,2,2,1,0,rayyang262,0,0,0,0,rayyang2026@gmail.com,,1,1
+BrianDai22,specification-phase-exercise-mihir-brian-yash-linh-theo,09/01/2026,10/16/2026,3,158,157,4,0,BrianDai22,0,0,0,0,mooprules@gmail.com,,0,0
+Mihir Ganesan,specification-phase-exercise-mihir-brian-yash-linh-theo,09/01/2026,10/16/2026,6,243,35,6,0,,0,0,0,0,mihirganesan@10-17-27-151.dynapool.wireless.nyu.edu; mihirganesan@10-17-58-124.dynapool.wireless.nyu.edu,,0,0
+bloombar,specification-phase-exercise-mihir-brian-yash-linh-theo,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+theoegoldstine,specification-phase-exercise-mihir-brian-yash-linh-theo,09/01/2026,10/16/2026,4,6,4,4,0,theoegoldstine,0,0,0,0,63026703+theoegoldstine@users.noreply.github.com,,0,4
+yash-pandya9798,specification-phase-exercise-mihir-brian-yash-linh-theo,09/01/2026,10/16/2026,1,8,2,1,0,yash-pandya9798,0,0,0,0,yash.pandya9798@gmail.com,,0,1
+RayyanAhmed21,specification-phase-exercise,09/01/2026,10/16/2026,5,175,18,5,4,RayyanAhmed21,4,4,0,4,ra4073@nyu.edu,,0,1
+bloombar,specification-phase-exercise,09/01/2026,10/16/2026,1,15,0,1,1,bloombar,1,1,0,1,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0
+rz3007,specification-phase-exercise,09/01/2026,10/16/2026,3,55,5,3,1,rz3007,1,1,0,1,rz3007@nyu.edu,,1,3
+bloombar,specification-phase-exercise-helloworld,09/01/2026,10/16/2026,1,15,0,1,0,bloombar,0,0,0,0,2209098+bloombar@users.noreply.github.com; amos@cs.nyu.edu,,0,0

{gitlogstats-1.5.2 → gitlogstats-1.7.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "gitlogstats"
 description = "Track developers' contributions to one or more git repositories within a particular time range."
-version = "1.5.2"
+version = "1.7.0"
 authors = [
   { name="Tobody Tothing", email="nobody.nothing@nowhere.com" },
 ]

{gitlogstats-1.5.2 → gitlogstats-1.7.0}/scripts/board/manifest.yaml

@@ -132,6 +132,38 @@
   family: OUT
   phase: 1
   status: Done
+- id: OUT-6
+  title: Aggregated results
+  full: -a/--aggregate developer prints one row per developer, summed over every
+    repository analyzed, instead of one row per contributor per repository. Its
+    columns are username, start_date, end_date, commits, insertions, deletions,
+    files, merges, repositories, where repositories is the number of
+    repositories in which the developer has any activity in the date range (a
+    non-zero count, git or GitHub, as for -c); there is no repository column.
+    With --github, the columns github_username, prs_opened, prs_merged,
+    prs_closed_unmerged, prs_self_merged, git_email, github_email,
+    pushes_to_default, web_commits follow. Rows are combined when they share a
+    GitHub username (ignoring case), or, for rows without…
+  section: §4 Output
+  family: OUT
+  phase: 1
+  status: Done
+- id: OUT-7
+  title: Results by day
+  full: -a/--aggregate day prints one row per day on which anything was counted,
+    summed over every contributor and repository analyzed, in date order. Its
+    columns are date, commits, insertions, deletions, files, merges,
+    repositories, contributors, where date is the day in mm/dd/yyyy format,
+    repositories is the number of repositories with any activity that day and
+    contributors the number of developers with any activity that day (a
+    developer is identified as in OUT-6, so one person active in several
+    repositories counts once, while one matched to a GitHub user in one
+    repository but not in another counts twice). With --github, the columns
+    prs_opened, prs_merged, prs_closed_unmerged, prs_self_merged…
+  section: §4 Output
+  family: OUT
+  phase: 1
+  status: Done
 - id: PKG-1
   title: Installable package
   full: The tool installs with pip install gitlogstats, which provides a

{gitlogstats-1.5.2 → gitlogstats-1.7.0}/src/gitlogstats/__main__.py

@@ -5,6 +5,7 @@ import datetime
 import re
 import sys
 from . import GitLogsParser
+from . import aggregate
 from .clones import remove_clones
 from .git_logs_parser import FIELDNAMES
 from .github import (
@@ -14,7 +15,7 @@ from .github import (
     GitHubUnavailable,
     check_gh,
 )
-from .github_stats import github_rows
+from .github_stats import github_day_rows, github_rows
 
 
 def valid_date(value):
@@ -146,6 +147,15 @@ def main():
         default=False,
         action="store_true",
     )
+    parser.add_argument(
+        "-a",
+        "--aggregate",
+        help="Combine the results into one row per developer, summed over all "
+        "repositories, one row per repository, summed over its contributors, "
+        "or one row per day with activity, summed over everyone",
+        default=None,
+        choices=aggregate.MODES,
+    )
     parser.add_argument(
         "--github",
         help="Also report GitHub pull requests opened, merged, closed and "
@@ -244,21 +254,37 @@ def main():
             verbose=args.verbose,
             clean=False if args.github else args.clean,
         )
-        rows = last_parser.parse()
-        if args.github:
-            rows = github_rows(
-                last_parser, rows, repo_url, last_parser.get_identities(), args
-            )
+        if args.aggregate == aggregate.DAY:
+            # OUT-7: rows for single days, each with its date
+            if args.github:
+                rows = github_day_rows(
+                    last_parser, repo_url, last_parser.get_identities(), args
+                )
+            else:
+                rows = last_parser.day_rows()
+            # an idle contributor adds nothing to a day; keep memory small
+            rows = [row for row in rows if aggregate.is_active(row)]
+        else:
+            rows = last_parser.parse()
+            if args.github:
+                rows = github_rows(
+                    last_parser, rows, repo_url, last_parser.get_identities(), args
+                )
         all_results.extend(rows)  # collect across repos
 
     # emit a single table (or JSON array) covering all repositories
     if last_parser is not None:
-        # an empty CSV table still gets the GitHub columns with --github
-        fieldnames = (
-            FIELDNAMES + GITHUB_FIELDNAMES + EMAIL_FIELDNAMES + ACTIVITY_FIELDNAMES
-            if args.github
-            else None
-        )
+        # an empty CSV table still gets the columns it would have had
+        if args.aggregate:
+            # OUT-6, OUT-7: one row per developer, repository or day
+            all_results = aggregate.aggregate(all_results, args.aggregate, args.github)
+            fieldnames = aggregate.fieldnames(args.aggregate, args.github)
+        elif args.github:
+            fieldnames = (
+                FIELDNAMES + GITHUB_FIELDNAMES + EMAIL_FIELDNAMES + ACTIVITY_FIELDNAMES
+            )
+        else:
+            fieldnames = None
         output = last_parser.format_results(all_results, args.format, fieldnames)
         # end with exactly one newline: CSV and Markdown output already has one
         print(output, end="" if output.endswith("\n") else "\n")

gitlogstats-1.7.0/src/gitlogstats/aggregate.py

@@ -0,0 +1,195 @@
+"""Combine result rows by developer or by repository (OUT-6), or by day (OUT-7).
+
+Everything here is pure logic over the rows the rest of the tool produces: no
+git, no network. Each aggregated row sums the counts of the rows it combines.
+"""
+
+import datetime
+
+from gitlogstats.git_logs_parser import FIELDNAMES
+from gitlogstats.github import (
+    ACTIVITY_FIELDNAMES,
+    EMAIL_FIELDNAMES,
+    GITHUB_FIELDNAMES,
+)
+from gitlogstats.identity import join_emails
+
+DEVELOPER = "developer"
+REPOSITORY = "repository"
+DAY = "day"
+MODES = [DEVELOPER, REPOSITORY, DAY]
+
+# the git counts (commits to merges), summed in every mode
+GIT_COUNTS = FIELDNAMES[4:]
+
+# the GitHub pull-request counts (CLI-3), summed in every mode
+PR_COUNTS = GITHUB_FIELDNAMES[1:]
+
+# every count; a row with any of them non-zero is active, as for -c (FILT-4)
+ALL_COUNTS = GIT_COUNTS + PR_COUNTS + ACTIVITY_FIELDNAMES
+
+
+def fieldnames(mode, github):
+    """
+    The output columns of an aggregated table, in order.
+    @param mode: DEVELOPER, REPOSITORY or DAY
+    @param github: whether the GitHub columns are reported (--github)
+    @returns: a list of column names
+    """
+    dates = ["start_date", "end_date"]
+    if mode == DEVELOPER:
+        columns = ["username"] + dates + GIT_COUNTS + ["repositories"]
+        if github:
+            columns += ["github_username"] + PR_COUNTS + EMAIL_FIELDNAMES
+            columns += ACTIVITY_FIELDNAMES
+    elif mode == DAY:
+        columns = ["date"] + GIT_COUNTS + ["repositories", "contributors"]
+        if github:
+            columns += PR_COUNTS + ACTIVITY_FIELDNAMES
+    else:
+        columns = ["repository"] + dates + GIT_COUNTS + ["contributors"]
+        if github:
+            columns += PR_COUNTS + ACTIVITY_FIELDNAMES
+    return columns
+
+
+def developer_key(row):
+    """
+    The developer a row belongs to: its GitHub user, ignoring case, when it
+    has one, otherwise its exact git username.
+    @param row: a result row
+    @returns: a hashable key
+    """
+    login = row.get("github_username")
+    if login:
+        return ("github", login.casefold())
+    return ("git", row["username"])
+
+
+def is_active(row):
+    """
+    Whether a row has any activity: a non-zero count, git or GitHub.
+    @param row: a result row
+    @returns: a bool
+    """
+    return any(row.get(field) for field in ALL_COUNTS)
+
+
+def main_username(rows):
+    """
+    The git username of a developer's rows: the one with the most commits,
+    ties alphabetical, as when combining identities in one repository (STAT-11).
+    @param rows: the rows of one developer
+    @returns: a username, or "" if every row is GitHub-only
+    """
+    named = [row for row in rows if row["username"]]
+    if not named:
+        return ""
+    return min(named, key=lambda row: (-(row["commits"] or 0), row["username"]))[
+        "username"
+    ]
+
+
+def sum_values(values):
+    """
+    Add up counts. An unavailable count (None, CLI-3) is skipped, so the total
+    is None only when every count is unavailable.
+    @param values: numbers or None
+    @returns: their sum, or None
+    """
+    present = [value for value in values if value is not None]
+    return sum(present) if present else None
+
+
+def first_text(values):
+    """
+    The first non-empty text. When there is none, "" if any value is
+    available, or None if every value is unavailable.
+    @param values: strings or None
+    @returns: a string, or None
+    """
+    values = list(values)
+    for value in values:
+        if value:
+            return value
+    return None if all(value is None for value in values) else ""
+
+
+def merge_emails(values):
+    """
+    Join '; '-separated email lists into one sorted list without repeats
+    (STAT-13), or None if every list is unavailable.
+    @param values: '; '-separated strings, "" or None
+    @returns: a '; '-separated string, or None
+    """
+    values = list(values)
+    if all(value is None for value in values):
+        return None
+    return join_emails(
+        email for value in values if value for email in value.split("; ")
+    )
+
+
+def combine(rows, columns):
+    """
+    Build the aggregated row of one group.
+    @param rows: the rows of one developer, repository or day
+    @param columns: the output columns, from fieldnames()
+    @returns: one row with those columns
+    """
+    active = [row for row in rows if is_active(row)]
+    out = {}
+    for field in columns:
+        if field == "username":
+            out[field] = main_username(rows)
+        elif field in ("repository", "start_date", "end_date", "date"):
+            out[field] = rows[0][field]
+        elif field == "repositories":
+            out[field] = len({row["repository"] for row in active})
+        elif field == "contributors":
+            out[field] = len({developer_key(row) for row in active})
+        elif field == "github_username":
+            out[field] = first_text(row[field] for row in rows)
+        elif field in EMAIL_FIELDNAMES:
+            out[field] = merge_emails(row[field] for row in rows)
+        else:
+            out[field] = sum_values(row[field] for row in rows)
+    return out
+
+
+def aggregate(rows, mode, github):
+    """
+    Combine result rows into one row per developer, repository or day. Rows
+    are sorted by username (or GitHub username, for a developer with no git
+    username) or by repository, ignoring case, or by date. Days only count
+    active rows, so a day without activity is left out (OUT-7).
+    @param rows: result rows of every repository, after -u and -c; in DAY
+        mode, rows for single days, each with a "date" key
+    @param mode: DEVELOPER, REPOSITORY or DAY
+    @param github: whether the rows carry the GitHub columns (--github)
+    @returns: the aggregated rows, sorted
+    """
+    groups = {}
+    for row in rows:
+        if mode == DEVELOPER:
+            key = developer_key(row)
+        elif mode == REPOSITORY:
+            key = row["repository"]
+        elif is_active(row):
+            key = row["date"]
+        else:
+            continue
+        groups.setdefault(key, []).append(row)
+    columns = fieldnames(mode, github)
+    combined = [combine(group, columns) for group in groups.values()]
+
+    def sort_key(row):
+        if mode == DAY:
+            return (datetime.datetime.strptime(row["date"], "%m/%d/%Y"), "")
+        if mode == DEVELOPER:
+            name = row["username"] or row.get("github_username") or ""
+        else:
+            name = row["repository"]
+        return (name.casefold(), name)
+
+    return sorted(combined, key=sort_key)