X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=commitid.scad.pl;h=e51318aaf26ba755d3be754fd6a867f64770898f;hb=f8a450af5183bd37b15ebb2cd85047c45066f474;hp=a2793ea3db8712ba10eb9fe933f5e78a2076298c;hpb=15f864ec10493f3960306de2bb2c7d4d988eab0a;p=reprap-play.git diff --git a/commitid.scad.pl b/commitid.scad.pl index a2793ea..e51318a 100755 --- a/commitid.scad.pl +++ b/commitid.scad.pl @@ -4,7 +4,29 @@ use strict; $SIG{__WARN__} = sub { die @_; }; # xxx much of the comment below is TODO - +# +# Usage: +# +# .../commitid.scad.pl [OPTION...] [STRING...] >commitid.scad.new \ +# && mv -f commitid.scad.new commitid.scad +# +# Options: +# +# --git generate git commit indications, as shown below +# (this is the default if no strings are requested with -t) +# +# --git=object +# generate git commit indication based on commit object only +# (ie avoid counting commits) +# +# -i do not generate `+' if git-untracked files are present +# +# [-t[FORM]] TEXT +# generate a form FORM containing TEXT +# TEXT can contain newlines (final newline usually undesirable) +# if FORM not specified, generates Arg0 Arg1 Arg2 in sequence +# character set is SPC 0-9 a-f + * +# # We generate a physical indication of which commit was used. # # We provide for scaling factors with dynamic variables: @@ -30,40 +52,53 @@ $SIG{__WARN__} = sub { die @_; }; # # We can generate these forms: # -# Tiny3: -# Tiny4: -# Tiny5: -# Tiny6: -# Tiny7: -# Tiny8: +# In each case: +# if tree is dirty, * is suffixed or prefixed to count or commitid +# if tree has untracked files, + is added +# (where it is added depends on the Form; in any case it does not +# change the size, but steals space from digits) +# +# Small2 Small3 ... Small10: # git rev-list --first-parent --count HEAD # typically 3-4 characters but we allow for up to 6 # padded with zeroes; if too long we reduce mod 10^n -# eg -# Tiny4 1070 -# -# Tiny4Q: -# Tiny6Q: -# Tiny9Q: -# same but in two lines eg -# Tiny4Q 10 -# 70 -# -# Git4 Git4Q -# Git6 Git6Q -# Git8 Git8Q +# eg if the count is 123456 +# Small5 3456* +# Small8 __123456 (where _ are spaces) +# +# Small2S Small4S ... Small10S: +# Small3T Small9T: +# same but split into two lines (S) or three lines (T) eg +# Small4S 45 Small6T _3 +# 6* 45 +# 6* +# +# Git2 Git3 ... Git10: +# Git4S Git6S ... Git10S: +# Git6T Git9T: # git-rev-parse HEAD (prefix of requested length) -# eg -# Git6 82f2a2 +# eg if the commitid is abcdef0123... +# Git5 abcd* -# Small4 -# Small6 -# Small8 +# Full4 Full6 ... Full20: # git-rev-list --first-parent --count HEAD # git-rev-parse HEAD +# (all on two lines) # eg -# Small6 1070 -# 82f2a2 +# Full6 abcdef Full8 abcdef01 +# 23456* _123456* +# +# Full6T Full9T ... Full30T +# as Full but commit is split over two lines +# for a 3-line message; eg +# Full9T abc +# de* +# 456 +# +# FontDemo +# +# Arg0, Arg1, ... +# Strings passed on command line sub p { print @_ or die $!; } @@ -85,10 +120,20 @@ sub chrmodname ($) { return "Commitid__chr_$chrx"; } +our $gtm_demo_i = -1; +our $gtm_demo_j; +our @gtm_demo_o; + +sub gentextmodule_demo_start_batch () { + $gtm_demo_j = 0; + $gtm_demo_i++; +} + sub gentextmodule ($@) { my ($form, @lines) = @_; my $modb = "Commitid_$form"; p "module ${modb}_2D(){\n"; + p " // |$_|\n" foreach @lines; p " scale(Commitid__scale()){\n"; my $y = @lines; my $cols = 1; @@ -96,9 +141,9 @@ sub gentextmodule ($@) { $y--; my $x = 0; foreach my $chr (split //, $line) { - next if $chr !~ m/\S/; p sprintf " translate([%d * 0.8, %d * 1.2]) %s();\n", - $x, $y, chrmodname $chr; + $x, $y, chrmodname $chr + if $chr =~ m/\S/; $x++; } $cols = $x if $x > $cols; @@ -109,8 +154,20 @@ sub gentextmodule ($@) { p " d=Commitid_depth();\n"; p " translate([0,0,-d]) linear_extrude(height=d*2) ${modb}_2D();\n"; p "}\n"; + p sprintf "function %s_sz() = Commitid__scale() * 0.1 * [ %d, %d ];\n", $modb, 2 * ($cols * 4 - 1), 2 * (@lines * 6 - 1); + + push @gtm_demo_o, < 0 ? (' ' x $spare) : ''). + $prefix. + substr($whole, ($spare < 0 ? -$spare : 0)); +} + +sub ljustt ($$;$) { + my ($sz, $whole, $suffix) = @_; + $suffix //= ''; + $sz -= length $suffix; + return sprintf "%-${sz}.${sz}s%s", $whole, $suffix; +} + +sub genform ($@) { + my ($form, @lines) = @_; + gentextmodule($form, @lines); + my $f = { + Form => $form, + Chars => (length join '', @lines), + Lines => (scalar @lines), + Ambiguous => ($form =~ m/Full/ && !grep { m/\W/ } @lines), + }; + push @forms, $f; +} + +sub genform_q ($$$) { + my ($form, $s, $lines) = @_; + $gtm_demo_j++; + my $l = length $s; + return if $l % $lines; + my $e = $l/$lines; + return if $e < 2; + $gtm_demo_j--; + genform($form, $s =~ m/.{$e}/g); +} + +sub genform_plusq ($$) { + my ($form, $s) = @_; + genform($form, $s); + genform_q("${form}S", $s, 2); + genform_q("${form}T", $s, 3); +} + +our @gcmd; + +sub gitrun_start () { + open F, "-|", @gcmd or die "$gcmd[0]: start: $!"; +} + +sub gitrun_done (;$) { + my ($errok) = @_; + $?=0; $!=0; + return if close F; + return if $errok; + die $! if $!; + die "@gcmd failed ($?)\n"; +} + +sub gitoutput (@) { + (@gcmd) = (qw(git), @_); + gitrun_start; + $_ = ; + gitrun_done; + defined or die "@gcmd produced no output"; + chomp or die "@gcmd produced no final newline"; + $_; +} + +sub do_git () { + return unless $do_git; + + @gcmd = qw(git status --porcelain); + push @gcmd, qw(--untracked=no) unless $do_git_untracked; + + my $git_dirty = ''; + gitrun_start; + while () { + if (m/^\?\?/ && $do_git_untracked) { + $git_dirty = '+'; + next; + } + $git_dirty = '*'; + last; + } + gitrun_done($git_dirty eq '*'); + + my $git_count; + my $git_object; + + if ($do_git =~ m/c/) { + $git_count = gitoutput qw(rev-list --first-parent --count HEAD); + } + if ($do_git =~ m/o/) { + $git_object = gitoutput qw(rev-parse HEAD); + } + + foreach my $sz (2..10) { + gentextmodule_demo_start_batch(); + + genform_plusq("Small$sz", rjustt($sz, $git_count, $git_dirty)) + if defined $git_count; + + genform_plusq("Git$sz", ljustt($sz, $git_object, $git_dirty)) + if defined $git_object; + + if (defined $git_count && defined $git_object) { + genform("Full".($sz*2), + ljustt($sz, $git_object), + rjustt($sz, $git_count, $git_dirty)); + + my $e = $sz; + genform("Full".($e*3)."T", + ljustt($e*2, $git_object, $git_dirty) + =~ m/.{$e}/g, + rjustt($e, $git_count)); + } + } +} + +sub do_some_best ($$) { + my ($modname, $formre) = @_; + p "module Commitid_$modname(max_sz) {\n"; + foreach my $f ( + sort { + $b->{Chars} <=> $a->{Chars} or + $a->{Lines} <=> $b->{Chars} + } + grep { + $_->{Form} =~ m/$formre/ && + !$_->{Ambiguous} + } + @forms + ) { + p "// $f->{Form}\n"; + } + p "}\n"; +} + +sub do_git_best () { + return unless $do_git; + + # Auto-computer for `best fit' + # + # We have two best fit approaches: with count, and git-object-id-only + # + # For `with count', we only ever include the git object id if the + # result would be unambigous. That means that at least one space + # or punctuation was generated. + # + # We sort the options by firstly number of characters + # (decreasing), and then by number of lines (increasing) and + # try each one both ways round. + + do_some_best('BestCount', 'Small|Full') if $do_git =~ m/c/; + do_some_best('BestObjid', 'Git|Full') if $do_git =~ m/o/; +} + +while (@ARGV) { + $_ = shift; + if (m/^--(no)?-git$/) { + $do_git = $1 ? '' : 'co'; + } elsif (m/^---git=object$/) { + $do_git = 'o'; + } elsif (m/^-i$/) { + $do_git_untracked = 0; + } elsif (m/^-t(.*)$/) { + my $form = $1; + die "bad usage: -t needs string argument\n"; + $_ = shift; + gentextmodule($form, split /\n/, $_); + $argcounter //= 0; + } elsif (m/^[^-]/) { + gentextmodule("Arg$argcounter", $_); + $argcounter++; + } else { + die "bad usage: unknown option \`$_'\n"; + } +} + +$do_git //= defined($argcounter) ? '' : 'co'; + +gentextmodule_demo_start_batch(); gentextmodule('FontDemo', @demo); +do_git(); +do_git_best(); + +p "module Commitid_2DDemo(){\n"; +p " st = Commitid__scale() * [ 10, 5 ];\n"; +p " e = Commitid_pixelsz();\n"; +p $_ foreach @gtm_demo_o; +p "}\n"; + +flush STDOUT or die $!; +close STDOUT or die $!; + __DATA__ # 00 20 22 02 @@ -215,3 +478,10 @@ a b c d e f # # # # # # # #/ # \## ##/ \## \## \#/ # ++ * + + # # + # \#/ +### ### + # /#\ + # #