explorer 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 92c4c5434dfa27aea21de62e797f79e5634aee95
-  data.tar.gz: 332c6ce3352491289eaf6c3199f599e9216395b8
+  metadata.gz: 6868f036ef96d91102731a1f805024563e7a8e84
+  data.tar.gz: 2072dfb48e958eb3800b0a3179e82af2c53d6153
 SHA512:
-  metadata.gz: d574b77ff7efdb07ba7821823fc1c96152459812a9c0f4ef111bc9ffa1b1c9eb5d6c0b6a342220f05a82824d51a0390f4346cf4a12a4e5e179f07d33cf23cdf1
-  data.tar.gz: 98d3806a19b602d463d44cbe8652194664b84923bf0b1220ab3378837230131ceea14e7dac30645547730e294237db04a2201950960f400ccf34c45a2656cc09
+  metadata.gz: ce3d4c72345746c75b82294c9e860bdc4bc89436991d79c32bac09778198e7da978699d098c38eaaecee66854a2b244e310fe83e52e22768d0ad0c63aaea544f
+  data.tar.gz: 358e8b32723334191182b56f87b6c066628b52123ea1c6f23086c4c8a1dc035179c0a243299e396fd80e1bec1d8a3c950171f9cb83c0d3b8b268475c3cbe9802

data/README.md

@@ -3,26 +3,28 @@
 Explorer is a replacement for Pow! written in Ruby.
 
 [![Dependency Status](https://gemnasium.com/Darksecond/explorer.svg)](https://gemnasium.com/Darksecond/explorer)
+[![Gem Version](https://badge.fury.io/rb/explorer.svg)](http://badge.fury.io/rb/explorer)
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Install it yourself as:
 
-```ruby
-gem 'explorer'
-```
+    $ gem install explorer
 
-And then execute:
+## Usage
 
-    $ bundle
+Run the following command to start up the server
 
-Or install it yourself as:
+    $ explore boot
 
-    $ gem install explorer
+The server can be controlled using various subcommands.
+More information can be gotten by running:
 
-## Usage
+    $ explore help proxy
+
+and
 
-TODO: Write usage instructions here
+    $ explore help process
 
 ## Contributing
 

data/data/setup/dev

@@ -0,0 +1,2 @@
+nameserver 127.0.0.1
+port 23400

data/data/setup/firewall.plist

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+<key>Label</key>
+<string>nl.darksecond.explorer</string>
+<key>ProgramArguments</key>
+<array>
+<string>sh</string>
+<string>-c</string>
+<string>echo "rdr pass on lo0 inet proto tcp from any to any port 80 -> 127.0.0.1 port 23401
+rdr pass on lo0 inet proto tcp from any to any port 443 -> 127.0.0.1 port 23402" | pfctl -a 'com.apple/250.ExplorerFirewall' -f - -E</string>
+</array>
+<key>RunAtLoad</key>
+<true/>
+<key>UserName</key>
+<string>root</string>
+</dict>
+</plist>

data/lib/explorer.rb

@@ -11,6 +11,7 @@ require 'explorer/ipc_client'
 require 'explorer/process'
 require 'explorer/process_manager'
 require 'explorer/log_watcher'
+require 'explorer/setup'
 
 module Explorer
   DATADIR = File.expand_path(File.join(File.dirname(__FILE__), '..', 'data'))

data/lib/explorer/cli.rb

@@ -1,6 +1,7 @@
 require 'thor'
 require 'explorer/cli/proxy'
 require 'explorer/cli/process'
+require 'explorer/cli/setup'
 
 module Explorer
   module CLI
@@ -18,6 +19,9 @@ module Explorer
       desc 'process SUBCOMMAND ...ARGS', 'manage processes'
       subcommand 'process', Process
 
+      desc 'setup SUBCOMMAND ...ARGS', 'manage explorer setup'
+      subcommand 'setup', Setup
+
       desc "boot [CONFIG]", 'Start explorer'
       def boot(config=nil)
         servers = Servers.new hostmap: {'test.dev' => {host: 'localhost', port: 8080}}

data/lib/explorer/cli/proxy.rb

@@ -1,5 +1,6 @@
 require 'rainbow'
 require 'formatador'
+require 'thor'
 
 module Explorer
   module CLI

data/lib/explorer/cli/setup.rb

@@ -0,0 +1,26 @@
+require 'thor'
+require 'rainbow'
+
+module Explorer
+  module CLI
+    class Setup < Thor
+      desc 'install', 'install explorer so that it can be used with `.dev` domains'
+      def install
+        setup = Explorer::Setup.new
+        return puts Rainbow('Explorer is already installed').color(:red) if setup.installed?
+        return puts Rainbow('Cannot install, not suitable').color(:red) unless setup.suitable?
+        setup.install
+        puts Rainbow('Done installing `.dev` support').color(:green).bright
+      end
+
+      desc 'uninstall', 'uninstall `.dev` domain support'
+      def uninstall
+        setup = Explorer::Setup.new
+        return puts Rainbow('Explorer is not installed').color(:red) unless setup.installed?
+        return puts Rainbow('Cannot uninstall, not suitable').color(:red) unless setup.suitable?
+        setup.uninstall
+        puts Rainbow('Done uninstalling `.dev` support').color(:green).bright
+      end
+    end
+  end
+end

data/lib/explorer/setup.rb

@@ -0,0 +1,68 @@
+require 'etc'
+
+module Explorer
+  class Setup
+    FIREWALL_PLIST_DST = '/Library/LaunchDaemons/nl.darksecond.explorer.firewall.plist'
+    RESOLVER_FILE_DST = '/etc/resolver/dev'
+    RESOLVER_DIR_DST = '/etc/resolver'
+
+    def install
+      firewall_plist_src = File.join(Explorer::DATADIR, 'setup', 'firewall.plist')
+      resolver_file_src = File.join(Explorer::DATADIR, 'setup', 'dev')
+
+      mkdir(RESOLVER_DIR_DST)
+      FileUtils.cp resolver_file_src, RESOLVER_FILE_DST
+      puts Rainbow("Installed `#{RESOLVER_FILE_DST}`").color(:green).bright
+
+      FileUtils.cp firewall_plist_src, FIREWALL_PLIST_DST
+      puts Rainbow("Installed `#{FIREWALL_PLIST_DST}`").color(:green).bright
+
+      unload_firewall
+      load_firewall
+      puts Rainbow('Loaded firwall rules').color(:green).bright
+
+    rescue Errno::EACCES => e
+      puts Rainbow("Something went wrong installing (#{e.message})").color(:red).bright
+    end
+
+    def uninstall
+      FileUtils.rm RESOLVER_FILE_DST
+      puts Rainbow("Removed `#{RESOLVER_FILE_DST}`").color(:green).bright
+
+      unload_firewall
+      puts Rainbow("Unloaded firewall rules").color(:green).bright
+
+      FileUtils.rm FIREWALL_PLIST_DST
+      puts Rainbow("Removed `#{FIREWALL_PLIST_DST}`").color(:green).bright
+
+    rescue Errno::EACCES => e
+      puts Rainbow("Something went wrong uninstalling (#{e.message})").color(:red).bright
+    end
+
+    def installed?
+      return false unless File.exists? FIREWALL_PLIST_DST
+      return false unless File.exists? RESOLVER_FILE_DST
+      true
+    end
+
+    def suitable?
+      return false unless Etc.uname[:sysname] == 'Darwin'
+      true
+    end
+
+    private
+
+    def unload_firewall
+      system("pfctl -a com.apple/250.ExplorerFirewall -F nat 2>/dev/null")
+      system("launchctl unload -w #{FIREWALL_PLIST_DST} 2>/dev/null")
+    end
+
+    def load_firewall
+      system("launchctl load -Fw #{FIREWALL_PLIST_DST} 2>/dev/null")
+    end
+
+    def mkdir(dir)
+      FileUtils.mkdir(dir) unless Dir.exists? dir
+    end
+  end
+end

data/lib/explorer/version.rb

@@ -1,3 +1,3 @@
 module Explorer
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: explorer
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Tim Peters
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-08 00:00:00.000000000 Z
+date: 2015-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -166,12 +166,15 @@ files:
 - bin/explore
 - data/server.crt
 - data/server.key
+- data/setup/dev
+- data/setup/firewall.plist
 - explorer.gemspec
 - lib/celluloid/io/pty.rb
 - lib/explorer.rb
 - lib/explorer/cli.rb
 - lib/explorer/cli/process.rb
 - lib/explorer/cli/proxy.rb
+- lib/explorer/cli/setup.rb
 - lib/explorer/ipc_client.rb
 - lib/explorer/log_watcher.rb
 - lib/explorer/process.rb
@@ -183,6 +186,7 @@ files:
 - lib/explorer/server/https.rb
 - lib/explorer/server/ipc.rb
 - lib/explorer/servers.rb
+- lib/explorer/setup.rb
 - lib/explorer/version.rb
 homepage: ''
 licenses: