trellor 2.0.3 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 85d97d017e9e202db49b8a9a4ec8ff05472fc3e0
-  data.tar.gz: 7de26825b22aa66f3086d983802cf4186301048d
+  metadata.gz: eb73b614f294042859a8e4e29f7cd048e51cde34
+  data.tar.gz: 09f5a4d543b4879a05c83b22f9ce080cce4b98b1
 SHA512:
-  metadata.gz: 737f9fc421e8d2af416001014b368d2288a6583f644177c2fbf7e71fa5b4d2e3fb326f39e294f98e2fbf1a8e8c0765f511ccd3860c8da8f3daf7c9dfeb724330
-  data.tar.gz: 1ffb79c6a4f311dd524ebb1b8b30842d67927eb7fe59be2be436762704a437073a30fe201039e03c19b9da97cd3e14d7edfa13ee4b1ed484fc940228dd8ca6d8
+  metadata.gz: 56b997c347869890817f41e4b6f692d17ca787c32cb410a84bd0c1524fbcdac5153323b34037af76cd1caacc11f334d6210234b98e5435d426b8f1a247c70bc7
+  data.tar.gz: 7d99b990aff8f0cecc011c728fb4f845211c1b4e21f0436b24cb0e708ccd139c4fce95dddfa3a39a32fc225094f574fcf6e4dd5d35ce2bd6be348bd99972b74c

data/README.md

@@ -28,6 +28,7 @@ Three environment variables need to be set: TRELLOR_KEY, TRELLOR_TOKEN,
     $ trellor to     # prints all list names inside the first board with name
                      # beginning with 'to' (case insensitive)
                      # for example, this matches 'ToDo'
+    $ trellor 'to.*o'  # regular expression search, would also print todo board.
     $ trellor to in  # prints all card names in the list named 'in*' in board
                      # named 'to*', e.g., matches 'ToDo.Inbox'
     # create a card:
@@ -42,6 +43,9 @@ Starting with version 2, a webapp is run in the background. Making the connectio
 Trello resulted in over half the time to run a command. The local webapp pays
 this cost only once.
 
+Version 3 will be faster by using Trello's recently released webhooks. Plans
+also include allowing offline usage.
+
 
 ## Development
 
@@ -49,9 +53,17 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## Design
+
+### Class Diagram
+![Alt text](/docs/trellor.png?raw=true "Class Diagram")
+
+### Sequence Diagram
+![Alt text](/docs/trellor_seq_diag.png?raw=true "Sequence Diagram")
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/trellor.
+Bug reports and pull requests are welcome on GitHub at https://github.com/brianmd/trellor.
 
 
 ## License

data/docs/trellor.txt

@@ -0,0 +1,92 @@
+@startuml
+
+class Cli {
+  archive
+  verbose?
+  cache
+  webapi
+  slowtrellor
+  ==
+  parse()
+  -- queries --
+  query_trellor()
+  -- private --
+  save_all()
+  get_all()
+  home()
+  filepath()
+  verbose_log()
+}
+
+class TrellorInterface {
+  verbose_log(*args)
+  -- queries --
+  board_names()
+  list_names(board_regex)
+  cart_names(board_regex,list_regex)
+  create_card(board,list,card,descript)
+  archive_card(board,list,card)
+}
+
+Cli *- TrellorInterface : trellor >
+
+class Trellor {
+  self.singleton()
+  -- queries --
+  board_names()
+  list_names(board_regex)
+  cart_names(board_regex,list_regex)
+  create_card(board,list,card,descript)
+  archive_card(board,list,card)
+  -- private queries --
+  boards()
+  boards=(boards)
+  find_board(board_regex)
+  find_list(board_regex,list_regex)
+  cards(board_regex,list_regex)
+  find_card(board,list,card)
+  -- connecting --
+  client()
+  connect()
+  user()
+}
+
+class WebTrellor {
+  ensure_webapp_is_running()
+  run_webapp()
+  -- queries --
+  board_names()
+  list_names(board_regex)
+  cart_names(board_regex,list_regex)
+  create_card(board,list,card,descript)
+  archive_card(board,list,card)
+  -- private --
+  get_http(url,data,timeout,show_error?)
+  post_http(url,data,timeout,show_error?)
+  default_open_timeout()
+  default_read_timeout()
+  site()
+  port()
+}
+
+TrellorInterface <|-- Trellor
+TrellorInterface <|-- WebTrellor
+
+
+class Sinatra::Base
+
+class TrellorWebapi {
+  -- GETs --
+  /version
+  /boards
+  -- POSTs --
+  /boards
+  -- error handling --
+  not_found()
+  error()
+}
+
+Sinatra::Base <|-- TrellorWebapi
+
+@enduml
+

data/docs/trellor_seq_diag.txt

@@ -0,0 +1,20 @@
+@startuml
+
+actor User
+
+User -> Cli : board_regex
+Cli -> WebTrellor : board_names\n  (board_regex)
+WebTrellor -> TrellorWebapi : get_http(/boards)\n  {board_name:\n       board_regex}
+|||
+TrellorWebapi -> Trellor : board_names\n  (board_regex)
+|||
+
+== OR, with -s(low) flag, goes directly to trellor class ==
+
+User -> Cli : board_regex
+Cli -> Trellor : board_names\n  (board_regex)
+|||
+note over TrellorWebapi: Runs sinatra \non localhost
+
+@enduml
+

data/lib/cli.rb

@@ -14,11 +14,13 @@ module Trellor
         opt :slowtrellor, 'Make own connection rather than using webapi', short: '-s'
       end
 
+      logger  # sets the logger's progname
+
       if webapi?
         require_relative 'web_trellor'
         web = WebTrellor.new
-        web.be_verbose = true if @opts[:verbose]
-        web.ensure_webapp_is_running
+        # web.be_verbose = true if verbose?
+        web.ensure_webapp_is_running(false)
         exit 0
       end
 
@@ -27,7 +29,7 @@ module Trellor
         p hash
       end
 
-      process(*ARGV)
+      query_trellor(*ARGV)
     end
 
     private
@@ -42,14 +44,18 @@ module Trellor
           verbose_log('using webapi')
           require_relative 'web_trellor'
           web = WebTrellor.new
-          web.be_verbose = true if @opts[:verbose]
+          web.be_verbose = true if verbose?
           web.ensure_webapp_is_running
           web
         end
-        @trellor.be_verbose = true if @opts[:verbose]
+        @trellor.be_verbose = true if verbose?
       end
       @trellor
     end
+
+    def self.verbose?
+      @opts[:verbose]
+    end
     
     def self.homepath
       Pathname.new(ENV['HOME'])
@@ -84,7 +90,7 @@ module Trellor
       hash
     end
 
-    def self.process(board_name=nil, list_name=nil, card_name=nil, descript=nil)
+    def self.query_trellor(board_name=nil, list_name=nil, card_name=nil, descript=nil)
       verbose_log "board_name", board_name
       verbose_log "list_name", list_name
       verbose_log "card_name", card_name
@@ -107,7 +113,20 @@ module Trellor
     end
 
     def self.verbose_log(*args)
-      $stderr.puts("           ****** #{args.inspect}") if @opts[:verbose]
+      logger.debug("           ****** #{args.inspect}")
+    end
+
+    def self.logger
+      unless @logger
+        @logger = Trellor.logger
+        @logger.progname = '[cli]'
+        if verbose?
+          @logger.level = Logger::DEBUG
+        else
+          @logger.level = Logger::WARN
+        end
+      end
+      @logger
     end
 
     def self.webapi?

data/lib/models.rb

@@ -0,0 +1,25 @@
+require 'virtus'
+
+module Trellor
+
+  class Base
+    include Virtus.model
+
+    attribute :id, String
+    attribute :name, String
+    # children is an ordered colleciton
+    attribute :children, Array[Base]
+  end
+
+  class Board < Base
+  end
+
+  class List < Base
+  end
+
+  class Card < Base
+    attribute :description, String
+  end
+
+end
+

data/lib/trellor.rb

@@ -1,5 +1,7 @@
 # TODO: show card descriptions
 
+require 'logger'
+
 require_relative "trellor/version"
 require 'trello'
 
@@ -15,40 +17,44 @@ module Trellor
       @singleton
     end
 
-    def client(key=ENV['TRELLOR_KEY'], token=ENV['TRELLOR_TOKEN'])
-      @client ||= connect(key, token)
+    def self.logger
+      unless @logger
+        file = File.new(logger_filename.to_s, 'a')
+        # webapi wasn't logging to the file until it was killed.
+        # this causes the logger to flush immediately
+        file.sync = true
+        @logger = Logger.new file
+      end
+      @logger
     end
 
-    def connect(key=ENV['TRELLOR_KEY'], token=ENV['TRELLOR_TOKEN'])
-      verbose_log("connecting with", key, token)
-      Trello::Client.new(
-        :developer_public_key => key,
-        :member_token => token
-      )
+    def self.logger_filename
+      dirpath = Pathname.new(ENV['HOME']) + '.config/trellor'
+      dirpath.mkdir unless dirpath.directory?
+      filename = 'log'
+      dirpath + filename
     end
 
-    def verbose_log(*args)
-      $stderr.puts("           ****** #{args.inspect}") if be_verbose
+    def logger
+      self.class.logger
     end
 
-    def user()
-      verbose_log('username', ENV['TRELLOR_USERNAME'])
-      @user ||= client.find(:members, ENV['TRELLOR_USERNAME'])
-    end
+
+    ##############  trellor interface queries  ###############
 
     def board_names
       boards.collect{ |board| board.name }.sort_by{|name| name.downcase}
     end
     def list_names(board_name)
-      board(board_name).lists.collect{ |list| list.name }.sort_by{|name| name.downcase}
+      find_board(board_name).lists.collect{ |list| list.name }.sort_by{|name| name.downcase}
     end
     def card_names(board_name, list_name)
-      list(board_name, list_name).cards.collect{ |card| card.name }
+      find_list(board_name, list_name).cards.collect{ |card| card.name }
     end
     def create_card(board_name, list_name, name, descript=nil)
       card = Trello::Card.new
       card.client = client
-      card.list_id = list(board_name, list_name).id
+      card.list_id = find_list(board_name, list_name).id
       card.name = name
       card.desc = descript if descript
       card.save
@@ -59,8 +65,7 @@ module Trellor
     end
 
 
-
-
+    ################  private queries  #################
 
     def boards
       verbose_log('getting boards') unless @boards
@@ -70,31 +75,59 @@ module Trellor
       @boards = boards
     end
 
-    def board(name)
+    def find_board(name)
       boards   # to get verbose log ordering correct
       verbose_log('getting board', name)
       name = Regexp.new(name, Regexp::IGNORECASE)
-      boards.detect{ |board| name.match(board.name) }
+      boards.find{ |board| name.match(board.name) }
     end
 
-    def list(board_name, list_name)
-      this_board = board(board_name)
+    def find_list(board_name, list_name)
+      this_board = find_board(board_name)
       verbose_log('   getting list', board_name, list_name)
       name = Regexp.new(list_name, Regexp::IGNORECASE)
-      this_board.lists.detect{ |list| name.match(list.name) }
+      this_board.lists.find{ |list| name.match(list.name) }
     end
 
     def cards(board_name, list_name)
       verbose_log('       getting cards for', board_name, list_name)
-      list(board_name, list_name).cards
+      find_list(board_name, list_name).cards
     end
 
     def find_card(board_name, list_name, card_name)
-      card_name = card_name.downcase
-      list(board_name, list_name).cards.detect do |card|
-        card.name.downcase.start_with?(card_name)
-      end
+      this_list = find_list(board_name, list_name)
+      verbose_log('   getting card', board_name, list_name, card_name)
+      name = Regexp.new(card_name, Regexp::IGNORECASE)
+      this_list.cards.find{ |card| name.match(card.name) }
+    end
+
+    private
+
+
+    ############  connecting  ###############
+
+    def client(key=ENV['TRELLOR_KEY'], token=ENV['TRELLOR_TOKEN'])
+      @client ||= connect(key, token)
+    end
+
+    def connect(key=ENV['TRELLOR_KEY'], token=ENV['TRELLOR_TOKEN'])
+      verbose_log("connecting with", key, token)
+      Trello::Client.new(
+        :developer_public_key => key,
+        :member_token => token
+      )
+    end
+
+    def verbose_log(*args)
+      logger.error("           ****** #{args.inspect}") if be_verbose
     end
+
+    def user()
+      verbose_log('username', ENV['TRELLOR_USERNAME'])
+      @user ||= client.find(:members, ENV['TRELLOR_USERNAME'])
+    end
+
+
   end
 end
 

data/lib/trellor/version.rb

@@ -1,3 +1,3 @@
 module Trellor
-  VERSION = "2.0.3"
+  VERSION = "2.0.4"
 end

data/lib/web_trellor.rb

@@ -6,24 +6,31 @@ require 'pathname'
 require 'addressable/uri'
 require_relative "trellor/version"
 
+# this is loaded just for logger.
+# TODO: move logger to separate file.
+require_relative 'trellor'
+
 module Trellor
   class WebTrellor
-    attr_accessor :be_verbose
-
-    def ensure_webapp_is_running
+    def ensure_webapp_is_running(fork=true)
       v = get_version
-      $stderr.puts "Warning: this version is #{VERSION} but the webapp version is #{v}. You may want to kill the older webapp." unless VERSION == v
+      $stderr.puts "Warning: this version is #{VERSION} but the webapp version is #{v}. You may want to kill the older webapp." unless (!v or (v==VERSION))
       fail unless v
     rescue
       puts "The background webapp wasn't running. Will run it now."
       verbose_log "The background webapp wasn't running. Will run it now."
-      run_webapp
+      run_webapp(fork)
     end
 
-    def run_webapp
+    def run_webapp(fork)
       path = Pathname.new(__FILE__).parent.parent
       cmd = "cd '#{path}' && ruby lib/webapi.rb &> /dev/null"
       verbose_log cmd
+      unless fork
+        $stderr.puts 'running ...'
+        exec cmd
+        exit 0
+      end
       job = fork do
         exec cmd
       end
@@ -44,8 +51,41 @@ module Trellor
       nil
     end
 
+
+    ##############  trellor interface queries  ###############
+
+    def board_names
+      verbose_log('getting boards') unless @boards
+      @boards = JSON.parse(get_http('/boards').body)
+    end
+
+    def list_names(board_name)
+      JSON.parse(get_http("/boards", {board_name: board_name}).body)
+    end
+
+    def card_names(board_name, list_name)
+      body = get_http("/boards", {board_name: board_name, list_name: list_name}).body
+      JSON.parse(body)
+    end
+
+    def create_card(board_name, list_name, name, descript=nil)
+      data = {board_name: board_name, list_name: list_name, card_name: name, descript: descript}
+      JSON.parse(post_http('/boards', data).body)
+    end
+
+    def archive_card(board_name, list_name, name)
+      data = {archive: true, board_name: board_name, list_name: list_name, card_name: name}
+      JSON.parse(post_http('/boards', data).body)
+    end
+
+    private
+
+
+    #################  private  ################
+
     def get_http(url, data=nil, timeout=nil, show_error=true)
       uri = Addressable::URI.parse("#{site}#{url}")
+      verbose_log('get_http', uri, data)
       http = Net::HTTP.new uri.host, uri.port
       http.open_timeout = default_open_timeout
       http.read_timeout = timeout || default_read_timeout
@@ -60,12 +100,9 @@ module Trellor
       raise e
     end
 
-    def default_open_timeout
-      60
-    end
-
-    def post_http(url, data, timeout=nil)
+    def post_http(url, data, timeout=nil, show_error=true)
       uri = URI("#{site}#{url}")
+      verbose_log('post_http', uri, data)
       http = Net::HTTP.new uri.host, uri.port
       http.open_timeout = default_open_timeout
       http.read_timeout = timeout || default_read_timeout
@@ -77,7 +114,7 @@ module Trellor
       verbose_log response.code, response.body
       response
     rescue Exception => e
-      $stderr.puts "ERROR in post_http(#{url})"
+      $stderr.puts "ERROR in post_http(#{url})" if show_error
       raise e
     end
 
@@ -97,64 +134,7 @@ module Trellor
     end
 
     def verbose_log(*args)
-      $stderr.puts("           ****** #{args.inspect}") if be_verbose
-    end
-
-    def user()
-      verbose_log('username', ENV['TRELLOR_USERNAME'])
-      @user ||= client.find(:members, ENV['TRELLOR_USERNAME'])
-    end
-
-    def board_names
-      verbose_log('getting boards') unless @boards
-      @boards = JSON.parse(get_http('/boards').body)
-      #@boards ||= user.boards.select{ |b| !b.closed? }
-    end
-
-    def list_names(board_name)
-      JSON.parse(get_http("/boards", {board_name: board_name}).body)
-    end
-
-    def card_names(board_name, list_name)
-      JSON.parse(get_http("/boards", {board_name: board_name, list_name: list_name}).body)
-    end
-
-    def create_card(board_name, list_name, name, descript=nil)
-      JSON.parse(post_http("/boards/#{board_name}/lists/#{list_name}/cards", {card_name: name, descript: descript}).body)
-    end
-
-    def archive_card(board_name, list_name, name)
-      JSON.parse(post_http("/boards/#{board_name}/lists/#{list_name}/cards", {card_name: name, archive: true}).body)
-    end
-
-
-
-
-    def board(name)
-      boards   # to get verbose log ordering correct
-      verbose_log('getting board', name)
-      name = name.downcase
-      boards.detect{ |board| board.name.downcase.start_with?(name) }
-    end
-
-    def list(board_name, list_name)
-      this_board = board(board_name)
-      verbose_log('   getting list', board_name, list_name)
-      list_name = list_name.downcase
-      this_board.lists.detect do |list|
-        list.name.downcase.start_with?(list_name)
-      end
-    end
-
-    def cards(board_name, list_name)
-      verbose_log('       getting cards for', board_name, list_name)
-      list(board_name, list_name).cards
-    end
-
-    def card(board_name, list_name, card_name)
-      list(board_name, list_name).cards.detect do |card|
-        card.name==card_name
-      end
+      Trellor.logger.debug("           ****** #{args.inspect}")
     end
   end
 end

data/lib/webapi.rb

@@ -1,9 +1,8 @@
 require 'sinatra'
-require 'json'
+require 'yajl/json_gem'
 require_relative 'trellor/version'
 require_relative 'trellor'
 
-
 module Trellor
   class TrellorWebapi < Sinatra::Base
     # enable error handler even in development mode
@@ -28,9 +27,22 @@ not_found do
 end
 
 error do
-  'had an error'
+  # log = Logger.new(File.new('log','a'))
+  msg = 'Sorry there was a error: ' + env['sinatra.error'].message
+  logger.error msg
+  env['sinatra.error'].backtrace.each{|l| logger.error l}
+  msg
 end
 
+helpers do
+ def logger
+   unless @logger
+     @logger = Trellor::Trellor.logger
+     @logger.progname = '[webapi]'
+   end
+   @logger
+ end
+end
 
 def trellor
   Trellor::Trellor.singleton
@@ -42,7 +54,9 @@ end
 
 get '/boards' do
   if params[:list_name]
-    cards = trellor.list(params[:board_name],params[:list_name]).cards.collect{ |card| card.name }
+    logger.info params.inspect
+    # cards = trellor.list_names(params[:board_name],params[:list_name]).cards.collect{ |card| card.name }
+    cards = trellor.card_names(params[:board_name],params[:list_name])
     cards.to_json
   elsif params[:board_name]
     lists = trellor.list_names(params[:board_name])
@@ -53,15 +67,29 @@ get '/boards' do
   end
 end
 
-post '/boards/:board_name/lists/:list_name/cards' do |board_name, list_name|
+post '/boards' do
+  board_name = params['board_name']
+  list_name = params['list_name']
   if params['archive']
     trellor.archive_card(board_name, list_name, params['card_name'])
   else
     trellor.create_card(board_name, list_name, params['card_name'], params['descript'])
   end
 
-  cards = trellor.list(board_name,list_name).cards.collect{ |c| c.name }
+  cards = trellor.card_names(board_name,list_name)
   cards.to_json
   params.to_json
 end
 
+# post '/boards/:board_name/lists/:list_name/cards' do |board_name, list_name|
+  # if params['archive']
+    # trellor.archive_card(board_name, list_name, params['card_name'])
+  # else
+    # trellor.create_card(board_name, list_name, params['card_name'], params['descript'])
+  # end
+
+  # cards = trellor.list(board_name,list_name).cards.collect{ |c| c.name }
+  # cards.to_json
+  # params.to_json
+# end
+

data/trellor.gemspec

@@ -24,8 +24,14 @@ Gem::Specification.new do |spec|
   # for webapi.rb only. Wonder if there is a way to make it a dependency only
   # when it is used?
   spec.add_dependency 'sinatra'
+  spec.add_dependency 'virtus'
+  # spec.add_dependency 'yajl-ruby', require: 'yajl'
+  spec.add_dependency 'yajl-ruby'
 
   spec.add_development_dependency "bundler", "~> 1.10"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "pry-remote"
+  spec.add_development_dependency "pry-nav"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trellor
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.0.4
 platform: ruby
 authors:
 - Brian Murphy-Dye
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-10 00:00:00.000000000 Z
+date: 2015-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-trello
@@ -52,6 +52,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: virtus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yajl-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +122,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-remote
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-nav
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: ''
 email:
 - brian@murphydye.com
@@ -111,7 +181,12 @@ files:
 - bin/console
 - bin/setup
 - bin/trellor
+- docs/trellor.png
+- docs/trellor.txt
+- docs/trellor_seq_diag.png
+- docs/trellor_seq_diag.txt
 - lib/cli.rb
+- lib/models.rb
 - lib/trellor.rb
 - lib/trellor/version.rb
 - lib/web_trellor.rb