git-annex log --received modifier option

Only counting received and not dropped makes this show the bandwidth of
data coming into the repository, although only in a sense. Since
git-annex branch updates only happen at the end of a command, and we
don't know when a command started, it's only an approximation of the
actual bandwidth. (A previous git-annex branch update made have
happened in a different repository.)

It would be possible to also add a --dropped option, but I don't know
how useful that would be?

Sponsored-by: Nicholas Golder-Manning on Patreon
This commit is contained in:
Joey Hess 2023-11-14 14:00:06 -04:00
parent 21e66ce209
commit 0fdc1a54db
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
3 changed files with 53 additions and 25 deletions

View file

@ -41,7 +41,7 @@ false, information may not have been committed to the branch yet.
* `--sizesof=repository`
Displays a history of the total size of the annexed files in a repository
as it changed over time from the creation of the repository to the present.
over time from the creation of the repository to the present.
The repository can be "here" for the current repository, or the name of a
remote, or a repository description or uuid.
@ -65,10 +65,25 @@ false, information may not have been committed to the branch yet.
When using `--sizesof`, `--sizes`, and `--totalsizes`, this
controls the minimum interval between displays of the size.
The default is to display each recorded change to the size.
The default is to display each new recorded size.
The time is of the form "30d" or "1y".
* `--received`
Combine this option with `--sizesof` or `--sizes` to display
the amount of data received into repositories since the last
line was output.
* `--bytes`
Show sizes in bytes, disabling the default nicer units.
* `--raw-date`
Rather than the normal display of a date in the local time zone,
displays seconds since the unix epoch.
* `--since=date`, `--after=date`, `--until=date`, `--before=date`, `--max-count=N`
These options are passed through to `git log`, and can be used to limit
@ -79,15 +94,6 @@ false, information may not have been committed to the branch yet.
These options do not have an affect when using `--sizesof`, `--sizes`,
and `--totalsizes`.
* `--bytes`
Show sizes in bytes, disabling the default nicer units.
* `--raw-date`
Rather than the normal display of a date in the local time zone,
displays seconds since the unix epoch.
* `--gource`
Generates output suitable for the `gource` visualization program.