Extensions

- Created scripts/extensions/README to describe samples.
- Created sample extension scripts of each type.

scripts/extensions/command.lua

@@ -0,0 +1,45 @@
+-- Command Extension.
+-- Implementing 'random'.
+
+-- Arguments: None
+-- Returns:   An 8-element list of installation details.  Only called once, on
+--            installation of the extension.
+function install ()
+  return 'command',                        -- Type
+         'random',                         -- Name
+         1.0,                              -- Version
+         'Displays a random pending task', -- Description
+         'Paul Beckingham',                -- Author
+         'paul@beckingham.net',            -- Contact
+         'GPLv2',                          -- License
+         '© 2011, Göteborg Bit Factory'    -- Copyright
+end
+
+-- Arguments: None
+-- Returns:   Valid Taskwarrior BNF, minimally defining a production rule that
+--            has the same name as the command itself
+function syntax ()
+  return 'random ::= "random" ;'
+end
+
+-- Arguments: None
+-- Returns:   1 --> command does not modify data
+--            0 --> command modifies data
+function read_only ()
+  return 1
+end
+
+-- Arguments: None
+-- Returns:   1 --> command displays task ID
+--            0 --> no ID dispalyed
+function display_id ()
+  return 1
+end
+
+-- Arguments: None
+-- Returns:   1, 'error' --> command failed
+--            0, nil     --> success
+function execute ()
+  return 1, 'Not implemented'
+end
+