summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Makefile6
-rw-r--r--activity.144
-rwxr-xr-xactivity.lua (renamed from generate.lua)0
3 files changed, 49 insertions, 1 deletions
diff --git a/Makefile b/Makefile
index 236b04d..161fed2 100644
--- a/Makefile
+++ b/Makefile
@@ -2,6 +2,8 @@ LUA_VERSION=5.4
PREFIX=/usr/local
BINDIR=$(PREFIX)/bin
DATADIR=$(PREFIX)/share
+MANDIR=$(DATADIR)/man
+MAN1DIR=$(MANDIR)/man1
LUA_LMOD=$(DATADIR)/lua/$(LUA_VERSION)
all:
@@ -10,11 +12,13 @@ all:
install:
install -m644 -Dt $(DESTDIR)$(LUA_LMOD)/activity activity/*.lua
install -m644 -Dt $(DESTDIR)$(LUA_LMOD)/activity/formats activity/formats/*.lua
- install -m755 -DT generate.lua $(DESTDIR)$(BINDIR)/activity
+ install -m755 -DT activity.lua $(DESTDIR)$(BINDIR)/activity
+ install -m644 -Dt $(DESTDIR)$(MAN1DIR) activity.1
uninstall:
rm -rf $(DESTDIR)$(LUA_LMOD)/activity
rm -f $(DESTIR)$(BINDIR)/activity
+ rm -f $(DESTIR)$(MAN1DIR)/activity.1
test:
busted
diff --git a/activity.1 b/activity.1
new file mode 100644
index 0000000..0ed1eb3
--- /dev/null
+++ b/activity.1
@@ -0,0 +1,44 @@
+.TH activity 1 "2024-02-11"
+.SH NAME
+activity - generates a rolling or yearly activity chart for git repositories
+.SH SYNOPSIS
+.B activity
+.RB [ \-y
+.IR year ]
+.RB [ \-f
+.IR format ]
+.RB [ \-A | \-C
+.IR email ]...
+.RI [ repositories ]...
+.SH DESCRIPTION
+Activity counts daily commits in selected repositories and creates a calendar year chart or up to last 53 weeks rolling
+chart. Chart is a day-based heatmap, where the colour intensifies along the number of commits.
+.P
+Optionally, a filter can be applied to only count commits committed or authored by a person using selected e-mails. More
+than one address can be provided and if any of them match, the commit will be included.
+.SH EXIT STATUS
+If no errors were encountered during chart generation, a
+.B 0
+exit status is returned from the process. If an error occurred, a non-zero exit status is returned. Not all errors are
+considered critical and in some cases an incomplete chart may be still generated.
+.SH EXAMPLES
+.SS Print rolling chart for the repository owning current working directory
+.RS
+.EX
+$ activity
+.EE
+.RE
+.SS Generate SVG chart for 2023 for all repositories in a list
+.RS
+.EX
+$ xargs activity -y2023 -fsvg <repositories >activity.svh
+.EE
+.RE
+.SS Generate HTML5 rolling chart filtered by matching either author or committer in all repositories in a list
+.RS
+.EX
+$ xargs activity -Aplease@ignore.pl -Cplease@ignore.pl -fhtml5 <repositories >activity.html
+.EE
+.RE
+.SH SEE ALSO
+.BR git (1)
diff --git a/generate.lua b/activity.lua
index a97e79d..a97e79d 100755
--- a/generate.lua
+++ b/activity.lua