sly 0.0.1

data/README.rdoc

@@ -0,0 +1,6 @@
+= sly
+
+Describe your project here
+
+:include:sly.rdoc
+

data/bin/sly

@@ -0,0 +1,125 @@
+#!/usr/bin/env ruby
+require 'gli'
+require 'sly'
+begin # XXX: Remove this begin/rescue before distributing your app
+rescue LoadError
+  STDERR.puts "In development, you need to use `bundle exec bin/todo` to run your app"
+  STDERR.puts "At install-time, RubyGems will make sure lib, etc. are in the load path"
+  STDERR.puts "Feel free to remove this message from bin/sly now"
+  exit 64
+end
+
+include GLI::App
+
+program_desc 'Sly - A Sprint.ly Command Line Interface'
+
+version Sly::VERSION
+
+desc 'creates a .slyrc file in your home folder; used by Sprint.ly CLI for authenticating your requests.'
+skips_pre
+command :install do |c|
+  c.action do |global_options,options,args|
+    puts "Please enter your Sprint.ly username (email):"
+    username = gets
+    puts "Please enter your Sprint.ly API key:"
+    api_key = gets
+    Sly::Installer.process(username.strip, api_key.strip)
+  end
+end
+
+desc 'setup the current folder to be associated with a Sprint.ly project.'
+command :setup do |c|
+  c.action do |global_options,options,args|
+    manager =  Sly::ProjectManager.new
+    $stdout.write "Please write the ID of the project to be associated with this folder:\n"
+    $stdout.write manager.project_listings
+    $stdout.write "\ni.e: 1234"
+    $stdout.write "\n====================================\n"
+
+    Sly::GUI.get_project_id(manager)
+  end
+end
+
+desc 'shows an overview of the current state of the project from backlog to complete.'
+command :dashboard do |c|
+  c.action do |global_options,options,args|
+    project = Sly::Project.load(File.join(".sly", "project"))
+    project.update
+    Sly::GUI.display_dashboard(project)
+  end
+end
+
+desc 'shows the current backlog for the project.'
+command :backlog do |c|
+  c.action do |global_options,options,args|
+    project = Sly::Project.load(File.join(".sly", "project"))
+    project.update
+    Sly::GUI.display_backlog(project)
+  end
+end
+
+desc 'shows the current in-progress for the project.'
+command :current do |c|
+  c.action do |global_options,options,args|
+    project = Sly::Project.load(File.join(".sly", "project"))
+    project.update
+    Sly::GUI.display_current(project)
+  end
+end
+
+desc 'shows the current completed items for the project.'
+command :complete do |c|
+  c.action do |global_options,options,args|
+    project = Sly::Project.load(File.join(".sly", "project"))
+    project.update
+    Sly::GUI.display_complete(project)
+  end
+end
+
+desc 'Describe new here'
+arg_name 'Describe arguments to new here'
+command :new do |c|
+  c.action do |global_options,options,args|
+    puts "new command ran"
+  end
+end
+
+desc 'Describe move here'
+arg_name 'Describe arguments to move here'
+command :move do |c|
+  c.action do |global_options,options,args|
+    puts "move command ran"
+  end
+end
+
+desc 'Describe comment here'
+arg_name 'Describe arguments to comment here'
+command :comment do |c|
+  c.action do |global_options,options,args|
+    puts "comment command ran"
+  end
+end
+
+pre do |global,command,options,args|
+  # Pre logic here
+  # Return true to proceed; false to abourt and not call the
+  # chosen command
+  # Use skips_pre before a command to skip this block
+  # on that command only
+  Sly::Installer.validate_install!
+  true
+end
+
+post do |global,command,options,args|
+  # Post logic here
+  # Use skips_post before a command to skip this
+  # block on that command only
+end
+
+on_error do |exception|
+  # Error logic here
+  # return false to skip default error handling
+  true
+end
+
+exit run(ARGV)

data/lib/sly.rb

@@ -0,0 +1,10 @@
+require 'sly/version.rb'
+require 'sly/gui.rb'
+require 'sly/connector.rb'
+require 'sly/installer.rb'
+require 'sly/project_manager.rb'
+require 'sly/project.rb'
+require 'sly/item.rb'
+
+# Add requires for other files you add to your project here, so
+# you just need to require this one file in your bin file

data/lib/sly/connector.rb

@@ -0,0 +1,66 @@
+require 'curb'
+require 'json'
+
+class Sly::Connector
+
+  attr :api
+
+  def self.connect_with_defaults
+    return self.new(default_details)
+  end
+
+  def initialize(user_details = {}, api_url = "https://sprint.ly/api")
+    @api_url = api_url
+    @user_details = user_details
+  end
+
+  def authenticate!
+    request = authenticated_request("https://sprint.ly/api/products.json")
+    request.perform
+    JSON(request.body_str)
+  end
+
+  def products
+    request = authenticated_request(@api_url+"/products.json")
+    perform_and_capture_response(request)
+  end
+
+  def product_overview(id)
+    request = authenticated_request(@api_url+"/products/#{id}.json")
+    perform_and_capture_response(request)
+  end
+
+  def items_for_product(id)
+    request = authenticated_request(@api_url+"/products/#{id}/items.json")
+    perform_and_capture_response(request)
+  end
+
+  private
+
+  def authenticated_request(url)
+    request = Curl::Easy.new(url)
+    request.http_auth_types = :basic
+    request.username = @user_details[:email]
+    request.password = @user_details[:api_key]
+    request
+  end
+
+  def perform_and_capture_response(request)
+    request.perform
+    JSON(request.body_str)
+  end
+
+  private
+
+  def self.default_details
+    details_file = File.join(ENV["HOME"], ".slyrc")
+    if File.exists?(details_file)
+      details = File.read(details_file)
+      email, api_key = details.split(":").map(&:strip)
+      return { email: email, api_key: api_key }
+    else
+      raise "Could not locate installation file at #{details_file}"
+    end
+  end
+
+end

data/lib/sly/gui.rb

@@ -0,0 +1,42 @@
+class Sly::GUI
+  def self.get_project_id(manager)
+    project_id = gets
+    begin
+      manager.setup_project(Dir.pwd, project_id)
+    rescue Exception => e
+      $stderr.write e.to_s+"\n"
+      get_project_id(manager)
+    end
+  end
+
+  def self.display_dashboard(project)
+    #table_columns = [{Backlog: project.backlog},
+    #                 {Current: project.current},
+    #                 {Complete: project.complete}]
+    #table_columns.each do |hash|
+    #  hash.each do |k,v|
+    #    p v.map(&:overview)
+    #  end
+    #end
+  end
+
+  def self.display_backlog(project)
+    self.display_items("Backlog", project.backlog)
+  end
+
+  def self.display_current(project)
+    self.display_items("Current", project.current)
+  end
+
+  def self.display_complete(project)
+    self.display_items("Completed", project.complete)
+  end
+
+  private
+
+  def self.display_items(title, items)
+    STDOUT.print "  ---------------- #{title} ----------------  \n"
+    items.map(&:print)
+    STDOUT.print "\n"
+  end
+end

data/lib/sly/installer.rb

@@ -0,0 +1,33 @@
+require 'sly'
+
+class Sly::Installer
+
+  def self.process(username, password)
+    connector = Sly::Connector.new({email: username, api_key: password})
+    results = connector.authenticate!
+
+    if success_call?(results)
+      create_file(username, password)
+      STDOUT.write "Thanks! Your details are currently stored in ~/.slyrc to authorise your interactions using the Sprint.ly CLI\n"
+    else
+      raise "The details provided were incorrect, please check your details and try again."
+    end
+  end
+
+  def self.validate_install!
+    unless File.exist?(ENV["HOME"]+"/.slyrc")
+      raise "You have not setup Sly on your machine yet, please run the sly install command first."
+    end
+  end
+
+  private
+
+  def self.create_file(username, password)
+    file = File.open(ENV["HOME"]+"/.slyrc", "w") { |file| file.puts(username+":"+password) }
+  end
+
+  def self.success_call?(input)
+    return true if input.class == Array
+  end
+
+end

data/lib/sly/item.rb

@@ -0,0 +1,28 @@
+class Sly::Item
+
+  attr_accessor :number, :archived, :title, :score, :tags, :status
+
+  def initialize(item_attributes = {})
+    @number   = item_attributes["number"]
+    @archived = item_attributes["archived"]
+    @title    = item_attributes["title"]
+    @score    = item_attributes["score"]
+    @tags     = item_attributes["tags"]
+    @status   = item_attributes["status"]
+  end
+
+  def overview
+    self.prettify([@title, @number].join("\n#"), 44)+"\n"
+  end
+
+  alias_method :to_s, :overview
+
+  def print
+    STDOUT.print self.overview
+  end
+
+  def prettify(content, wrap_limit)
+    content.scan(/\S.{0,#{wrap_limit}}\S(?=\s|$)|\S+/).join("\n")
+  end
+
+end

data/lib/sly/project.rb

@@ -0,0 +1,63 @@
+require 'sly'
+require "yaml"
+require 'fileutils'
+
+class Sly::Project
+  include FileUtils
+
+  attr_accessor :id, :name, :archived, :admin, :items
+
+  def initialize(project_attributes = {})
+    @id = project_attributes["id"]
+    @name = project_attributes["name"]
+    @archived = project_attributes["archived"]
+    @admin = project_attributes["admin"]
+    @items = []
+  end
+
+  def save!
+    # Reserved for updating the API
+  end
+
+  def to_s
+    return "#{@id} - #{@name}"
+  end
+
+  def self.load(file)
+    begin
+      YAML::load(File.open(file))
+    rescue Exception => e
+      raise "Unable to locate project file #{file}"
+    end
+  end
+
+  def update
+    download_child_items
+    save_child_items
+  end
+
+  def backlog
+    @items.select { |item| item.status == "backlog" }
+  end
+
+  def current
+    @items.select { |item| item.status == "in-progress" }
+  end
+
+  def complete
+    @items.select { |item| item.status == "complete" }
+  end
+
+  private
+
+  def download_child_items
+    items = Sly::Connector.connect_with_defaults.items_for_product(@id)
+    items.each { |item| @items << Sly::Item.new(item) }
+  end
+
+  def save_child_items
+    target_file = File.join(pwd, '.sly', 'items')
+    File.open(target_file, 'w') { |file| file.write @items.to_yaml }
+  end
+
+end

data/lib/sly/project_manager.rb

@@ -0,0 +1,38 @@
+require 'fileutils'
+require 'yaml'
+
+class Sly::ProjectManager
+  include FileUtils
+
+  attr_reader :available_projects
+  attr :connector
+  attr :projects_json
+
+  def initialize
+    @connector = Sly::Connector.connect_with_defaults
+    @projects_json = @connector.products
+    @available_projects = []
+    @projects_json.each do |project_json|
+      @available_projects << Sly::Project.new(project_json)
+    end
+  end
+
+  def project_listings
+    return @available_projects.map(&:to_s).join("\n")
+  end
+
+  def setup_project(directory, project_id)
+    target_directory = File.join(directory, ".sly")
+    target_file = File.join(target_directory, "project")
+    mkdir_p target_directory
+    touch target_file
+    selected_project = @available_projects.select { |project| project.id == project_id.to_i }.first
+    if selected_project
+      File.open(target_file, 'w') { |file| file.write selected_project.to_yaml }
+      $stdout.write "Thanks! That's Sly all setup for the current project, run `sly help` to see the commands available.\n"
+    else
+      raise "That ID does not match any of the projects available; please try again:"
+    end
+  end
+
+end

data/lib/sly/version.rb

@@ -0,0 +1,3 @@
+module Sly
+  VERSION = '0.0.1'
+end

data/sly.rdoc

@@ -0,0 +1,5 @@
+= sly
+
+Generate this with
+    sly rdoc
+After you have described your command line interface

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification
+name: sly
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Robert White
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: curb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+description: 
+email: robert@terracoding.com
+executables:
+- sly
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+- sly.rdoc
+files:
+- bin/sly
+- lib/sly/version.rb
+- lib/sly.rb
+- lib/sly/connector.rb
+- lib/sly/gui.rb
+- lib/sly/installer.rb
+- lib/sly/item.rb
+- lib/sly/project.rb
+- lib/sly/project_manager.rb
+- README.rdoc
+- sly.rdoc
+homepage: http://tallguyrob.com
+licenses: []
+post_install_message: 
+rdoc_options:
+- --title
+- sly
+- --main
+- README.rdoc
+- -ri
+require_paths:
+- lib
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A small set of tools for working with Sprint.ly without leaving the command
+  line.
+test_files: []