RubyGems - kood - Versions diffs - 0.0.1 - Mend

kood 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

data/.gitignore +47 -0
data/.yardopts +4 -0
data/Gemfile +2 -0
data/LICENSE +22 -0
data/README.md +9 -0
data/Rakefile +40 -0
data/bin/kood +4 -0
data/kood.gemspec +26 -0
data/lib/kood-plugin-example.rb +10 -0
data/lib/kood.rb +14 -0
data/lib/kood/adapter/git.rb +56 -0
data/lib/kood/adapter/user_config.rb +36 -0
data/lib/kood/board.rb +160 -0
data/lib/kood/card.rb +128 -0
data/lib/kood/cli.rb +121 -0
data/lib/kood/cli/board.rb +139 -0
data/lib/kood/cli/card.rb +188 -0
data/lib/kood/cli/edit.rb +40 -0
data/lib/kood/cli/helpers/shell.rb +124 -0
data/lib/kood/cli/helpers/table.rb +195 -0
data/lib/kood/cli/list.rb +70 -0
data/lib/kood/cli/plugin.rb +37 -0
data/lib/kood/cli/switch.rb +10 -0
data/lib/kood/core.rb +95 -0
data/lib/kood/errors.rb +8 -0
data/lib/kood/extensions/grit.rb +65 -0
data/lib/kood/list.rb +36 -0
data/lib/kood/version.rb +3 -0
data/man/kood-board.1 +74 -0
data/man/kood-board.1.html +150 -0
data/man/kood-board.1.ronn +65 -0
data/man/kood-card.1 +40 -0
data/man/kood-card.1.html +140 -0
data/man/kood-card.1.ronn +52 -0
data/spec/kood/cli_spec.rb +280 -0
data/spec/spec_helper.rb +67 -0
data/test/kood/cli_test.rb +67 -0
metadata +198 -0

data/man/kood-board.1.ronn ADDED

@@ -0,0 +1,65 @@
+kood(1) -- sample help page
+===========================
+## SYNOPSIS
+`kood` [<format>...] <file>...<br>
+`kood` `-m`|`--man` <file>...<br>
+`kood` `-S`|`--server` <file>...<br>
+`kood` `--pipe` <file><br>
+`kood` &lt; <file>
+## DESCRIPTION
+**Kood** is a CLI for taskboards with a minimal self-hosted web interface.
+## FILES
+Sed posuere consectetur est at lobortis. Fusce dapibus, tellus ac cursus commodo,
+tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus. Curabitur
+blandit tempus porttitor. Duis mollis, est non commodo luctus, nisi erat porttitor
+ligula, eget lacinia odio sem nec elit. Cum sociis natoque penatibus et magnis dis
+parturient montes, nascetur ridiculus mus. Praesent commodo cursus magna, vel
+scelerisque nisl consectetur et. Curabitur blandit tempus porttitor.
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec ullamcorper nulla
+non metus auctor fringilla. Aenean eu leo quam. Pellentesque ornare sem lacinia
+quam venenatis vestibulum. Curabitur blandit tempus porttitor.
+## OPTIONS
+These options control things.
+  * `-s`, `--sample`:
+    Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+    Maecenas faucibus mollis interdum. Curabitur blandit tempus porttitor.
+  * `-L`, `--lorem`:
+    Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
+    Cras mattis consectetur purus sit amet fermentum.
+  * `--pipe`:
+    Don't generate files, write generated output to standard output. This is the
+    default behavior when ronn source text is piped in on standard input and no
+    <file> arguments are provided.
+Miscellaneous options:
+  * `-e`, `--example`:
+    Porta risus etiam consectetur vestibulum.
+## EXAMPLES
+Vestibulum id ligula porta felis euismod semper:
+    $ kood --clone my-board new-board
+    $ kood --c my-board new-board
+    $ kood --assigned user@server status
+## BUGS
+**Kood** is a work in progress.
+## SEE ALSO
+kood-card(1), kood-status(1)

data/man/kood-card.1 ADDED

@@ -0,0 +1,40 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "KOOD\-CARD" "1" "January 2013" "" ""
+.
+.SH "NAME"
+\fBkood\-card\fR \- sample help page
+.
+.SH "SYNOPSIS"
+A brief synopsis of how to invoke your app on the command line\. This should be similar to what the default banner is in OptionParser or what is output by GLI after the “Usage:” bit\.
+.
+.SH "DESCRIPTION"
+A longer description of what your app does, why the user might use it, and any additional details\. This section should be targeted at new users and written to help them understand how to use your app\.
+.
+.SH "OPTIONS"
+A bullet list documenting each option\. This is a chance to explain in more detail how the options work and what effect they have on your app’s behavior\.
+.
+.SH "EXAMPLES"
+One or more examples of using the app, including brief text explaining each example\.
+.
+.SH "FILES"
+A list of files on the filesystem that the app uses (for example, todo would document the default to\-do list file’s location here)\.
+.
+.SH "ENVIRONMENT"
+A bullet list of any environment variables that affect the app’s behavior\.
+.
+.SH "BUGS"
+Known bugs or odd behaviors\.
+.
+.SH "LICENSE"
+The name of the license and a reference to the full license text (you do not need to reproduce the entire license here)\.
+.
+.SH "AUTHOR"
+The authors of your app and their email addresses\.
+.
+.SH "COPYRIGHT"
+The copyright information for your app\.
+.
+.SH "SEE ALSO"
+Links to other commands or places on the Web that are relevant for your app\.

data/man/kood-card.1.html ADDED

@@ -0,0 +1,140 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
+  <title>kood-card(1) - sample help page</title>
+  <style type='text/css' media='all'>
+  /* style: man */
+  body#manpage {margin:0}
+  .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
+  .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
+  .mp h2 {margin:10px 0 0 0}
+  .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
+  .mp h3 {margin:0 0 0 4ex}
+  .mp dt {margin:0;clear:left}
+  .mp dt.flush {float:left;width:8ex}
+  .mp dd {margin:0 0 0 9ex}
+  .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
+  .mp pre {margin-bottom:20px}
+  .mp pre+h2,.mp pre+h3 {margin-top:22px}
+  .mp h2+pre,.mp h3+pre {margin-top:5px}
+  .mp img {display:block;margin:auto}
+  .mp h1.man-title {display:none}
+  .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
+  .mp h2 {font-size:16px;line-height:1.25}
+  .mp h1 {font-size:20px;line-height:2}
+  .mp {text-align:justify;background:#fff}
+  .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
+  .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
+  .mp u {text-decoration:underline}
+  .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
+  .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
+  .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
+  .mp b.man-ref {font-weight:normal;color:#434241}
+  .mp pre {padding:0 4ex}
+  .mp pre code {font-weight:normal;color:#434241}
+  .mp h2+pre,h3+pre {padding-left:0}
+  ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
+  ol.man-decor {width:100%}
+  ol.man-decor li.tl {text-align:left}
+  ol.man-decor li.tc {text-align:center;letter-spacing:4px}
+  ol.man-decor li.tr {text-align:right;float:right}
+  </style>
+</head>
+<!--
+  The following styles are deprecated and will be removed at some point:
+  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
+  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
+  .man-navigation should be used instead.
+-->
+<body id='manpage'>
+  <div class='mp' id='man'>
+  <div class='man-navigation' style='display:none'>
+    <a href="#NAME">NAME</a>
+    <a href="#SYNOPSIS">SYNOPSIS</a>
+    <a href="#DESCRIPTION">DESCRIPTION</a>
+    <a href="#OPTIONS">OPTIONS</a>
+    <a href="#EXAMPLES">EXAMPLES</a>
+    <a href="#FILES">FILES</a>
+    <a href="#ENVIRONMENT">ENVIRONMENT</a>
+    <a href="#BUGS">BUGS</a>
+    <a href="#LICENSE">LICENSE</a>
+    <a href="#AUTHOR">AUTHOR</a>
+    <a href="#COPYRIGHT">COPYRIGHT</a>
+    <a href="#SEE-ALSO">SEE ALSO</a>
+  </div>
+  <ol class='man-decor man-head man head'>
+    <li class='tl'>kood-card(1)</li>
+    <li class='tc'></li>
+    <li class='tr'>kood-card(1)</li>
+  </ol>
+  <h2 id="NAME">NAME</h2>
+<p class="man-name">
+  <code>kood-card</code> - <span class="man-whatis">sample help page</span>
+</p>
+<h2 id="SYNOPSIS">SYNOPSIS</h2>
+<p>A brief synopsis of how to invoke your app on the command line. This should be similar to
+what the default banner is in OptionParser or what is output by GLI after the “Usage:” bit.</p>
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
+<p>A longer description of what your app does, why the user might use it, and any additional
+details. This section should be targeted at new users and written to help them understand
+how to use your app.</p>
+<h2 id="OPTIONS">OPTIONS</h2>
+<p>A bullet list documenting each option. This is a chance to explain in more detail how the
+options work and what effect they have on your app’s behavior.</p>
+<h2 id="EXAMPLES">EXAMPLES</h2>
+<p>One or more examples of using the app, including brief text explaining each example.</p>
+<h2 id="FILES">FILES</h2>
+<p>A list of files on the filesystem that the app uses (for example, todo would document the
+default to-do list file’s location here).</p>
+<h2 id="ENVIRONMENT">ENVIRONMENT</h2>
+<p>A bullet list of any environment variables that affect the app’s behavior.</p>
+<h2 id="BUGS">BUGS</h2>
+<p>Known bugs or odd behaviors.</p>
+<h2 id="LICENSE">LICENSE</h2>
+<p>The name of the license and a reference to the full license text (you do not need to
+reproduce the entire license here).</p>
+<h2 id="AUTHOR">AUTHOR</h2>
+<p>The authors of your app and their email addresses.</p>
+<h2 id="COPYRIGHT">COPYRIGHT</h2>
+<p>The copyright information for your app.</p>
+<h2 id="SEE-ALSO">SEE ALSO</h2>
+<p>Links to other commands or places on the Web that are relevant for your app.</p>
+  <ol class='man-decor man-foot man foot'>
+    <li class='tl'></li>
+    <li class='tc'>January 2013</li>
+    <li class='tr'>kood-card(1)</li>
+  </ol>
+  </div>
+</body>
+</html>

data/man/kood-card.1.ronn ADDED

@@ -0,0 +1,52 @@
+kood-card(1) -- sample help page
+================================
+## SYNOPSIS
+A brief synopsis of how to invoke your app on the command line. This should be similar to
+what the default banner is in OptionParser or what is output by GLI after the “Usage:” bit.
+## DESCRIPTION
+A longer description of what your app does, why the user might use it, and any additional
+details. This section should be targeted at new users and written to help them understand
+how to use your app.
+## OPTIONS
+A bullet list documenting each option. This is a chance to explain in more detail how the
+options work and what effect they have on your app’s behavior.
+## EXAMPLES
+One or more examples of using the app, including brief text explaining each example.
+## FILES
+A list of files on the filesystem that the app uses (for example, todo would document the
+default to-do list file’s location here).
+## ENVIRONMENT
+A bullet list of any environment variables that affect the app’s behavior.
+## BUGS
+Known bugs or odd behaviors.
+## LICENSE
+The name of the license and a reference to the full license text (you do not need to
+reproduce the entire license here).
+## AUTHOR
+The authors of your app and their email addresses.
+## COPYRIGHT
+The copyright information for your app.
+## SEE ALSO
+Links to other commands or places on the Web that are relevant for your app.

data/spec/kood/cli_spec.rb ADDED

@@ -0,0 +1,280 @@
+# -*- encoding: utf-8 -*-
+require 'spec_helper'
+describe Kood::CLI do
+  before do
+    %w{ refs/heads HEAD }.each { |f| Kood.repo.git.fs_delete(f) }
+    Kood.clear_repo # Force kood to create the master branch again
+    Kood::Config.clear_instance
+    Kood::Shell.set_terminal_size
+    Adapter::UserConfigFile.clear_conf
+  end
+  describe "kood board" do
+    it "complains if any boards exist" do
+      kood('boards').must_equal "No boards were found."
+    end
+    it "creates on `board foo`" do
+      kood('board foo').must_equal "Board created and selected."
+      kood('boards').must_equal "* foo  (private)"
+    end
+    it "forces unique IDs" do
+      kood('board foo')
+      kood('board foo').must_equal "A board with this ID already exists."
+    end
+    it "complains if an invalid character is used in the board ID" do
+      kood('board foo:').must_equal      "Board ID is invalid."
+      kood('board "foo bar"').must_equal "Board ID is invalid."
+      kood('board foo@bar').must_equal   "Board ID is invalid."
+    end
+    it "displays a list on `boards`" do
+      kood('board foo', 'board bar')
+      kood('boards').must_equal "* foo  (private)\n  bar  (private)"
+    end
+    it "deletes on `board foo --delete`" do
+      kood('board foo', 'board bar')
+      kood('board bar -d').must_equal "Board deleted."
+      # Same result is excepted if the board has contents
+      kood('b bar', 'sw bar', 'l lorem', 'c ipsum -l lorem', 'b sw foo')
+      kood('board bar -d').must_equal "Board deleted."
+    end
+    it "deletes the current board on `board --delete`" do
+      kood('board foo')
+      kood('board --delete').must_equal "Board deleted."
+      # Same result is excepted if the board has contents
+      kood('b foo', 'l lorem', 'c ipsum -l lorem')
+      kood('board foo -d').must_equal "Board deleted."
+    end
+    it "complains to delete an inexistent board" do
+      kood('board foo -d').must_equal "The specified board does not exist."
+    end
+    it "switches to board on `board switch`" do
+      kood('board foo', 'board bar')
+      kood('switch bar').must_equal "Board switched to bar."
+      kood('boards').must_equal     "  foo  (private)\n* bar  (private)"
+      kood('select bar').must_equal "Board switched to bar." # Alias
+    end
+    it "creates an external board on `board foo --repo`" do
+      kood('board foo -r /tmp/example-git/').must_equal "Board created and selected."
+      kood('boards').must_equal "* foo  (private at /tmp/example-git/)"
+    end
+    # TODO Test the push, pull and sync commands
+  end
+  describe "kood list" do
+    before do
+      kood('board foo')
+    end
+    it "complains if any lists exist" do
+      kood('lists').must_equal "No lists were found."
+    end
+    it "creates on `list bar`" do
+      kood('list bar').must_equal "List created."
+      kood('lists').must_equal "bar"
+    end
+    it "forces unique IDs in one board" do
+      kood('list bar')
+      kood('list bar').must_equal "A list with this ID already exists."
+    end
+    it "does not force unique IDs between boards" do
+      kood('list bar', 'board test', 'switch test')
+      kood('list bar').must_equal "List created."
+    end
+    it "displays a list on `lists`" do
+      kood('list hello', 'list world')
+      kood('lists').must_equal "hello\nworld"
+    end
+    it "deletes on `list bar --delete`" do
+      kood('list bar')
+      kood('list bar -d').must_equal "List deleted."
+    end
+    it "complains to delete an inexistent list" do
+      kood('list bar -d').must_equal "The specified list does not exist."
+    end
+  end
+  describe "kood card" do
+    before do
+      kood('board foo', 'board bar', 'list hello', 'list world')
+    end
+    it "creates on `card 'Sample card' -l hello`" do
+      kood('card "Sample card" --list hello').must_equal "Card created."
+      kood('cards').must_include "Sample card"
+    end
+    it "deletes on `card 'Sample card' --delete`" do
+      kood('card "Sample card" -l hello')
+      kood('card "Sample card" -d').must_equal "Card deleted."
+      kood('cards').wont_include "Sample card"
+    end
+    it "complains to delete an inexistent card" do
+      kood('card none -d').must_equal "The specified card does not exist."
+    end
+    it "complains to delete when there are several matches" do
+      kood('card "foo 0" -l hello', 'card "foo 1" -l hello')
+      kood('card "foo" -d').must_equal "Multiple cards match the given criteria."
+      kood('card "bar" -l hello', 'card "bar" -l hello')
+      kood('card "bar" -d').must_equal "Multiple cards match the given criteria."
+    end
+    it "complains to show an inexistent card" do
+      kood('card "Sample card"').must_equal "The specified card does not exist."
+    end
+    it "displays information on `card 'Sample card'`" do
+      kood('card "Sample card" --list hello')
+      kood('card "Sample card"').must_include "\u2503 Sample card"
+    end
+    it "displays information given partial title`" do
+      kood('card fo --list hello', 'card foo -l hello', 'card lorem -l hello')
+      kood('card fo').must_include   "\u2503 fo"
+      kood('card foo').must_include  "\u2503 foo"
+      kood('card f').must_include    "\u2503 fo"
+      kood('card Fo').must_include   "\u2503 fo" # Case-insentive comparison
+      kood('card F').must_include    "\u2503 fo"
+      kood('card l.*e').must_include "\u2503 lorem"
+      kood('card z').must_include    "The specified card does not exist."
+    end
+    it "displays an empty board if any cards exist" do
+      res = kood('cards')
+      res.must_include "foo"   # Board title
+      res.must_include "hello" # One of the lists
+      res.wont_include "bar"   # The other board
+    end
+    it "supports titles with non-ascii characters" do
+      kood('card "hello ümlaut ✔" --list hello')
+      kood('card "hello ümlaut ✔"').must_include "hello ümlaut ✔"
+    end
+    it "supports setting several attributes at once" do
+      kood('c lorem -l hello --set title:"Lorem Ipsum" content:"Content"')
+      out = kood('card lorem')
+      out.must_include "Lorem Ipsum"
+      out.must_include "Content"
+    end
+    it "supports setting custom attributes with different types" do
+      kood('c lorem -l hello --set foo:bar priority:1 hello_world:-0.42')
+      out = kood('card lorem')
+      out.must_include "Foo:          bar"
+      out.must_include "Priority:     1"
+      out.must_include "Hello world:  -0.42"
+    end
+    it "prevents the user from overriding the value of the 'list' and 'more' attributes" do
+      kood('c lorem -l hello --set list_id:world list:world more:example')
+      out = kood('card lorem')
+      out.must_include "List:  world"   # This means custom user attributes were set
+      out.must_include "More:  example" # instead of modifying the default attributes
+    end
+    it "unsets attributes on `card sample --unset content:foo`" do
+      kood('c lorem -l hello -s content:ex foo:bar')
+      kood('c lorem --unset content foo').must_equal "Card updated."
+      kood('c lorem').wont_match /content.*foo/i
+    end
+    it "prevents the user from unsetting the 'title', 'list' and 'more' attributes" do
+      out = kood('c lorem -l hello --unset title list list_id more')
+      out.must_equal("Card created.\nNo changes to persist.")
+    end
+    it "adds participants to a card on `card sample --add participants foo`" do
+      user_name  = `git config --get user.name `.chomp
+      user_email = `git config --get user.email`.chomp
+      kood("c lorem -l hello --add participants #{ user_name.split.first }")
+      kood('c lorem').must_include "Participants:  #{ user_name } <#{ user_email }>"
+    end
+    it "adds elements to custom array attributes" do
+      kood('c lorem -l hello --add foo one two three')
+      kood('c lorem').must_include "Foo:  one, two, three"
+    end
+    it "removes participants from a card on `c sample --remove participants foo`" do
+      first_name  = `git config --get user.name `.chomp.split.first
+      kood("c lorem -l hello -a participants #{ first_name } José")
+      kood("c lorem --remove participants #{ first_name }")
+      kood('c lorem').must_include "Participants:  José"
+      kood("c lorem --remove participants José")  # For now, for non-potential members it
+      kood('c lorem').wont_include "Participants" # needs to be an exact match
+    end
+    it "removes elements from custom array attributes" do
+      kood('c lorem -l hello --add foo one two three', 'c lorem -r foo one two')
+      kood('c lorem').must_include "Foo:  three"
+      kood("c lorem --remove foo three")
+      kood('c lorem').must_include "Foo:   " # This may change in the future
+      kood("c lorem --unset foo")
+      kood('c lorem').wont_include "Foo"
+    end
+    it "copies to the same list on `card 'Sample card' --copy`" do
+      kood('card sample -l hello')
+      kood('card sample -c').must_equal "Card copied."
+      kood('card jambaz -l world')
+      kood('card').gsub("\n","").must_match /hello.*world.*sample.*jambaz.*sample/
+    end
+    it "copies to another list on `card 'Sample card' --copy list`" do
+      kood('card sample -l hello')
+      kood('card sample -c world').must_equal "Card copied."
+      kood('card jambaz -l world')
+      kood('card').gsub("\n","").must_match /hello.*world.*sample.*sample.*jambaz/
+    end
+    it "supports the combination of the copy and delete options" do
+      kood('card sample -l hello')
+      old_id = kood('card sample').match(/\u2503 (.*) \(created/).captures[0]
+      out = kood('card')
+      kood("card #{ old_id } -cd").must_equal "Card copied.\nCard deleted."
+      new_id = kood('card sample').match(/\u2503 (.*) \(created/).captures[0]
+      kood('card').must_equal out.gsub(old_id.slice(0, 8), new_id.slice(0, 8))
+    end
+    it "also displays labels on `cards`" do
+      # Without colors
+      kood('c sample -l hello --add labels bug docs user-story tech-story foo bar')
+      kood('c').must_include "sample #bug, #docs, #user-story, #tech-story, #foo, #bar"
+      # With colors
+      colors = [31, 36, 35, 32, 34] # red, cyan, magenta, green, blue
+      colors.map! { |c| "\e[#{ c }m#{ "\u2501"*3 }\e[0m" }
+      kood_colored('cards').must_include ["\u2501", colors, "\u2501\u254B"].join
+      # When there isn't enough space for all labels, a grey label is added
+      Kood::Shell.set_terminal_size(30)
+      colors = [31, 36].map! { |c| "\e[#{ c }m#{ "\u2501"*3 }\e[0m" }
+      more_labels = "\e[30m\e[1m#{ "\u2501"*3 }\e[0m"
+      kood_colored('c').must_include ["\u2501", colors, more_labels, "\u2501\u254B"].join
+    end
+    # TODO Test for utf-8 in card descriptions
+  end
+  describe "kood edit" do
+    before do
+      kood('board foo', 'list bar', 'card hello --list bar')
+    end
+    it "complains if no EDITOR is set" do
+      set_env(KOOD_EDITOR: "", EDITOR: "")
+      kood('edit hello').must_equal "To edit a card set $EDITOR or $KOOD_EDITOR."
+    end
+    it "edits the card with KOOD_EDITOR as highest priority" do
+      set_env(KOOD_EDITOR: "kood_editor", EDITOR: "editor")
+      kood('edit hello').must_match /^Could not run `kood_editor cards\/.*\.md`\.$/
+    end
+    it "edits the card with EDITOR as 2nd highest priority" do
+      set_env(KOOD_EDITOR: "", EDITOR: "editor")
+      kood('edit hello').must_match /^Could not run `editor cards\/.*\.md`\.$/
+    end
+    it "notices if the editor exited without changes" do
+      set_env(KOOD_EDITOR: "true") # true is a unix command that returns nothing
+      out = "The editor exited without changes. Run `kood update` to persist changes."
+      kood('edit hello').must_equal out
+      kood('card hello -e').must_equal out # Alias
+      # Just to make sure it actually opens the file. Since edit uses `system`, programs
+      # like `cat` will print to stdout and we can't capture the output here
+      set_env(KOOD_EDITOR: "ruby -e \"exit 1 unless File.read(ARGV[0]).include?('title')\"")
+      kood('edit hello').wont_match "Could not run"
+    end
+  end
+  it "complains if an unknown option is typed" do
+    kood('--unknown').must_equal "Unknown switches '--unknown'"
+  end
+  it "complains if an unknown command is typed" do
+    kood('unknown').must_equal "Could not find task \"unknown\"."
+  end
+  # it "supports third-party plugins" do # TODO
+  #   kood('example foo').must_equal "Hello from example"
+  # end
+end