homesteading 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
---- 
-SHA1: 
-  metadata.gz: b3b22c0ade1dd6e771d68b7f006e5e564a534ff7
-  data.tar.gz: f796eecb84f2d3da35a2a00e2524b8ffdbb93152
-SHA512: 
-  metadata.gz: 31756b33ce51e8aad34121c71431460c901b8a4140e757f7ba0fd45210c15b7da8d3dc6741cdc8b9890ce6ff2035afcbd2caa691bdf1604d91007da870bbdd5c
-  data.tar.gz: cc1d2b5ff38658d4d87cd64e5a2db24178375fd1628b34f2314eb1ffadab0ba252a906ad768ac9e33c0cc91bf665c8b5699f991390f03e02b8fafd6a93ce8a39
+---
+SHA1:
+  metadata.gz: 65f34332df0b79a0f22c7438f17888604bc7cb57
+  data.tar.gz: 04017f8c42ebad38c3532ffb562bb542bba5597d
+SHA512:
+  metadata.gz: 43515816ff0a39ccafda8571eb58bcac0a12eaafd09c5430026ba88115ca05840e3663ccbebcf1355c8ca7fcf41307e8428b3cd88fce358bd952b3695d796c21
+  data.tar.gz: a4589c83df3712043f78ff89c843fb1381926a447542d42fe74e663c05b0443eeb932da1938b5999444b33afee81b3712022c9c360c3f4bb07441b831e7e6b77

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.DS_Store
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in homesteading.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,17 @@
+PATH
+  remote: .
+  specs:
+    homesteading (0.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    rake (10.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.7)
+  homesteading!
+  rake (~> 10.0)

data/LICENSE.md

@@ -0,0 +1,9 @@
+**PUBLIC DOMAIN**
+
+Your heart is as free as the air you breathe. <br>
+The ground you stand on is liberated territory.
+
+In legal text, Homesteading is dedicated to the public domain
+using Creative Commons -- CC0 1.0 Universal.
+
+[http://creativecommons.org/publicdomain/zero/1.0](http://creativecommons.org/publicdomain/zero/1.0 "Creative Commons &mdash; CC0 1.0 Universal")

data/README.md

@@ -5,7 +5,9 @@ https://github.com/homesteading/homesteading
 
 ## Description
 
-A personal publishing platform.
+The Homesteading CLI is used to manage Homesteading apps from the command line.
+
+See the [/help](https://github.com/homesteading/homesteading/tree/master/help) directory for more.
 
 
 ## Current Version
@@ -17,23 +19,32 @@ A personal publishing platform.
 
 - [ruby](http://www.ruby-lang.org/en/ "Ruby Programming Language")
 - [rubygems](https://rubygems.org)
+- [bundler](http://bundler.io)
 - [rake](https://github.com/jimweirich/rake)
 
 
 ## Installation
 
-    gem install homesteading
+```ruby
+gem install homesteading
+```
 
 
 ## Usage
 
+**TODO**
+
 Currently, only one command:
 
-    homesteading
+```bash
+homesteading
+```
 
 You can alias `homesteading` to `hs` for shorter commands.
 
-    alias hs="homesteading"
+```bash
+alias hs="homesteading"
+```
 
 
 ## Authors
@@ -44,15 +55,13 @@ You can alias `homesteading` to `hs` for shorter commands.
 ## Contributions
 
 1. Fork it
-2. Get it running (see below)
-3. Create your feature branch (`git checkout -b my-new-feature`)
-4. Write your code and **specs**
-5. Commit your changes (`git commit -am 'Add some feature'`)
-6. Push to the branch (`git push origin my-new-feature`)
-7. Create new Pull Request
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
 
 If you find bugs, have feature requests or questions, please
-[file an issue](https://github.com/homesteading/homesteading-tasks/issues).
+[file an issue](https://github.com/homesteading/homesteading/issues).
 
 
 ## License
@@ -62,7 +71,7 @@ If you find bugs, have feature requests or questions, please
 Your heart is as free as the air you breathe. <br>
 The ground you stand on is liberated territory.
 
-In legal text, Homesteading Tasks is dedicated to the public domain
+In legal text, Homesteading is dedicated to the public domain
 using Creative Commons -- CC0 1.0 Universal.
 
 [http://creativecommons.org/publicdomain/zero/1.0](http://creativecommons.org/publicdomain/zero/1.0 "Creative Commons &mdash; CC0 1.0 Universal")

data/Rakefile

@@ -1,9 +1,2 @@
-require "rubygems"
-require "hoe"
+require "bundler/gem_tasks"
 
-Hoe.spec "homesteading" do
-  developer("Shane Becker", "veganstraightedge@gmail.com")
-
-  self.history_file = "History.md"
-  self.readme_file  = "README.md"
-end

data/bin/homesteading

@@ -1,3 +1,30 @@
 #!/usr/bin/env ruby
+require "homesteading/commands/help"
 
-puts "Homesteading..."
+if ARGV.empty?
+  name_space = "Help"
+  task       = "default"
+  Homesteading::Help.print("blank")
+else
+  # special case for `hs -v` alias for `hs version`
+  if ARGV.first.match(/^\s*-[vV]\s*$/)
+    name_space = "Version"
+    task       = "default"
+  else
+    name_spaced_task = ARGV.shift.match(/^(\w+)(:*)(\w*)$/)
+    name_space       = name_spaced_task[1].capitalize
+
+    if name_spaced_task[2] == ":"
+      task = name_spaced_task[3]
+    else
+      task = "default"
+    end
+  end
+end
+
+require "homesteading/commands/#{name_space.downcase}"
+if ARGV.empty?
+  Homesteading.const_get(name_space).send(task.to_sym)
+else
+  Homesteading.const_get(name_space).send(task.to_sym, ARGV)
+end

data/help/README.md

@@ -0,0 +1,14 @@
+Usage: homesteading COMMAND [--app APP] [command-specific-options]
+
+Primary help topics, type "homesteading help TOPIC" for more details:
+
+  * new      :  create a new constellation of homesteading apps
+  * apps     :  manage constellation of apps (create, destroy, list, update)
+  * run      :  run one-off commands (console, rake)
+  * server   :  run constellation of apps (start, stop)
+
+Additional help topics:
+
+  * help     :  list commands and display help
+  * version  :  display version
+  * update   :  update constellation of apps or this homesteading client

data/help/apps-create.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading apps:create

data/help/apps-destroy.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading apps:destroy

data/help/apps-info.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading apps:info

data/help/apps-rename.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading apps:rename

data/help/apps.md

@@ -0,0 +1,28 @@
+Usage: homesteading apps
+
+  list your installed homesteading apps
+
+  * -n, --nonpublisher  : list running homesteading non-publisher apps (hub, router, etc)
+  * -p, --publisher     : list running homesteading publisher apps (note, photo, etc)
+
+Example:
+
+    $ homesteading apps
+    === Publisher Apps
+    article
+    note
+    photo
+    video
+
+    === Non-Publisher Apps
+    hub
+    router
+    syndicator
+
+Additional commands, type "homesteading help COMMAND" for more details:
+
+* apps:create --type HS_APP      :  create a new app from @homesteading on GitHub
+* apps:create --url URL          :  create a new app from a URL
+* apps:destroy --app APP         :  permanently destroy an app
+* apps:info --app APP            :  show detailed app information (from app.json)
+* apps:rename NEWNAME --app APP  :  rename the app

data/help/blank.md

@@ -0,0 +1,7 @@
+Creating a new Homesteading constellation?
+
+    homesteading help new
+
+Starting up an existing Homesteading constellation?
+
+    homesteading help server

data/help/new.md

@@ -0,0 +1,29 @@
+# TODO:
+
+Usage: homesteading new /path/to/constellation [options]
+
+  create a constellation of homesteading apps
+
+Example:
+
+    $ homesteading new sbbme
+
+
+
+---
+
+TODO
+
+  -t, --type APP_NAME_FROM_GITHUB
+  -u, --url URL_OF_HS_APP
+  -e, --except APPS_TO_SKIP
+  -o, --only APPS_TO_CREATE
+
+  -f, [--force]    #  Overwrite apps that already exist
+  -p, [--pretend]  #  Run but do not make any changes
+  -q, [--quiet]    #  Suppress status output
+  -s, [--skip]     #  Skip apps that already exist
+
+Example:
+
+    homesteading new --app note

data/help/run.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading run

data/help/server-list.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading server:list

data/help/server-nonpublisher.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading server:nonpublisher

data/help/server-publisher.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading server:publisher

data/help/server-stop.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading server:stop

data/help/server-urls.md

@@ -0,0 +1,3 @@
+# TODO:
+
+Usage: homesteading server:urls

data/help/server.md

@@ -0,0 +1,27 @@
+Usage: homesteading server
+
+  start a server for constellation of homesteading apps
+
+  * -p, --port  # run homesteading site on a specific port (default: 3000)
+
+Example:
+
+    $ homesteading server
+    Homesteading starting...
+
+    * Homesteading: 1.0.1, codename: Rooftop
+    * Puma: 2.10.2 (ruby 2.1.5-p273), codename: Robots on Comets
+    * Ruby: 2.1.5p273 (2014-11-13 revision 48405) [x86_64-darwin14.0]
+    * Environment: development
+    * Running on: http://0.0.0.0:3000
+
+    Use Ctrl-C to stop
+
+
+Additional commands, type "homesteading help COMMAND" for more details:
+
+* server:list              #  list the currently running homesteading apps
+* server:nonpublisher      #  start a only non-publisher apps
+* server:publisher         #  start a only publisher apps
+* server:stop [--app APP]  #  stop a constellation or a specific app
+* server:urls [--app APP]  #  list the urls of running apps

data/help/update-nonpublisher.md

@@ -0,0 +1,2 @@
+# TODO:
+

data/help/update-publisher.md

@@ -0,0 +1,2 @@
+# TODO:
+

data/help/update-system.md

@@ -0,0 +1,18 @@
+Usage: homesteading update:system
+
+  update the homesteading client
+
+Example:
+
+    $ homesteading update:system
+    Updating... done, 1.0.0 updated to 1.0.3
+
+
+Usage: homesteading update:system --beta
+
+  update to the latest beta client
+
+Example:
+
+    $ homesteading update:system --beta
+    Updating... done, v2.3.1 updated to v2.3.4.pre

data/help/update.md

@@ -0,0 +1,27 @@
+Usage: homesteading update
+
+  update a constellation of homesteading apps
+
+Example:
+
+    $ homesteading update
+    Updating article... done.
+    Updating bookmark... done.
+    Updating event... done.
+    Updating feed... done.
+    Updating hub... done.
+    Updating note... done.
+    Updating photo... done.
+    Updating router... done.
+    Updating sound... done.
+    Updating syndicator... done.
+    Updating video... done.
+    Updating walk... done.
+    Updating weight... done.
+
+
+Additional commands, type "homesteading help COMMAND" for more details:
+
+* update:nonpublisher  :  update only non-publisher apps
+* update:publisher     :  update only publisher apps
+* update:system        :  update the homesteading client

data/help/version.md

@@ -0,0 +1,9 @@
+Usage: homesteading version
+       homesteading -v
+
+  show homesteading client version
+
+Example:
+
+    $ homesteading version
+    Homesteading 1.0.1, codename: Rooftop

data/homesteading.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "homesteading/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "homesteading"
+  spec.version       = Homesteading::VERSION
+  spec.authors       = ["Shane Becker"]
+  spec.email         = ["veganstraightedge@gmail.com"]
+  spec.summary       = "Client library and command-line tool to deploy and manage Homesteading apps"
+  spec.description   = ""
+  spec.homepage      = "http://homesteading.io"
+  spec.license       = "Public Domain, CC0"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake",    "~> 10.4"
+end

data/lib/homesteading.rb

@@ -1,3 +1,4 @@
-class Homesteading
-  VERSION = '0.0.1'
+require "homesteading/version"
+
+module Homesteading
 end

data/lib/homesteading/commands/apps.rb

@@ -0,0 +1,22 @@
+class Homesteading
+  class Apps
+    class << self
+
+      def default(options=nil)
+      end
+
+      def create(options=nil)
+      end
+
+      def destroy(options=nil)
+      end
+
+      def info(options=nil)
+      end
+
+      def rename(options=nil)
+      end
+
+    end
+  end
+end

data/lib/homesteading/commands/help.rb

@@ -0,0 +1,37 @@
+class Homesteading
+  class Help
+    class << self
+      DEFAULT_HELP_DOC = "README"
+
+      def default(options=nil)
+        if options.nil?
+          help_doc_path = DEFAULT_HELP_DOC
+        elsif options.first.match(/:/)
+          first, last   = options.first.split(":")
+          help_doc_path = first + "-" + last
+        else
+          help_doc_path = options.first
+        end
+
+        print(help_doc_path)
+      end
+
+      def print(path)
+        # TODO better way?
+        help_dir = File.expand_path("../../../../help/", __FILE__)
+        file     = "#{help_dir}/#{path}.md"
+
+        puts
+        unless File.exist?(file)
+          file = "#{help_dir}/#{DEFAULT_HELP_DOC}.md"
+          puts "Unknown command. No help docs about that."
+          puts
+        end
+
+        puts File.read(file)
+        puts
+      end
+
+    end
+  end
+end

data/lib/homesteading/commands/new.rb

@@ -0,0 +1,18 @@
+class Homesteading
+  class New
+    class << self
+      PUBLISHER_APPS    = ["article", "bookmark", "event", "note", "photo", "sound", "video", "walk", "weight"]
+      NONPUBLISHER_APPS = ["hub", "router-rack"] # TODO "syndicator"
+
+      def default(options=nil)
+        constellation_dir = options.first
+        system("mkdir -p #{constellation_dir}")
+
+        [NONPUBLISHER_APPS, PUBLISHER_APPS].flatten.each do |app|
+          system("cd #{constellation_dir} && git clone git@github.com:homesteading/homesteading-#{app}.git")
+        end
+      end
+
+    end
+  end
+end

data/lib/homesteading/commands/run.rb

@@ -0,0 +1,10 @@
+class Homesteading
+  class Run
+    class << self
+
+      def default(options=nil)
+      end
+
+    end
+  end
+end

data/lib/homesteading/commands/server.rb

@@ -0,0 +1,25 @@
+class Homesteading
+  class Server
+    class << self
+
+      def default(options=nil)
+      end
+
+      def list(options=nil)
+      end
+
+      def nonpublisher(options=nil)
+      end
+
+      def publisher(options=nil)
+      end
+
+      def stop(options=nil)
+      end
+
+      def urls(options=nil)
+      end
+
+    end
+  end
+end

data/lib/homesteading/commands/update.rb

@@ -0,0 +1,18 @@
+class Homesteading
+  class Update
+    class << self
+
+      def default(options=nil)
+      end
+
+      def nonpublisher(options=nil)
+      end
+
+      def publisher(options=nil)
+      end
+
+      def system(options=nil)
+      end
+    end
+  end
+end

data/lib/homesteading/commands/version.rb

@@ -0,0 +1,13 @@
+class Homesteading
+  class Version
+    class << self
+
+      def default(options=nil)
+        # TODO load in *actual* VERSION and CODENAME from homesteading/version
+        # puts "Homesteading #{Homesteading::VERSION}, codename: #{Homesteading::CODENAME}"
+        puts "Homesteading 0.0.1, codename: Rooftop"
+      end
+
+    end
+  end
+end

data/lib/homesteading/version.rb

@@ -0,0 +1,4 @@
+module Homesteading
+  VERSION  = "0.0.2"
+  CODENAME = "Rooftop"
+end

metadata

@@ -1,80 +1,110 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: homesteading
-version: !ruby/object:Gem::Version 
-  version: 0.0.1
+version: !ruby/object:Gem::Version
+  version: 0.0.2
 platform: ruby
-authors: 
+authors:
 - Shane Becker
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-03-30 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rdoc
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        version: "3.10"
+date: 2014-12-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
   type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: hoe
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        version: "3.5"
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
   type: :development
-  version_requirements: *id002
-description: A personal publishing platform.
-email: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+description: ''
+email:
 - veganstraightedge@gmail.com
-executables: 
+executables:
 - homesteading
 extensions: []
-
-extra_rdoc_files: 
-- Manifest.txt
-files: 
-- History.md
-- Manifest.txt
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE.md
 - README.md
 - Rakefile
 - bin/homesteading
+- help/README.md
+- help/apps-create.md
+- help/apps-destroy.md
+- help/apps-info.md
+- help/apps-rename.md
+- help/apps.md
+- help/blank.md
+- help/new.md
+- help/run.md
+- help/server-list.md
+- help/server-nonpublisher.md
+- help/server-publisher.md
+- help/server-stop.md
+- help/server-urls.md
+- help/server.md
+- help/update-nonpublisher.md
+- help/update-publisher.md
+- help/update-system.md
+- help/update.md
+- help/version.md
+- homesteading.gemspec
 - lib/homesteading.rb
-- test/test_homesteading.rb
-- .gemtest
-homepage: https://github.com/homesteading/homesteading
-licenses: []
-
+- lib/homesteading/commands/apps.rb
+- lib/homesteading/commands/help.rb
+- lib/homesteading/commands/new.rb
+- lib/homesteading/commands/run.rb
+- lib/homesteading/commands/server.rb
+- lib/homesteading/commands/update.rb
+- lib/homesteading/commands/version.rb
+- lib/homesteading/version.rb
+homepage: http://homesteading.io
+licenses:
+- Public Domain, CC0
 metadata: {}
-
 post_install_message: 
-rdoc_options: 
-- --main
-- README.md
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - &id003 
-    - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - *id003
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: homesteading
-rubygems_version: 2.0.3
+rubyforge_project: 
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: A personal publishing platform.
-test_files: 
-- test/test_homesteading.rb
+summary: Client library and command-line tool to deploy and manage Homesteading apps
+test_files: []

data/History.md

@@ -1,6 +0,0 @@
-# 0.0.1 / 2013-03-29
-
-* 1 major enhancement
-
-  * Birthday!
-  * Just claiming the namespace

data/Manifest.txt

@@ -1,7 +0,0 @@
-History.md
-Manifest.txt
-README.md
-Rakefile
-bin/homesteading
-lib/homesteading.rb
-test/test_homesteading.rb

data/test/test_homesteading.rb

@@ -1,8 +0,0 @@
-require "test/unit"
-require "homesteading"
-
-class TestHomesteading < Test::Unit::TestCase
-  def test_sanity
-    puts "Hi!"
-  end
-end