Interface tool

[taolson]

I recently added interface.am to the /tools directory. It uses the compiler's parser and module system to read in any Admiran source files specified on the command line and produce a grouped, sorted list of all the top-level definition type specifications. It can be used to produce documentation (see doc/Library.md), or along with grep to discover functions by name or by type spec. For example, For example, running the command interface lib/*.am | grep "max" returns:

astar.maxCost :: int
base.maxBy :: ordI ** -> (* -> **) -> [*] -> *
stdlib.max :: ordI * -> [*] -> *
stdlib.max2 :: ordI * -> * -> * -> *
v2.v2_max :: ordI * -> v2 * -> v2 * -> v2 *
v3.v3_max :: ordI * -> v3 * -> v3 * -> v3 *
vector.v_max :: ordI * -> vector * -> *

Or to find a functions which match a type spec pattern: interface lib/*.am | fgrep '[*] -> [[*]]':

base.chunk :: int -> [*] -> [[*]]
base.combinations :: int -> [*] -> [[*]]
base.combinationsWithRep :: int -> [*] -> [[*]]
base.group :: ordI * -> [*] -> [[*]]
base.groupBy :: (* -> * -> bool) -> [*] -> [[*]]
base.inits :: [*] -> [[*]]
base.intercalate :: [*] -> [[*]] -> [*]
base.permutations :: [*] -> [[*]]
base.permutationsWithRep :: [*] -> [[*]]
base.splitOneOf :: ordI * -> [*] -> [*] -> [[*]]
base.splitWhen :: (* -> bool) -> [*] -> [[*]]
base.tails :: [*] -> [[*]]