Tracker 0.1.2 → 1.0.0

metadata

@@ -1,21 +1,21 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.8.11
+rubygems_version: 0.9.2
 specification_version: 1
 name: Tracker
 version: !ruby/object:Gem::Version 
-  version: 0.1.2
-date: 2007-01-20 00:00:00 -08:00
-summary: Bug tracking application with a command-line interface and a backend SQLite3 database.
+  version: 1.0.0
+date: 2007-05-12 00:00:00 -07:00
+summary: A command line ticket tracker for solo projects.
 require_paths: 
 - lib
-email: bienhd@gmail.com
-homepage: http://ieng6.ucsd.edu/~hbien/tracker
+email: 
+homepage: 
 rubyforge_project: 
 description: 
 autorequire: 
-default_executable: trac
+default_executable: 
 bindir: bin
-has_rdoc: true
+has_rdoc: false
 required_ruby_version: !ruby/object:Gem::Version::Requirement 
   requirements: 
   - - ">"
@@ -25,58 +25,27 @@ required_ruby_version: !ruby/object:Gem::Version::Requirement
 platform: ruby
 signing_key: 
 cert_chain: 
-authors: 
-- Hugh Bien
+post_install_message: 
+authors: []
+
 files: 
-- bin/trac
-- test/test_action.rb
-- test/test_bug.rb
-- test/test_bug_description.rb
-- test/test_integration.rb
-- test/test_interface.rb
-- lib/action.rb
-- lib/bug.rb
-- lib/bug_description.rb
-- lib/database.rb
-- lib/helper.rb
-- lib/interface.rb
-- lib/prompter.rb
-- db/migrate
 - README
-- MIT-LICENSE
-test_files: 
-- test/test_action.rb
-- test/test_bug.rb
-- test/test_bug_description.rb
-- test/test_integration.rb
-- test/test_interface.rb
+- Rakefile
+- lib/comment.rb
+- lib/environment.rb
+- lib/ticket.rb
+- lib/tracker.rb
+test_files: []
+
 rdoc_options: []
 
-extra_rdoc_files: 
-- README
-- MIT-LICENSE
+extra_rdoc_files: []
+
 executables: 
 - trac
 extensions: []
 
 requirements: []
 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: sqlite3-ruby
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
-    requirements: 
-    - - ">"
-      - !ruby/object:Gem::Version 
-        version: 0.0.0
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: activerecord
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
-    requirements: 
-    - - ">"
-      - !ruby/object:Gem::Version 
-        version: 0.0.0
-    version: 
+dependencies: []
+

data/MIT-LICENSE

@@ -1,9 +0,0 @@
-The MIT License
-
-Copyright (c) 2006 Hugh Bien
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/db/migrate

@@ -1,70 +0,0 @@
-#!/usr/bin/env ruby
-
-require "rubygems"
-require_gem "activerecord"
-
-puts "Removing the database..."
-`rm .tracker_db` if File.exists?(".tracker_db")
-
-# Connect to the database
-ActiveRecord::Base.establish_connection(
-  :adapter => "sqlite3", 
-  :database => ".tracker_db"
-)
-
-# Create the bugs table
-ActiveRecord::Schema.define do
-  create_table "bugs" do |t|
-    t.column "name", :string
-    t.column "priority", :int
-    t.column "area", :string
-    t.column "status", :boolean, :default => false
-    t.column "date_time", :date_time
-  end
-end
-
-# Creates the bug_descriptions
-ActiveRecord::Schema.define do
-  create_table "bug_descriptions" do |t|
-    t.column "bug_id", :int
-    t.column "date_time", :date_time
-    t.column "description", :text
-  end
-end
-
-class Bug < ActiveRecord::Base
-  has_many :bug_descriptions
-end
-
-class BugDescription < ActiveRecord::Base
-  belongs_to :bugs
-end
-
-puts "Populating database with test data..."
-yesterday = 1.day.ago.to_s(:db)
-today = Time.now.to_s(:db)
-tomorrow = 1.day.from_now.to_s(:db)
-
-# Add test data to the database
-bug = Bug.create(:name => "First", :priority => 1, :area => "One", :date_time => yesterday, :status => true)
-bug.bug_descriptions.create(:date_time => yesterday, :description => "First description.\n")
-bug.bug_descriptions.create(:date_time => today, :description => "Second description.\n")
-bug.bug_descriptions.create(:date_time => today, :description => "Third description.\n")
-
-bug = Bug.create(:name => "Second", :priority => 2, :area => "Two", :date_time => today, :status => true)
-bug.bug_descriptions.create(:date_time => yesterday, :description => "First description.\n")
-bug.bug_descriptions.create(:date_time => today, :description => "Second description.\n")
-bug.bug_descriptions.create(:date_time => today, :description => "Third description.\n")
-
-bug = Bug.create(:name => "Third", :priority => 3, :area => "Three", :date_time => tomorrow)
-bug.bug_descriptions.create(:date_time => yesterday, :description => "First description.\n")
-bug.bug_descriptions.create(:date_time => today, :description => "Second description.\n")
-bug.bug_descriptions.create(:date_time => today, :description => "Third description.\n")
-
-bug = Bug.create(:name => "Fourth", :priority => 4, :area => "Four", :date_time => tomorrow)
-bug.bug_descriptions.create(:date_time => yesterday, :description => "First description.\n")
-bug.bug_descriptions.create(:date_time => today, :description => "Second description.\n")
-bug.bug_descriptions.create(:date_time => today, :description => "Third description.\n")
-
-
-

data/lib/action.rb

@@ -1,220 +0,0 @@
-require File.dirname(__FILE__) + "/bug.rb"
-require File.dirname(__FILE__) + "/helper.rb"
-
-# The Action module is just a simple interface for the Bug class.  Use this instead of using the Bug class directly, it should satisfy all actions needed to CRUD from the bugs database.
-module Action
-  # Adds a new description to an existing bug.  Used when a user wants to add new information found about a bug.  Takes a hash as parameter where one item is either :name or :id and the other is :description
-  def self.append_description(hash)
-    return nil if hash[:description] =~ /^\s*$/ # Returns nil if no description given
-    bug = Bug.search(hash)
-    bug.bug_descriptions.create(:description => hash[:description]) 
-  end
-  
-  # Closes the bug from being listed.
-  def self.close_bug(hash)
-    bug = Bug.search(hash)
-    bug.update_attributes(:status => true)
-  end
-  
-  # Delets the bug with the given id/name and associated bug descriptions
-  def self.delete_bug(hash)
-    bug = Bug.search(hash)
-    bug.destroy
-  end
-
-  # Lists all of the open bugs by whatever conditions are meant
-  # The intersection of the conditions are returned
-  # By default, status is false
-  def self.list_bugs(hash = Hash.new)
-    hash[:status] = false unless hash.has_key?(:status)
-    bugs = Bug.find(:all, :conditions => Helper::hash_to_sql(hash), :order => "priority DESC, date_time")
-    return bugs
-  end
-  
-  # Takes a hash as a parameter which is the data for the bug.
-  #   * name - Descriptive name used for searching
-  #   * priority - an integer, 1 being the highest priority, as large a number as you want.
-  #   * area - Area, can be the filename, classname, or programmer name, etc.
-  #   * description - Quick description, what was expected, what actually happened, and how to reproduce the bug.
-  def self.new_bug(hash)
-    description = hash[:description]
-    hash.delete(:description)
-    bug = Bug.create(hash)
-    bug.bug_descriptions.create(:description => description)
-    return bug
-  end
-  
-  # Opens a bug to be listed.
-  def self.open_bug(hash)
-    bug = Bug.search(hash)
-    bug.update_attributes(:status => false)
-  end
-
-  # Updates the given bug with new information
-  def self.update_bug(hash)
-    bug = Bug.search(hash)
-    bug.update_attributes(hash)
-  end
-  
-  # Returns all of the areas for the open bugs
-  def self.list_areas(*args)
-    # Find all open bugs
-    bugs = list_bugs(*args)
-    
-    # Get all of the unique areas from the bugs
-    areas = bugs.collect { |bug| bug.area }
-    return areas.uniq
-  end
-  
-  # Returns all of the names of the open bugs
-  def self.list_names(*args)
-    # Find all open bugs
-    bugs = list_bugs(*args)
-    
-    # Get all of the uniqe names from the bugs
-    names = bugs.collect { |bug| bug.name }
-    return names.uniq
-  end
-
-  def self.help_create
-    puts "create: Creates the database in the current directory."
-    puts "usage: trac create"
-    puts ""
-    puts "Creates the file '.tracker_db' in the current directory if it doesn't already exist.  This file is the SQLite3 database that Tracker will use to store your data in."
-  end
-
-  def self.help_append
-    puts "append: Appends the description of a ticket with new comment."
-    puts "usage: trac append [-i ID | -n NAME | -d DESCRIPTION]"
-    puts ""
-    puts "Prompts the user for another description of the ticket.  Tracker will append the additional information to the description field of the ticket."
-    puts ""
-    puts "Available options:"
-    puts "  -i ID | --id ID | ID"
-    puts "  -n NAME | --name NAME | NAME"
-    puts "  -d DESCRIPTION | --description DESCRIPTION"
-    puts ""
-    puts "Sample usage: trac append -n 'old_bug' -d 'This is a new description.'"
-  end
-  
-  def self.help_close
-    puts "close: Closes a ticket."
-    puts "usage: trac close [-i ID | -n NAME]"
-    puts ""
-    puts "Closes the ticket with the given ID or NAME.  Can be used with a shorthand notation - 'trac close ticket_name' is the same as 'trac close -n ticket_name'."
-    puts ""
-    puts "Available options:"
-    puts "  -i ID | --id ID | ID"
-    puts "  -n NAME | --name NAME | NAME"
-  end
-
-  def self.help_delete
-    puts "delete: Deletes a ticket from the database."
-    puts "usage: trac delete [-i ID | -n NAME]"
-    puts ""
-    puts "Deletes the ticket, permanently, from the database.  Be careful with this command, you _cannot_ recover any tickets that are deleted and there are _no_ warnings that ask 'Are you sure?'"
-    puts ""
-    puts "Available options:"
-    puts "  -i ID | --id ID | ID"
-    puts "  -n NAME | --name NAME | NAME"
-  end
-
-  def self.help_list
-    puts "list: Lists all open tickets for viewing."
-    puts "usage: trac list [-i ID | -n NAME | -p PRIORITY | -a AREA | -c | -o]"
-    puts ""
-    puts "This command accepts conditions to filter which tickets are listed:
-  * trac list -p 1
-    Lists all tickets with priority 1.
-  * trac list -a SOME_AREA
-    Lists all tickets with area SOME_AREA.
-  * trac list --closed
-    Lists all closed tickets (by default, will only list open tickets)."
-    puts ""
-    puts "Available options:"
-    puts "  -i ID | --id ID | ID"
-    puts "  -n NAME | --name NAME | NAME"
-    puts "  -p PRIORITY | --priority PRIORITY"
-    puts "  -a AREA | --area AREA"
-    puts "  -d DESCRIPTION | --description DESCRIPTION"
-    puts "  -c | --closed"
-    puts "  -o | --open"
-  end
-
-  def self.help_help
-    puts "help: Displays help messages."
-    puts "usage: trac help [COMMAND]"
-    puts ""
-    puts "Displays the help message for [COMMAND].  For a list of commands, just use 'trac help' with no arguments."
-  end
-
-  def self.help_new
-    puts "new: Creates a new ticket to enter in the database."
-    puts "usage: trac new [-n NAME | -p PRIORITY | -a AREA | -d DESCRIPTION]"
-    puts ""
-    puts "If no options are given, this command will prompt you for all required fields.  If an option is given, that option is used for the ticket."
-    puts ""
-    puts "Sample usage: trac new -n NEW_TICKET_NAME"
-  end
-
-  def self.help_open
-    puts "open: Opens a ticket."
-    puts "usage: trac open [-i ID | -n NAME]"
-    puts ""
-    puts "Opens the ticket with the given ID or NAME.  Can be used with a shorthand notation - 'trac open ticket_name' is the same as 'trac open -n ticket_name'."
-    puts ""
-    puts "Available options:"
-    puts "  -i ID | --id ID | ID"
-    puts "  -n NAME | --name NAME | NAME"
-  end
-
-  def self.help_update
-    puts "update: Updates a ticket's fields."
-    puts "usage: trac update [-i ID | -n NAME | -p PRIORITY | -a AREA]"
-    puts ""
-    puts "Will update a ticket's name, priority, and/or area.  To use it, just supply the command with either a name or id and the new updated fields:
-  * trac update -n some_ticket -p 1
-    Changes the ticket with name 'some_ticket' to have a priority of 1.
-  * trac update -i 2 -n new_name
-    Changes ticket #2 to have the name 'new_name'."
-    puts ""
-    puts "Available options:"
-    puts "  -i ID | --id ID | ID"
-    puts "  -n NAME | --name NAME | NAME"
-    puts "  -p PRIORITY | --priority PRIORITY"
-    puts "  -a AREA | --area AREA"
-  end
-
-  def self.help_areas
-    puts "areas: Lists all areas."
-    puts "usage: trac areas [-i ID | -n NAME | -p PRIORITY | -a AREA | -c | -o]"
-    puts ""
-    puts "This command is the same as 'trac list' except instead of displaying the entire ticket, it only displays the ticket's areas.  This command is meant to be used as a quick look-up for existing areas."
-    puts ""
-    puts "Available options:"
-    puts "  -i ID | --id ID | ID"
-    puts "  -n NAME | --name NAME | NAME"
-    puts "  -p PRIORITY | --priority PRIORITY"
-    puts "  -a AREA | --area AREA"
-    puts "  -d DESCRIPTION | --description DESCRIPTION"
-    puts "  -c | --closed"
-    puts "  -o | --open"
-  end
-
-  def self.help_names
-    puts "names: Lists all areas."
-    puts "usage: trac names [-i ID | -n NAME | -p PRIORITY | -a AREA | -c | -o]"
-    puts ""
-    puts "This command is the same as 'trac list' except instead of displaying the entire ticket, it only displays the ticket's names.  This command is meant to be used as a quick look-up for existing names."
-    puts ""
-    puts "Available options:"
-    puts "  -i ID | --id ID | ID"
-    puts "  -n NAME | --name NAME | NAME"
-    puts "  -p PRIORITY | --priority PRIORITY"
-    puts "  -a AREA | --area AREA"
-    puts "  -d DESCRIPTION | --description DESCRIPTION"
-    puts "  -c | --closed"
-    puts "  -o | --open"
-    end
-end
-

data/lib/bug.rb

@@ -1,63 +0,0 @@
-require 'rubygems'
-require_gem 'activerecord'
-
-# Fields are name (string), priority (int), area (string), status (boolean).
-class Bug < ActiveRecord::Base
-  has_many :bug_descriptions, :dependent => :delete_all
-  before_create :save_date_time
-  before_update :save_date_time
-  
-  # Is the bug open?
-  def open?
-    !status
-  end
-  
-  # Is the bug closed?
-  def closed?
-    status
-  end
-  
-  # Searches for a bug with given name or id
-  def self.search(term=nil)
-    # Get the needed search term if the argument is a hash
-    term = self.get_term(term) if term.kind_of?(Hash)
-    
-    # Find the right bug
-    bug = self.get_bug_from_id_or_name(term)
-    
-    # What to do if the bug isn't found
-    if bug == nil
-      raise Exception, "Bug not found with name '#{term}'." if term.kind_of?(String)
-      raise Exception, "Bug not found with id \##{term}." if term.kind_of?(Fixnum)
-    end
-    
-    # Return the bug
-    return bug
-  end
-  
-  private
-  # Makes sure the time is saved whenever a bug is saved or modified
-  def save_date_time
-    self.date_time = Time.now.to_s(:db)
-  end
-    
-  # Gets the term (name or id) out of a hash
-  def self.get_term(hash)
-    term = hash[:name] if hash.has_key?(:name)
-    term = hash[:id] if hash.has_key?(:id)
-    return term
-  end
-  
-  # Get the bug when given an id or name
-  def self.get_bug_from_id_or_name(search_key)
-    if search_key.kind_of?(String)
-      bug = find_by_name(search_key)
-    elsif search_key.kind_of?(Fixnum)
-      bug = find_by_id(search_key)
-    end
-    return bug
-  end
-    
-  alias_method :opened?, :open?
-  
-end