;;;
;;; Usage
;;;

$ distrac -h
Usage: distrac [-h|-help|--help] <command> [<options>]

<command>s:

create <options>
  Create a new ticket.

  <options>:
    --summary|-s <summary>
      Ticket summary.

    --description|-d <description>
      Ticket description.  This parameter and --description-from-file are
      mutually exclusive.

    --description-from-file|-f <file>
      Use ticket description from file <file>.

    --component|-c

    --severity|-S

    --priority|-p

    --owner|-O

    --version|-v

    --milestone|-m

    --status|-s

    --resolution|-r

    --keyword|-k


init
  TODO


list [<what>]
 If <what> is not provided, list tickets, otherwise list the values of <what>.

  <what>:
    * components
    * milestones
    * owners
    * priorities
    * reporters
    * resolutions
    * severities
    * statuses
    * tickets
    * versions


pull
  TODO


query <expr>
  Query the database using <expr>.

  Example:
    distrac query '(and date (> date "2022-11") (< date "2023-05") (member "bar" tags))'


set <ticket-id>
  TODO

view <ticket-id>
  TODO


;;;
;;; Database
;;;

`distrac init` will clone the git repository of tickets under
~/.cache/distrac/db.  The layout is below, created out of a conversion
of the trac database to the format handled by distrac:

$ ls -l ~/.cache/distrac/db/
total 260
-rw-r--r-- 1 mario mario  93741 Jul 22  2023 aliases.scm
-rw-r--r-- 1 mario mario    172 Jul 22  2023 components.scm
-rw-r--r-- 1 mario mario    114 Jul 22  2023 milestones.scm
-rw-r--r-- 1 mario mario    700 Jul 22  2023 owners.scm
-rw-r--r-- 1 mario mario     49 Jul 22  2023 priorities.scm
-rw-r--r-- 1 mario mario   1319 Jul 22  2023 reporters.scm
-rw-r--r-- 1 mario mario     55 Jul 22  2023 resolutions.scm
-rw-r--r-- 1 mario mario      3 Jul 22  2023 severities.scm
-rw-r--r-- 1 mario mario     50 Jul 22  2023 statuses.scm
drwxr-xr-x 2 mario mario 131072 Jul 24  2023 tickets
-rw-r--r-- 1 mario mario    320 Jul 22  2023 versions.scm

$ head ~/.cache/distrac/db/owners.scm 
("0xab"
 "Alex S."
 "DeeEff"
 "Felix"
 "Ivan Raikov"
 "Jim Ursetto"
 "Moritz Heidkamp"
 "Peter Bex"
 "acharlton"
 "alaric"

$ head ~/.cache/distrac/db/versions.scm 
("3.5.x"
 "4.0.0"
 "4.0.1"
 "4.0.5"
 "4.0.8"
 "4.0.x"
 "4.1.0rc1"
 "4.1.x"
 "4.10.x"
 "4.11.0"

$ ls -l ~/.cache/distrac/db/tickets/ | head
total 8680
-rw-r--r-- 1 mario mario    612 Jul 22  2023 0022cbbe5aa075a0d3824aed9ce3735170f01579.scm
-rw-r--r-- 1 mario mario   1316 Jul 22  2023 0025911b65cf2d5ccc28448fe1bdbc79a55c6c02.scm
-rw-r--r-- 1 mario mario   2470 Jul 22  2023 0033405cbf8bd40717dcb42e338636856d631527.scm
-rw-r--r-- 1 mario mario    929 Jul 22  2023 008e7e7ade49b504e0c48f63575fe53944f26fd3.scm
-rw-r--r-- 1 mario mario    814 Jul 22  2023 009832adbd7858319f861039f4e69bdae0b7a5b0.scm
-rw-r--r-- 1 mario mario   1586 Jul 22  2023 00a5b5c8ca8bb9f51e7bad8cf80c4639470f0f18.scm
-rw-r--r-- 1 mario mario   2657 Jul 22  2023 00d05060c17d1662dbf0f7ac6b432e0ac60fa74a.scm
-rw-r--r-- 1 mario mario    905 Jul 22  2023 00ed1fe12cc89ec18e6c97a058904b4e55fbe1f0.scm
-rw-r--r-- 1 mario mario   2509 Jul 22  2023 00f354cf17b9d4481fcb3f7d1653c6bcd5f9661e.scm

$ cat ~/.cache/distrac/db/tickets/0022cbbe5aa075a0d3824aed9ce3735170f01579.scm
((id . 42)
 (type . "task")
 (time . 1245073075000000)
 (changetime . 1292675519000000)
 (component . "core libraries")
 (severity)
 (priority . "minor")
 (owner . "")
 (reporter . "felix")
 (cc . "")
 (version . "4.0.5")
 (milestone . "")
 (status . "closed")
 (resolution . "wontfix")
 (summary . "implement memory-mapped file operations for Windows")
 (description . "Add support for mmapped files in `posixwin.scm`.\r\n")
 (keywords . "")
 (changes
   (1292675519000000 "felix" "status" "new" "closed")
   (1292675519000000 "felix" "resolution" "" "wontfix")
   (1292675519000000 "felix" "comment" "1" "")))


;;;
;;; Usage examples
;;;

$ distrac list components
build system
compiler
core libraries
core tools
core-pending
documentation
expander
extensions
infrastructure
scrutinizer
unknown
wiki

$ distrac list | head
973 seconds->date TIMEZONE-INFO argument defaults to #t (andyjpb)
592 doctype egg is missing sxml conversion rule for generic HTML doctype (syn)
327 chicken-install is PARTIALLY DOWN (zbigniew)
387 import without warnings (ashinn)
559 add fmt documentation to wiki (felix)
729 sendfile test errors (mario)
1815 (chicken irregex): Use condition kinds (Zipheir)
1494 Indirect exports with (export (foo bar)) style are not working (megane)
290 disable reimport notice when executing import library (felix)
1274 read-all receiving #<unspecified> unless preceded by a predicate (sjamaan)

$ distrac view 559
Summary: add fmt documentation to wiki
Type: defect
Reporter: felix
Owner: ashinn
Cc: 
Status: closed
Resolution: fixed
Severity: 
Priority: minor
Milestone: 

########## Description ##########

There currently only exists a link. It would be nice to access the considerable API via chicken-doc.


########## Changes ##########

* Change by mario on Thu Jun 16 02:10:38 2011: status, new -> closed
* Change by mario on Thu Jun 16 02:10:38 2011: resolution,  -> fixed
* Change by mario on Thu Jun 16 02:10:38 2011: comment, 1 -> 
It's done.  I've omitted the "Installation" and "JavaScript Formatting" (js doesn't seem to be supported by the chicken egg).


$ distrac query '(and (= type "defect") (= reporter "mario"))' | head
729 sendfile test errors (mario)
1116 parametric-curve's tests need numbers (mario)
785 qwiki: use of deprecated library procedure `shuffle' (mario)
72 load bug? (mario)
147 Error when loading the qt egg (mario)
1434 srfi-27 (version 3.3.0): installation failure (mario)
1397 s11n4j depends on `numbers', but doesn't specify it as a dependency (mario)
939 simple-directory-handler: error 500 on listing a directory with a link foo -> foo (mario)
1559 byte-blob: test failure (missing import?) (mario)
1400 srfi-64 uses "numbers" but doesn't declare it as a dependency (mario)