Build-time unit tests.

No changes to the actual seedtool code, so no version number change.

* Extensive build-time unit tests using `shunit2`.
* Phase of build script output during execution in blue.
* Properly check for existence of bc-ur.
* Corrections to MANUAL.
* Added note about new build-time dependency on `shunit2` to README.

Author: wolfmcnally

MANUAL.md

@@ -211,8 +211,6 @@ tuna acid epic gyro tiny able able acid also unit road trip quad jump rock gift
 
 Multiple groups and a group threshold may be specified. If omitted, the default `--group-threshold` is 1.
 
-**✅ NOTE**: The first two words of a set of SSKR shares are the same across all the shares. Each group within a set of SSKR shares has the same third word.
-
 ```
 #
 # Generate a 16 byte seed and display it as SSKR, first group
@@ -849,7 +847,7 @@ When encoding a multi-part UR, seedtool outputs the minimum number of parts need
 # Generate a multi-part UR
 #
 
-$ seedtool --count 300 --deterministic=TEST --ur=50
+$ seedtool --count 300 --deterministic TEST --ur=50
 ur:crypto-seed/1-7/ltadatcfademcyimclztbehddpoeadhkaddwnteelblrcygldwvarflojtcywyjytpdkfwprylienshnjnpluypmamtkmybsjkspvseesawmrltdlplgcpwsadjk
 ur:crypto-seed/2-7/ltaoatcfademcyimclztbehddpkplfbkqzztglfeoyaegsnedtrowsdpgtimmwzspfqdjkhshyfrylenpdnnnswmbeheclasztgmdstpoennbtflwykbcxclayrn
 ur:crypto-seed/3-7/ltaxatcfademcyimclztbehddptpktgwcxdkhtskwkkgmdmdlubblstnoxpkpysotntbcmotbdwfetqzwsckmscadwssgarysfeomohdytfhlbmeottijlfrvefm
@@ -862,38 +860,40 @@ ur:crypto-seed/7-7/ltatatcfademcyimclztbehddptpgsglmdbnmknebkkscymofpkteyvoatjlq
 # Generate the same multi-part UR, but add 10 additional parts
 #
 
-$ seedtool --count 300 --deterministic=TEST --ur=50 --parts 10
-ur:crypto-seed/1-7/ltadatcfademcyimclztbehddpoeadhkaddwnteelblrcygldwvarflojtcywyjytpdkfwprylienshnjnpluypmamtkmybsjkspvseesawmrltdlplgcpwsadjk
-ur:crypto-seed/2-7/ltaoatcfademcyimclztbehddpkplfbkqzztglfeoyaegsnedtrowsdpgtimmwzspfqdjkhshyfrylenpdnnnswmbeheclasztgmdstpoennbtflwykbcxclayrn
-ur:crypto-seed/3-7/ltaxatcfademcyimclztbehddptpktgwcxdkhtskwkkgmdmdlubblstnoxpkpysotntbcmotbdwfetqzwsckmscadwssgarysfeomohdytfhlbmeottijlfrvefm
-ur:crypto-seed/4-7/ltaaatcfademcyimclztbehddpiogmdnayhholprylstdieytohtweknvtwsdifhbwsptadlzsldrpnspscsutkkiyfzeyvtyajlvlsewnhkjltduohddaahbkia
-ur:crypto-seed/5-7/ltahatcfademcyimclztbehddpdwinbschfzkiaygmmudpcnkklahfoxdksgsgvlrstyvlbsvsaxbsmwenfezcurgtlpuecwfehgatkspriymotofgcettkpgrla
-ur:crypto-seed/6-7/ltamatcfademcyimclztbehddpmhguskgeflfyfspliorntefgdkykpswzwyrywtpfvwdeecahtdhhvalrnynbtiwnbdctuesabtmnecvapratdwlbvlisytlati
-ur:crypto-seed/7-7/ltatatcfademcyimclztbehddptpgsglmdbnmknebkkscymofpkteyvoatjlqdaovesffhylgdimamcyadctgstymddlynpeaotpiecffdhkaeaeaeaewfjyvlsg
-ur:crypto-seed/8-7/ltayatcfademcyimclztbehddpmhguskgeflfyfspliorntefgdkykpswzwyrywtpfvwdeecahtdhhvalrnynbtiwnbdctuesabtmnecvapratdwlbvlzmgyzmpd
-ur:crypto-seed/9-7/ltasatcfademcyimclztbehddptslsguretstejsuelrhfttahhyguoncnjoknmnismsehtepthejehfskdyflfgcmmhplamlonytowphnkprdmdiswfttcndnmh
-ur:crypto-seed/10-7/ltbkatcfademcyimclztbehddpcactfnnskeotcflffrdiwyotsbiabeldnykngadlcxoximhllndwvartptgeaeyknbgrfzldlbjlwpkgwmtpaehttlehspkgzs
-ur:crypto-seed/11-7/ltbdatcfademcyimclztbehddpkkgmrhvyhertwlleqzclluchkgfxsaztbbolmuzsstkkwfrkonflcxntislybgihwlsretsacmjyyttbaeeyjkrtzstpfrmufe
-ur:crypto-seed/12-7/ltbnatcfademcyimclztbehddpaefradredesahtzmaxmyatsgiapaetotskcssbfmcydtghhpnlfmplwyaduysorhwmrsbgtowmynfppaiylbmeottikbyllyhs
-ur:crypto-seed/13-7/ltbtatcfademcyimclztbehddpbntiqdgooxmnpsdnqzjnbbfmsrpswsrpkbeyingejybkmovwnnpfcmecyncaytkprpvoehesfygmcljynnfheedmlrryhestue
-ur:crypto-seed/14-7/ltbaatcfademcyimclztbehddpfsollauemkgdryztceiotavelonlhpcwdmlfsrtnlagtylgdcymuiesrcypydssnmhktimykjzftrerybwkpzseygtzsctdpbb
-ur:crypto-seed/15-7/ltbsatcfademcyimclztbehddpwddatejegwlssfdamkehayvytbsgzmethyyagtprchkedkytfeyaeyamdrwphnuyaetajzkiynwkhkutiytkjlhtrnsolrlaby
-ur:crypto-seed/16-7/ltbeatcfademcyimclztbehddpfltimtzomhmsgsjovlvsaofxknolasttnnstkbtpjpcfvapslgempffppkvdmtvdndpatpgemsfztalpstryrhchbefpwdeyvs
-ur:crypto-seed/17-7/ltbyatcfademcyimclztbehddpfsollauemkgdryztceiotavelonlhpcwdmlfsrtnlagtylgdcymuiesrcypydssnmhktimykjzftrerybwkpzseygtdaseoyas
+$ seedtool --deterministic TEST --count 300 --ur=50 --parts 10
+ur:crypto-seed/1-7/ltadatcfademcypyfzvarkhddpoeadhkaddwnteelblrcygldwvarflojtcywyjytpdkfwprylienshnjnpluypmamtkmybsjkspvseesawmrltdlplgvehkrlst
+ur:crypto-seed/2-7/ltaoatcfademcypyfzvarkhddpkplfbkqzztglfeoyaegsnedtrowsdpgtimmwzspfqdjkhshyfrylenpdnnnswmbeheclasztgmdstpoennbtflwykbvamsrnbk
+ur:crypto-seed/3-7/ltaxatcfademcypyfzvarkhddptpktgwcxdkhtskwkkgmdmdlubblstnoxpkpysotntbcmotbdwfetqzwsckmscadwssgarysfeomohdytfhlbmeottiptlggmle
+ur:crypto-seed/4-7/ltaaatcfademcypyfzvarkhddpiogmdnayhholprylstdieytohtweknvtwsdifhbwsptadlzsldrpnspscsutkkiyfzeyvtyajlvlsewnhkjltduohdvlqdrfts
+ur:crypto-seed/5-7/ltahatcfademcypyfzvarkhddpdwinbschfzkiaygmmudpcnkklahfoxdksgsgvlrstyvlbsvsaxbsmwenfezcurgtlpuecwfehgatkspriymotofgcechsrzeee
+ur:crypto-seed/6-7/ltamatcfademcypyfzvarkhddpmhguskgeflfyfspliorntefgdkykpswzwyrywtpfvwdeecahtdhhvalrnynbtiwnbdctuesabtmnecvapratdwlbvlplgwenie
+ur:crypto-seed/7-7/ltatatcfademcypyfzvarkhddptpgsglmdbnmknebkkscymofpkteyvoatjlqdaovesffhylgdimamcyadctgstymddlynpeaotpiecffdioaeaeaeaedntegunl
+ur:crypto-seed/8-7/ltayatcfademcypyfzvarkhddprfftsghlateseczcwkmuwtfhoxotaytbdkktbwbsehsbftwettgujpprurhhbsrflgsesklnhtldgtghtymdvoeszoqzkilgut
+ur:crypto-seed/9-7/ltasatcfademcypyfzvarkhddpcnntbwlfqdwkrfksjzwyioylsglpuyotbecwoxbtmdsslbgepehhkocejedwlrkttdesnbadzmhpsfdndwhgsglgfhzsdaursa
+ur:crypto-seed/10-7/ltbkatcfademcypyfzvarkhddptpktgwcxdkhtskwkkgmdmdlubblstnoxpkpysotntbcmotbdwfetqzwsckmscadwssgarysfeomohdytfhlbmeottijyjsbwto
+ur:crypto-seed/11-7/ltbdatcfademcypyfzvarkhddpkprhbdadtelkctheaxsrmkvluyhybzwypelkehmnpthtecahoesomkfgneflcpptqznncwecrhtinlbwswjptbgtpluynnrlsn
+ur:crypto-seed/12-7/ltbnatcfademcypyfzvarkhddpknkocmclaystwnluzomyuyoswzfhgmsgpfferyaowzghbyzcmsoxtylfpfgspfdrbdswprrsztknjzfrtyspfxdahlftdketee
+ur:crypto-seed/13-7/ltbtatcfademcypyfzvarkhddpwkckfzemiedisnolvsrorpwzmwtlkblahnhsdrihaoykpsvlwtemcxtahpjesahsfwmsolldiemdcxgrhkwehevwsfqdrswleo
+ur:crypto-seed/14-7/ltbaatcfademcypyfzvarkhddptpgsglmdbnmknebkkscymofpkteyvoatjlqdaovesffhylgdimamcyadctgstymddlynpeaotpiecffdioaeaeaeaeyndlbgut
+ur:crypto-seed/15-7/ltbsatcfademcypyfzvarkhddpiogmdnayhholprylstdieytohtweknvtwsdifhbwsptadlzsldrpnspscsutkkiyfzeyvtyajlvlsewnhkjltduohdbscyhkhp
+ur:crypto-seed/16-7/ltbeatcfademcypyfzvarkhddpmhissszojllpiogdieehtylkflfymwgydnonfrmnzoadhshygridfdimndkgcffdvtnbsfbnvaksjyhgwdksryuoeogsmkqdrn
+ur:crypto-seed/17-7/ltbyatcfademcypyfzvarkhddpdwinbschfzkiaygmmudpcnkklahfoxdksgsgvlrstyvlbsvsaxbsmwenfezcurgtlpuecwfehgatkspriymotofgcedkqzmwon
 
 #
 # Reconstruct the message from a subset of the generated parts.
 #
 
 $ seedtool --in ur
-ur:crypto-seed/2-7/ltaoatcfademcyimclztbehddpkplfbkqzztglfeoyaegsnedtrowsdpgtimmwzspfqdjkhshyfrylenpdnnnswmbeheclasztgmdstpoennbtflwykbcxclayrn
-ur:crypto-seed/4-7/ltaaatcfademcyimclztbehddpiogmdnayhholprylstdieytohtweknvtwsdifhbwsptadlzsldrpnspscsutkkiyfzeyvtyajlvlsewnhkjltduohddaahbkia
-ur:crypto-seed/5-7/ltahatcfademcyimclztbehddpdwinbschfzkiaygmmudpcnkklahfoxdksgsgvlrstyvlbsvsaxbsmwenfezcurgtlpuecwfehgatkspriymotofgcettkpgrla
-ur:crypto-seed/7-7/ltatatcfademcyimclztbehddptpgsglmdbnmknebkkscymofpkteyvoatjlqdaovesffhylgdimamcyadctgstymddlynpeaotpiecffdhkaeaeaeaewfjyvlsg
-ur:crypto-seed/8-7/ltayatcfademcyimclztbehddpmhguskgeflfyfspliorntefgdkykpswzwyrywtpfvwdeecahtdhhvalrnynbtiwnbdctuesabtmnecvapratdwlbvlzmgyzmpd
-ur:crypto-seed/10-7/ltbkatcfademcyimclztbehddpcactfnnskeotcflffrdiwyotsbiabeldnykngadlcxoximhllndwvartptgeaeyknbgrfzldlbjlwpkgwmtpaehttlehspkgzs
-ur:crypto-seed/14-7/ltbaatcfademcyimclztbehddpfsollauemkgdryztceiotavelonlhpcwdmlfsrtnlagtylgdcymuiesrcypydssnmhktimykjzftrerybwkpzseygtzsctdpbb
-ur:crypto-seed/16-7/ltbeatcfademcyimclztbehddpfltimtzomhmsgsjovlvsaofxknolasttnnstkbtpjpcfvapslgempffppkvdmtvdndpatpgemsfztalpstryrhchbefpwdeyvs
+ur:crypto-seed/2-7/ltaoatcfademcypyfzvarkhddpkplfbkqzztglfeoyaegsnedtrowsdpgtimmwzspfqdjkhshyfrylenpdnnnswmbeheclasztgmdstpoennbtflwykbvamsrnbk
+ur:crypto-seed/4-7/ltaaatcfademcypyfzvarkhddpiogmdnayhholprylstdieytohtweknvtwsdifhbwsptadlzsldrpnspscsutkkiyfzeyvtyajlvlsewnhkjltduohdvlqdrfts
+ur:crypto-seed/5-7/ltahatcfademcypyfzvarkhddpdwinbschfzkiaygmmudpcnkklahfoxdksgsgvlrstyvlbsvsaxbsmwenfezcurgtlpuecwfehgatkspriymotofgcechsrzeee
+ur:crypto-seed/7-7/ltatatcfademcypyfzvarkhddptpgsglmdbnmknebkkscymofpkteyvoatjlqdaovesffhylgdimamcyadctgstymddlynpeaotpiecffdioaeaeaeaedntegunl
+ur:crypto-seed/8-7/ltayatcfademcypyfzvarkhddprfftsghlateseczcwkmuwtfhoxotaytbdkktbwbsehsbftwettgujpprurhhbsrflgsesklnhtldgtghtymdvoeszoqzkilgut
+ur:crypto-seed/9-7/ltasatcfademcypyfzvarkhddpcnntbwlfqdwkrfksjzwyioylsglpuyotbecwoxbtmdsslbgepehhkocejedwlrkttdesnbadzmhpsfdndwhgsglgfhzsdaursa
+ur:crypto-seed/10-7/ltbkatcfademcypyfzvarkhddptpktgwcxdkhtskwkkgmdmdlubblstnoxpkpysotntbcmotbdwfetqzwsckmscadwssgarysfeomohdytfhlbmeottijyjsbwto
+ur:crypto-seed/14-7/ltbaatcfademcypyfzvarkhddptpgsglmdbnmknebkkscymofpkteyvoatjlqdaovesffhylgdimamcyadctgstymddlynpeaotpiecffdioaeaeaeaeyndlbgut
+ur:crypto-seed/16-7/ltbeatcfademcypyfzvarkhddpmhissszojllpiogdieehtylkflfymwgydnonfrmnzoadhshygridfdimndkgcffdvtnbsfbnvaksjyhgwdksryuoeogsmkqdrn
+ur:crypto-seed/17-7/ltbyatcfademcypyfzvarkhddpdwinbschfzkiaygmmudpcnkklahfoxdksgsgvlrstyvlbsvsaxbsmwenfezcurgtlpuecwfehgatkspriymotofgcedkqzmwon
 ^D
 9d347f841a4e2ce6bc886e1aee74d82442b2f7649c606daedbad06cf8f0f73c8e834c2ebb7d2868d75820ab4fb4e45a1004c9f29b8ef2d4d6a94fab0b373615e3bf736a89e9ceb105f2109fb5226d8a29e0d47ee7ed8774f20245ac5f47b95958b1483daa4aaabc9dad616a30bf338b4ef1e971d2cc449bdcc339258f93f7f91a3d067522b085ca6b2f7c72732ce5aed7ae0ef273f13c8d92ffa89b69cac18dd79664032e0f86fe3c1f1596fd2dc582c690f17407d0852932d23798056a424cacae3bfd4e30fe8030f943645fcdf4d86de1b45570778b26692ce461c9053c54a47443dae67bed34624f5acf2eebdf0b0e5283505d25ce6849aa0d0f10b1fdec20d8e35e6b2072c7fe3d84c4e950c989f0a781a92417732e2076fb302e4cc3ff7506a061a011f4cd4952ff6af
 ```
@@ -909,7 +909,7 @@ $ seedtool --in ur
 ur:crypto-sskr/taadecgolywpaeadaelfesaxylbetokntnbsgessutmtecdtyttshnfncp
 ur:crypto-sskr/taadecgolywpaeadaoskfmnlmhbtemmovyzohffniaeehlcendglsfmkem
 ^D
-e3b0c44298fc1c149afbf4c8996fb924
+b8d12ba46f50afd6b2c7a879bf5feebd
 ```
 
 ## Version History

README.md

@@ -137,6 +137,10 @@ These dependencies are automatically installed as submodules when you run the bu
 
 ### MacOS
 
+```bash
+$ brew install autoconf automake libtool shunit2
+```
+
 ```bash
 $ ./build.sh
 $ sudo make install
@@ -220,6 +224,7 @@ This table below also establishes provenance (repository of origin, permalink, a
 To build `seedtool` you'll need to use the following tools:
 
 - autotools - Gnu Build System from Free Software Foundation ([intro](https://www.gnu.org/software/automake/manual/html_node/Autotools-Introduction.html)).
+- shunit2 - Unit testing for shell scripts
 
 ## Financial Support
 

build.sh

@@ -8,47 +8,65 @@ source set_build_paths.sh
 # Terminal colors
 RED=`tput setaf 1`
 GREEN=`tput setaf 2`
+BLUE=`tput setaf 4`
 RESET=`tput sgr0`
 
+echo "${BLUE}== bc-crypto-base ==${RESET}"
+
 pushd deps/bc-crypto-base
 ./configure --prefix ${SYSROOT}
 make check
 make install
 popd
 
+echo "${BLUE}== bc-shamir ==${RESET}"
+
 pushd deps/bc-shamir
 ./configure --prefix ${SYSROOT}
 make check
 make install
 popd
 
+echo "${BLUE}== bc-sskr ==${RESET}"
+
 pushd deps/bc-sskr
 ./configure --prefix ${SYSROOT}
 make check
 make install
 popd
 
+echo "${BLUE}== bc-bip39 ==${RESET}"
+
 pushd deps/bc-bip39
 ./configure --prefix ${SYSROOT}
 make check
 make install
 popd
 
+echo "${BLUE}== bc-ur ==${RESET}"
+
 pushd deps/bc-ur
 ./configure --prefix ${SYSROOT}
 make check
 make install
 popd
 
+echo "${BLUE}== argp-standalone ==${RESET}"
+
 pushd deps/argp-standalone/argp-standalone
+set +e
 patch -N <../patch-argp-fmtstream.h
+set -e
 ./configure --prefix ${SYSROOT}
 make install
 cp libargp.a ${SYSROOT}/lib/
 cp argp.h ${SYSROOT}/include/
 popd
 
+echo "${BLUE}== seedtool ==${RESET}"
+
 ./configure
+make clean
 make check
 echo "${GREEN}*** Seedtool built.${RESET}"
 echo "${GREEN}Next step: sudo make install${RESET}"

configure

@@ -3717,6 +3717,56 @@ else
 
 fi
 
+{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for crc32n in -lbc-ur" >&5
+$as_echo_n "checking for crc32n in -lbc-ur... " >&6; }
+if ${ac_cv_lib_bc_ur_crc32n+:} false; then :
+  $as_echo_n "(cached) " >&6
+else
+  ac_check_lib_save_LIBS=$LIBS
+LIBS="-lbc-ur  $LIBS"
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+/* Override any GCC internal prototype to avoid an error.
+   Use char because int might match the return type of a GCC
+   builtin and then its argument prototype would still apply.  */
+#ifdef __cplusplus
+extern "C"
+#endif
+char crc32n ();
+int
+main ()
+{
+return crc32n ();
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_link "$LINENO"; then :
+  ac_cv_lib_bc_ur_crc32n=yes
+else
+  ac_cv_lib_bc_ur_crc32n=no
+fi
+rm -f core conftest.err conftest.$ac_objext \
+    conftest$ac_exeext conftest.$ac_ext
+LIBS=$ac_check_lib_save_LIBS
+fi
+{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_bc_ur_crc32n" >&5
+$as_echo "$ac_cv_lib_bc_ur_crc32n" >&6; }
+if test "x$ac_cv_lib_bc_ur_crc32n" = xyes; then :
+  cat >>confdefs.h <<_ACEOF
+#define HAVE_LIBBC_UR 1
+_ACEOF
+
+  LIBS="-lbc-ur $LIBS"
+
+else
+
+  echo "### Error! libbc-ur must be installed first."
+  exit -1
+
+fi
+
 { $as_echo "$as_me:${as_lineno-$LINENO}: checking for argp_parse in -largp" >&5
 $as_echo_n "checking for argp_parse in -largp... " >&6; }
 if ${ac_cv_lib_argp_argp_parse+:} false; then :

configure.ac

@@ -29,6 +29,10 @@ AC_CHECK_LIB([bc-bip39], [bip39_mnemonic_from_word], [], [
   echo "### Error! libbc-bip39 must be installed first."
   exit -1
   ])
+AC_CHECK_LIB([bc-ur], [crc32n], [], [
+  echo "### Error! libbc-ur must be installed first."
+  exit -1
+  ])
 AC_CHECK_LIB([argp], [argp_parse], [], [
   echo "### Error! argp must be installed first. Try 'brew install argp-standalone'."
   exit -1

src/Makefile.in

@@ -109,7 +109,7 @@ uninstall:
 
 .PHONY: check
 check: $(toolname)
-	./$(toolname)
+	./test.sh ./$(toolname)
 
 .PHONY: clean
 clean:

src/config.h.in

@@ -21,6 +21,9 @@
 /* Define to 1 if you have the `bc-sskr' library (-lbc-sskr). */
 #undef HAVE_LIBBC_SSKR
 
+/* Define to 1 if you have the `bc-ur' library (-lbc-ur). */
+#undef HAVE_LIBBC_UR
+
 /* Define to 1 if your system has a GNU libc compatible `malloc' function, and
    to 0 otherwise. */
 #undef HAVE_MALLOC