Revise bur's tables

Also tidy up modulist and git-cull while we're at it.

Author: hivehand

README.md

@@ -3,7 +3,6 @@
 This is a small set of tools that scratch various personal itches. You
 may or may not find any of them remotely useful.
 
-
 (See also the excellent [moreutils][].)
 
 [moreutils]: https://joeyh.name/code/moreutils/

Rakefile

@@ -1,7 +1,7 @@
 bin_dir = File.expand_path "~/bin"
 directory bin_dir
 
-files = %w[ alert bur dl jj loo modulist nn path spine ]
+files = %w[ alert bur dl jj loo modulist nn path psrender spine ]
 files.concat Dir.glob("brew-*")
 files.concat Dir.glob("git-*")
 

bur

@@ -49,11 +49,13 @@ body {
 }
 
 table {
-  horizontal-align: center
+  horizontal-align: center;
+  border-collapse: collapse;
+  empty-cells: hide;
 }
 
-td {
-    padding: 0.2em;
+tr {
+  padding: 10em;
 }
 
 tr.title {
@@ -62,6 +64,16 @@ tr.title {
     /* column-span: 2;    */
 }
 
+tr.alt {
+    background-color: #e6f3ff;
+}
+
+/* tr:nth-child(even){background-color: #f2f2f2} */
+
+td {
+  padding: 0.5em;
+}
+
 td.name {
     text-align: right;
 }
@@ -161,6 +173,8 @@ def monolith_table(groups, metadata)
     t.align = 'center'
   end
 
+  even = false
+
   groups.each do |group_name, members|
     title = Table::Row.new do |r|
       r.content = ['', '', group_name]
@@ -177,6 +191,8 @@ def monolith_table(groups, metadata)
                        metadata[formula]['desc']
                      )
         r.first.class_ = 'name'
+        r.class_ = 'alt' if even
+        even = !even
       end
       table.push content
     end

git-cull

@@ -20,4 +20,5 @@ else
   end
 end
 
+# Switch back to the starting point, unless it was one of the ones culled.
 %x(git checkout -q #{sp}) unless cullees.include?(sp)

modulist

@@ -26,23 +26,31 @@ class Stash
     FileUtils.mkdir_p(@stash_path)
   end
 
+  # Return the tail end of a basename. This is separate from full_path because
+  # we also use the tail end as part of a glob for the `purge` step below.
 
   def name_tail(type)
     hostname = %x(hostname -s).chomp
 
-    "#{[hostname, type].join('_')}.txt"
+    [hostname, type].join('_') + '.txt'
   end
 
+  # Given the name of a type, return an absolute path, in the dedicated
+  # directory, to a file whose name incorporates the date, base hostname, and
+  # type.
 
   def full_path(type)
     date = Date.today.to_s
 
-    base = [date, name_tail(type)].join('_')
+    basename = [date, name_tail(type)].join('_')
 
-    File.join(@stash_path, base)
+    File.join(@stash_path, basename)
   end
 
 
+  # Given the name of a type (e.g. "brew", "gem"), write a list of currently-
+  # installed instances to a file.
+
   def store(type)
     latest = full_path(type)
 
@@ -62,6 +70,7 @@ class Stash
     end
   end
 
+  # Clean up by deleting all but the most recent stash for this host and type.
 
   def purge(type)
     fileset = Dir.glob(File.join(@stash_path, "*#{name_tail(type)}")).sort