jtask 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f589f44037f5f3b2e2032dee07d5a47ebea4b3a6
-  data.tar.gz: 80d389752aea2d76dafdb73448b89b1ab7998a11
+  metadata.gz: 6ae14c187755bf9181d003c8bfeb5537fda03973
+  data.tar.gz: cc4a2c726b565aadfefa509e0f39c6dee8c2af68
 SHA512:
-  metadata.gz: 1f41a63d10b147aff1c1901e9ea171fcdd05b98f207fb767a7a868b9002a333c2ff0698b7d77dcf9eefa77bfb3293a7e8498eb2862860d76c382c33c4e563f72
-  data.tar.gz: b15a34adffb7429425bb5495cfb8e6760959ec2445498ec84a8628348e95c7727d08c53581140e6302a8b8b841c6d5f79cffae7c76976bcae2e0bc91857b118d
+  metadata.gz: b31141a40e28673e441de44b125d6cfdcff9f3a876bbe808fe4db6832b23903826b0d79c3397084fca5697823bfb7d73e89fbe682feca8691f40f82892ca50de
+  data.tar.gz: e8df258605043ae890c5b27fde02e78e2982b3f3f6cd03ab649c214d2ce76bab8248f334a8f886cbd2458c2ae4d09bed65c78a27e2123ccf3b3d0152523f197a

data/jtask.gemspec

@@ -1,8 +1,8 @@
 Gem::Specification.new do |s|
   s.name        = 'jtask'
-  s.version     = '0.2.0'
+  s.version     = '0.3.0'
   s.platform    = Gem::Platform::RUBY
-  s.date        = '2014-04-01'
+  s.date        = '2014-04-03'
   s.description = "Provides CRUD actions for JSON files, plus a few extra goodies."
   s.summary     = "CRUD actions for JSON files."
   s.authors     = ["Adam McArthur"]
@@ -12,5 +12,5 @@ Gem::Specification.new do |s|
   s.files       = `git ls-files`.split($/)
   s.require_paths = ["lib"]
   s.add_runtime_dependency "json", "~> 1.4"
-  s.post_install_message = "\nThanks for installing JTask Beta. Check out the full documentation and contribute at https://github.com/adammcarthur/jtask\n\nIn this release (v0.2.0 Beta): JTask now outputs OpenStructs instead of Hashes. Read more about this update here: https://github.com/adammcarthur/jtask/issues/2\n\n- Adam (@adammcarth)\n-"
+  s.post_install_message = "\nThanks for installing JTask Beta. Check out the full documentation and contribute at https://github.com/adammcarthur/jtask\n\nIn this release (v0.3.0 Beta): https://github.com/adammcarthur/jtask/releases/tag/v0.3.0\n\n- Adam (@adammcarth)\n-"
 end

data/lib/jtask.rb

@@ -12,17 +12,15 @@ class JTask
   require "ostruct"
   require "json"
 
-  # Modules
-  modules = ["save", "get", "update", "destroy", "chop", "rename", "kill"]
-  modules.each do |m|
-    require "jtask/#{m}"
-  end
+  # Configuration
+  require "jtask/config"
+
+  # Helpers
+  require "jtask/helpers"
 
-  extend Save
-  extend Get
-  extend Update
-  extend Destroy
-  extend Chop
-  extend Rename
-  extend Kill
+  # Tasks
+  tasks = ["save", "get", "update", "destroy", "chop", "rename", "kill", "convert"]
+  tasks.each do |task|
+    require "jtask/#{task}"
+  end
 end

data/lib/jtask/chop.rb

@@ -1,14 +1,21 @@
-module Chop
-  def chop(filename, id, parameter, dir=nil)
-    # Check if user has specified a custom directory.
-    unless dir
-      # If not, a default folder is assigned.
-      if File.directory?("models/")
-        dir = "models/"
-      else
-        raise RuntimeError, "[JTask] The directory 'models/' doesn't exist in your current location. Please create it or refer to the documentation on how to change your file path."
-      end
-    end
+# JTask.chop()
+# Removes an entire key-value pair from one or all of the file's objects.
+# ------------------------------------------------------------------------------
+# Eg: JTask.chop("user_data.json", :all, "session_dump")
+# #=> true
+# ------------------------------------------------------------------------------
+# See wiki guide for more usage examples...
+# https://github.com/adammcarthur/jtask/wiki/JTask.chop()
+
+require "json"
+require "jtask/helpers"
+
+class JTask
+  def self.chop(filename, id, parameter, dir=nil)
+    # Set the directory
+    dir = JTask::Helpers.set_directory(dir)
+
+    # Parse the file
     original_file = File.read(File.join(dir, filename))
     objects = JSON.parse(original_file)
 

data/lib/jtask/config.rb

@@ -0,0 +1,22 @@
+class JTask
+  # Provides configuration options for JTask.
+  # Included in `lib/jtask.rb`.
+  class Configuration
+    # Used to set the default directory JTask looks in for files.
+    attr_accessor :file_dir
+
+    def initialize
+      self.file_dir = "models/"
+    end
+  end
+
+  # Allow options to be set under the JTask namespace.
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.configure
+    # Update Configuration with new values if config the block is given.
+    yield(configuration) if block_given?
+  end
+end

data/lib/jtask/convert.rb

@@ -0,0 +1,49 @@
+# JTask::Convert
+# Prepares existing json files to be manipulated by JTask's methods.
+# -----------------------------------------------------------------------------------
+# Eg: JTask::Convert.json_file("wordpress_users_export.json")
+# #=> true
+# -----------------------------------------------------------------------------------
+# See wiki guide for more usage examples...
+# https://github.com/adammcarthur/jtask/wiki/JTask::Convert
+
+require "json"
+require "jtask/rename"
+require "jtask/save"
+require "jtask/helpers"
+
+class JTask
+  module Convert
+    def self.json_file(filename, dir=nil)
+      # Set the directory
+      dir = JTask::Helpers.set_directory(dir)
+
+      # Parse the file
+      original_file = File.read(File.join(dir, filename))
+      objects = JSON.parse(original_file)
+
+      output = Hash.new
+      objects.each_with_index do |(k, v), n|
+        output["#{n + 1}"] = {k => v}
+      end
+
+      # Rename the old version
+      begin
+        JTask.rename(filename, "#{filename}.old", dir)
+      rescue
+        raise RuntimeError, "[JTask] Failed to backup original file, conversion aborted."
+      end
+
+      # Write the new version
+      begin
+        JTask.save(filename, output, dir)
+      rescue
+        raise RuntimeError, "[JTask] Failed to save the converted file. The original can be found at '#{dir}#{filename}.old'"
+      end
+
+      return true
+    end
+  end
+end
+
+# JTask::Convert.json_file("orders.json")

data/lib/jtask/destroy.rb

@@ -1,14 +1,21 @@
-module Destroy
-  def destroy(filename, id, dir=nil)
-    # Check if user has specified a custom directory.
-    unless dir
-      # If not, a default folder is assigned.
-      if File.directory?("models/")
-        dir = "models/"
-      else
-        raise RuntimeError, "[JTask] The directory 'models/' doesn't exist in your current location. Please create it or refer to the documentation on how to change your file path."
-      end
-    end
+# JTask.destroy()
+# Removes an entire object from the file.
+# ------------------------------------------------------------------
+# Eg: JTask.destroy("orders.json", 5)
+# #=> true
+# ------------------------------------------------------------------
+# See wiki guide for more usage examples...
+# https://github.com/adammcarthur/jtask/wiki/JTask.destroy()
+
+require "json"
+require "jtask/helpers"
+
+class JTask
+  def self.destroy(filename, id, dir=nil)
+    # Set the directory
+    dir = JTask::Helpers.set_directory(dir)
+
+    # Parse the file
     original_file = File.read(File.join(dir, filename))
     objects = JSON.parse(original_file)
 

data/lib/jtask/get.rb

@@ -1,17 +1,43 @@
-# JTask.get() by Adam McArthur
-# Retrieves stored JSON data from the file and returns a hash.
-
-module Get
-  def get(filename, method=nil, dir=nil)
-    # Check if user has specified a custom directory.
-    unless dir
-      # If not, a default folder is assigned.
-      if File.directory?("models/")
-        dir = "models/"
-      else
-        raise RuntimeError, "[JTask] The directory 'models/' doesn't exist in your current location. Please create it or refer to the documentation on how to change your file path."
+# JTask.get()
+# Retrieves stored JSON data from the file and returns an OpenStruct.
+# --------------------------------------------------------------------------------
+# Eg: JTask.get("test.json", 1) || JTask.get("test.json", first: 10)
+# #=> <OpenStruct id=x, ...>
+# --------------------------------------------------------------------------------
+# See wiki guide for more usage examples...
+# https://github.com/adammcarthur/jtask/wiki/JTask.get()
+
+require "json"
+require "ostruct"
+require "jtask/helpers"
+
+class JTask
+  # Allows nested OpenStructs, refer to http://andreapavoni.com/blog/2013/4/create-recursive-openstruct-from-a-ruby-hash
+  # Credits: Andrea Pavoni (DeepStruct guru)
+  class Get < OpenStruct
+    def initialize(hash=nil)
+      @table = {}
+      @hash_table = {}
+      if hash
+        hash.each do |k,v|
+          @table[k.to_sym] = (v.is_a?(Hash) ? self.class.new(v) : v)
+          @hash_table[k.to_sym] = v
+          new_ostruct_member(k)
+        end
       end
     end
+    def to_h
+      @hash_table
+    end
+  end
+end
+
+class JTask
+  def self.get(filename, method=nil, dir=nil)
+    # Set the directory
+    dir = JTask::Helpers.set_directory(dir)
+
+    # Parse the file
     original_file = File.read(File.join(dir, filename))
     objects = JSON.parse(original_file)
 
@@ -25,7 +51,7 @@ module Get
       id = method
 
       if objects["#{id}"]
-        output = OpenStruct.new({ "id" => id.to_i }.merge(objects["#{id}"]))
+        output = JTask::Get.new({ "id" => id.to_i }.merge(objects["#{id}"]))
       else
         # id supplied doesn't exist
         raise NameError, "[JTask] The id #{method} could not be found in the file \"#{dir + filename}\"."
@@ -53,7 +79,7 @@ module Get
       # Loop through each required record and
       # assemble each key-value into the open structure output.
       # Map all openstructs to an array.
-      output = required_records.map { |id, record| OpenStruct.new({ "id" => id.to_i }.merge(record)) }
+      output = required_records.map { |id, record| JTask::Get.new({ "id" => id.to_i }.merge(record)) }
     end
 
     return output

data/lib/jtask/helpers.rb

@@ -0,0 +1,23 @@
+require "jtask/config"
+
+class JTask
+  module Helpers
+    def self.set_directory(custom_directory=nil)
+      # Check if user has specified a custom directory in the method
+      if custom_directory
+        # Yes, lets use it.
+        dir = custom_directory
+      else
+        # No, lets load the default directory.
+        dir = JTask.configuration.file_dir
+      end
+
+      # Panic if the directory doesn't exist. Literally.
+      unless File.directory?(dir)
+        raise RuntimeError, "[JTask] The directory '#{dir}' doesn't exist in your current location. Please create it or refer to the documentation on how to change your file path."
+      end
+
+      return dir
+    end
+  end
+end

data/lib/jtask/kill.rb

@@ -1,14 +1,18 @@
-module Kill
-  def kill(filename, dir=nil)
-    # Check if user has specified a custom directory.
-    unless dir
-      # If not, a default folder is assigned.
-      if File.directory?("models/")
-        dir = "models/"
-      else
-        raise RuntimeError, "[JTask] The directory 'models/' doesn't exist in your current location. Please create it or refer to the documentation on how to change your file path."
-      end
-    end
+# JTask.kill()
+# Completely removes the entire file specified from the system.
+# -----------------------------------------------------------------------------
+# Eg: JTask.kill("users.json.bak")
+# #=> true
+# -----------------------------------------------------------------------------
+# See wiki guide for more usage examples...
+# https://github.com/adammcarthur/jtask/wiki/JTask.kill()
+
+require "jtask/helpers"
+
+class JTask
+  def self.kill(filename, dir=nil)
+    # Set the directory
+    dir = JTask::Helpers.set_directory(dir)
 
     # Delete the file
     File.delete(File.join(dir, filename))

data/lib/jtask/rename.rb

@@ -1,17 +1,19 @@
-module Rename
-  def rename(filename, new, dir=nil)
-    # Check if user has specified a custom directory.
-    unless dir
-      # If not, a default folder is assigned.
-      if File.directory?("models/")
-        dir = "models/"
-      else
-        raise RuntimeError, "[JTask] The directory 'models/' doesn't exist in your current location. Please create it or refer to the documentation on how to change your file path."
-      end
-    end
+# JTask.rename()
+# Simply renames the file to something different.
+# ----------------------------------------------------------------------------------
+# Eg: JTask.rename("orders.json", "0r3erz.json")
+# #=> true
+# ----------------------------------------------------------------------------------
+# See wiki guide for more usage examples...
+# https://github.com/adammcarthur/jtask/wiki/JTask.rename()
+
+class JTask
+  def self.rename(filename, new_filename, dir=nil)
+    # Set the directory
+    dir = JTask::Helpers.set_directory(dir)
 
     # Rename the file
-    File.rename(File.join(dir, filename), File.join(dir, new))
+    File.rename(File.join(dir, filename), File.join(dir, new_filename))
 
     return true
   end

data/lib/jtask/save.rb

@@ -1,14 +1,20 @@
-module Save
-  def save(filename, parameters, dir=nil)
-    # Check if user has specified a custom directory.
-    unless dir
-      # If not, a default folder is assigned.
-      if File.directory?("models/")
-        dir = "models/"
-      else
-        raise RuntimeError, "[JTask] The directory 'models/' doesn't exist in your current location. Please create it or refer to the documentation on how to change your file path."
-      end
-    end
+# JTask.save()
+# Saves a hash of parameters to the requested file.
+# --------------------------------------------------------------------
+# Eg: JTask.save("hello.json", {fname: "Adam", lname: "McArthur"})
+# #=> true
+# --------------------------------------------------------------------
+# See wiki guide for more usage examples...
+# https://github.com/adammcarthur/jtask/wiki/JTask.save()
+
+require "json"
+require "jtask/helpers"
+
+class JTask
+  def self.save(filename, parameters, dir=nil)
+    # Set the directory
+    dir = JTask::Helpers.set_directory(dir)
+
     # Check if the file already exists
     unless File.exists?(File.join(dir, filename))
       # Create the file since it doesn’t exist, and setup up for JSON.

data/lib/jtask/update.rb

@@ -1,14 +1,21 @@
-module Update
-  def update(filename, id, parameters, dir=nil)
-    # Check if user has specified a custom directory.
-    unless dir
-      # If not, a default folder is assigned.
-      if File.directory?("models/")
-        dir = "models/"
-      else
-        raise RuntimeError, "[JTask] The directory 'models/' doesn't exist in your current location. Please create it or refer to the documentation on how to change your file path."
-      end
-    end
+# JTask.update()
+# Updates an existing JSON object with a new set of values.
+# ----------------------------------------------------------------------
+# Eg: JTask.update("clients.json", 4, new: "value")
+# #=> true
+# ----------------------------------------------------------------------
+# See wiki guide for more usage examples...
+# https://github.com/adammcarthur/jtask/wiki/JTask.update()
+
+require "json"
+require "jtask/helpers"
+
+class JTask
+  def self.update(filename, id, parameters, dir=nil)
+    # Set the directory
+    dir = JTask::Helpers.set_directory(dir)
+
+    # Parse the file
     original_file = File.read(File.join(dir, filename))
     objects = JSON.parse(original_file)
 

data/readme.md

@@ -5,14 +5,21 @@ JTask provides CRUD actions for storage of data in JSON format inside text files
 ``` ruby
 require "jtask"
 
-JTask.save("preferences", {background_color: "black", font_size: "medium"})
+JTask.save("preferences.json", {background_color: "black", font_size: "medium"})
 #=> true
 
-JTask.get("preferences", last: 1).font_size
+JTask.get("preferences.json", last: 1).font_size
 #=> "medium"
 ```
 
-The above example stores the settings in a file called `preferences` using JSON. We then get the last object saved to the file and output the value of the `"font_size"` key.
+The above example stores the settings in a file called `preferences.json`. We then get the last object saved to the file and output the value of the `"font_size"` key. JTask syntax is designed to be simple and elegant to use, making it easy to remember and enjoyable to work with. It even has it's own built in error handler:
+
+``` bash
+JTask.get("clients.json", 1600)
+#=> NameError: [JTask] The id 1600 could not be found in the file "models/clients.json".
+```
+
+The above error makes mention of an id number. As central to many CRUD frameworks, JTask operates around id numbers to manipulate the objects. JTask automatically calculates and assigns these sequential id numbers for you.
 
 **Example of JTask storage file:**
 
@@ -25,7 +32,7 @@ The above example stores the settings in a file called `preferences` using JSON.
 }
 ```
 
-JTask can even act as a management system for already exisiting json files. Please note that a few adjustments will need to be made to your files beforehand - check out the [JTask.convert()](https://github.com/adammcarthur/jtask/wiki/JTask.convert() "Configure existing json files for JTask") wiki guide for more information.
+JTask can even act as a management system for already exisiting json files. Please note that a few adjustments will need to be made to your files beforehand - check out the [JTask::Convert](https://github.com/adammcarthur/jtask/wiki/JTask::Convert "Configure existing json files for JTask") wiki guide for more information.
 
 ## Getting Started
 ``` bash
@@ -33,23 +40,26 @@ gem install jtask
 ```
 
 ``` ruby
-# Include the jtask library where necassary
 require "jtask"
 
 # Tell JTask where your files are [optional]
-jtask.settings do |s|
-  s.file_dir = "path/to/jtask_files"
+JTask.configure do |config|
+  config.file_dir = "path/to/jtask_files/"
 end
 ```
 
-### [JTask.save(filename, parameters, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.save() "View full guide")
+## Basic Documentation
+
+Below you will find a very broad overview of how to use the most common JTask methods. Make sure you [check out the wiki](https://github.com/adammcarthur/jtask/wiki) for the full documentation and implementation examples.
+
+#### [JTask.save(filename, parameters, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.save() "View full guide")
 *Saves a hash of parameters to the requested file.*
 
 ``` ruby
-JTask.save("foods", {entree: "cheese", main: "hamburger", desert: "cake"})
+JTask.save("foods.json", {entree: "cheese", main: "hamburger", desert: "cake"})
 ```
 
-You can use file extensions if you want (makes no difference), as well as set a custom directory for the file. The default directory JTask will look in is `/models`.
+Custom directories can be set each time (refer to below). The default directory JTask will look in is `/models`.
 
 ``` ruby
 JTask.save("users.json", {username: "adam", twitter: "@adammcarth"}, "files/")
@@ -61,19 +71,19 @@ Notes:
  - To prepare already existing files for JTask operations, they must only contain `{}` inside.
  - When setting a custom directory, ensure it ends with `/`.
 
-### [JTask.get(filename, method=nil, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.get() "View full guide")
+#### [JTask.get(filename, method=nil, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.get() "View full guide")
 *Retrieves stored JSON data from the file and returns an OpenStruct.*
 
 ``` ruby
-JTask.get("email_subscribers")
-#=> [ <OpenStruct "id"=1 "email"=>"gary@google.com">, <OpenStruct "id"=>2 "email"=>"blah"> ... ]
+JTask.get("email_subscribers.json")
+#=> [ <JTask::Get "id"=1 "email"=>"gary@google.com">, <JTask::Get "id"=>2 "email"=>"blah"> ... ]
 ```
 
 As seen above - calling JTask.get() without a method argument will return **all** the records stored. Let's now try and get the 50th email subscriber's email address:
 
 ``` ruby
-@subscriber = JTask.get("email_subscribers", 50)
-#=> <OpenStruct "id"="50" "email"="yukihiro@matsumoto.net">
+@subscriber = JTask.get("email_subscribers.json", 50)
+#=> <JTask::Get "id"="50" "email"="yukihiro@matsumoto.net">
 
 @subscriber.email
 #=> "yukihiro@matsumoto.net"
@@ -82,80 +92,48 @@ As seen above - calling JTask.get() without a method argument will return **all*
 JTask also comes with a few retrieval methods similar to Active Record. Let's get the **first and last** `n` email subscribers:
 
 ``` ruby
-JTask.get("email_subscribers", first: 25)
-#=> [ <OpenStruct "id"=1>, <OpenStruct "id"=2>, ..., <OpenStruct "id"=25> ]
+JTask.get("email_subscribers.json", first: 25)
+#=> [ <JTask::Get "id"=1>, <JTask::Get "id"=2>, ..., <JTask::Get "id"=25> ]
 
-JTask.get("email_subscribers", last: 1)
-#=> <OpenStruct "id"=365 "email"="goo@goo.gl">
+JTask.get("email_subscribers.json", last: 1)
+#=> <JTask::Get "id"=365 "email"="goo@goo.gl">
 ```
 
-### [JTask.update(filename, id, parameters, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.update() "View full guide")
-*Updates the `id` json object with a new set of parameters.*
+#### [JTask.update(filename, id, parameters, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.update() "View full guide")
+*Updates an existing JSON object with a new set of values.*
 
 ``` ruby
-JTask.update("ui_settings", 42, {show_ads: "no", background: "grey"})
+JTask.update("ui_settings.json", 42, {show_ads: "no", background: "grey"})
 ```
 
 JTask upgrades records gracefully - parameters already existing inside the JSON object will be replaced with the new value, whereas new parameters will be added.
 
 ``` ruby
 # Original Version
-<OpenStruct "id"=42 "show_ads"="yes">
+<JTask::Get "id"=42 "show_ads"="yes">
 
 # Updated Version
-<OpenStruct "id"=42 "show_ads"="no" "background"="grey">
+<JTask::Get "id"=42 "show_ads"="no" "background"="grey">
 ```
 
 To completely remove parameters (the entire key-value pair) from objects, refer to the JTask.chop() method below.
 
-### [JTask.destroy(filename, id, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.destroy() "View full guide")
+#### [JTask.destroy(filename, id, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.destroy() "View full guide")
 *Removes an entire object from the file.*
 
-``` ruby
-JTask.destroy("twitter_names", 15)
-```
-
-### [JTask.chop(filename, id, paramter, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.chop() "View full guide")
-*Removes an entire key-value pair (or parameter) from one or all of the file's objects.*
-
-``` ruby
-JTask.chop("users", 4, "session_data")
-
-JTask.chop("users", :all, "session_data")
-```
+#### [JTask.chop(filename, id, paramter, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.chop() "View full guide")
+*Removes an entire key-value pair from one or all of the file's objects.*
 
-Impact:
-
-``` ruby
-# Old Version
-<OpenStruct "id"=4 "user_id"="p18573" "session_data"="34F3jkdf9azfvVak2">
-
-# New Version
-<OpenStruct "id"=4 "user_id"="p18573">
-```
-
-The second example uses `:all` instead of an id. This would perform the same operation, but to all objects inside the target file (instead of a specific id). [Make sure you read the Chop wiki page](https://github.com/adammcarthur/jtask/wiki/JTask.chop()) to learn more.
-
-### [JTask.rename(filename, new, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.rename() "View full guide")
+#### [JTask.rename(filename, new, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.rename() "View full guide")
 *Simply renames the file to something different.*
 
-``` ruby
-JTask.rename("orders", "online_orders")
-```
-
-### [JTask.kill(filename, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.kill() "View full guide")
+#### [JTask.kill(filename, dir=nil)](https://github.com/adammcarthur/jtask/wiki/JTask.kill() "View full guide")
 *Completely removes the entire file specified from the system.*
 
-``` ruby
-# Proceed with caution, the will delete the entire
-# file and it cannot be recovered.
-JTask.kill("not_needed_anymore.json")
-```
-
 ## Share your ideas and contribute
 
 I'd love to here what you plan to use JTask for. [Let me know via twitter](https://twitter.com/adammcarth), or email your thoughts and ideas to [adam@adammcarthur.net](mailto:adam@adammcarthur.net).
 
-To contribute to the project, fork it, send a pull request and I'll review your changes. Check out the `todo.txt` list to see what still needs to be done.
+To contribute to the project, fork it, send a pull request and I'll review your changes. Check out the [enhancement suggestions page](https://github.com/adammcarthur/jtask/issues?labels=enhancement) to see what still needs to be done.
 
 \- Adam

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jtask
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Adam McArthur
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-01 00:00:00.000000000 Z
+date: 2014-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -35,8 +35,11 @@ files:
 - jtask.gemspec
 - lib/jtask.rb
 - lib/jtask/chop.rb
+- lib/jtask/config.rb
+- lib/jtask/convert.rb
 - lib/jtask/destroy.rb
 - lib/jtask/get.rb
+- lib/jtask/helpers.rb
 - lib/jtask/kill.rb
 - lib/jtask/rename.rb
 - lib/jtask/save.rb
@@ -52,7 +55,7 @@ post_install_message: |2-
 
   Thanks for installing JTask Beta. Check out the full documentation and contribute at https://github.com/adammcarthur/jtask
 
-  In this release (v0.2.0 Beta): JTask now outputs OpenStructs instead of Hashes. Read more about this update here: https://github.com/adammcarthur/jtask/issues/2
+  In this release (v0.3.0 Beta): https://github.com/adammcarthur/jtask/releases/tag/v0.3.0
 
   - Adam (@adammcarth)
   -