servedir 0.1

data/README.md

@@ -0,0 +1,59 @@
+servedir: serve a directory over HTTP from behind NAT
+=====================================================
+
+`servedir` is a tiny Ruby program used to serve a directory over HTTP from
+boxes that are behind a NAT (most ADSL users).
+
+`servedir` does not require any additional library and is compatible with
+Ruby 1.8.7, Ruby 1.9.3 and JRuby.
+
+This program will not try to open ports on the NAT gateway: it expects ports
+to be already configured in the proper way.
+
+Usage
+-----
+
+On the box behind NAT:
+
+    $ servedir ~/Public 13428
+
+    Server starting... (CTRL-C to terminate)
+      local address: <http://localhost:13428/>
+      public address: <http://84.136.123.62:13428/>
+
+    [2012-02-11 13:24:01] INFO  WEBrick 1.3.1
+    [2012-02-11 13:24:01] INFO  ruby 1.8.7 (2010-01-10) [x86_64-linux]
+    [2012-02-11 13:24:01] INFO  WEBrick::HTTPServer#start: pid=8207 port=13428
+
+From another computer:
+
+    $ w3m -dump http://84.136.123.62:13428/
+    Index of /
+
+     Name                          Last modified         Size
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+     Parent Directory              2012/02/11 13:28      -
+     bus timetable.pdf             2011/10/09 11:04      136856
+     facesofprotest.pdf            2011/04/09 15:15      5531985
+     Country pictures 2010/        2011/04/12 22:41      -
+     fav_webradios.xml             2009/10/28 17:20      854
+
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    WEBrick/1.3.1 (Ruby/1.8.7/2010-01-10)
+    at localhost:13428
+
+
+Authors
+-------
+
+* Gioele Barabucci <http://svario.it/gioele>
+
+
+License
+-------
+
+This is free and unencumbered software released into the public domain.
+See the `UNLICENSE` file or <http://unlicense.org/> for more details.
+

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org/>

data/bin/servedir

@@ -0,0 +1,65 @@
+#!/usr/bin/env ruby
+
+# This is free and unencumbered software released into the public domain.
+# See the `UNLICENSE` file or <http://unlicense.org/> for more details.
+
+require 'open-uri'
+require 'webrick'
+
+IP_DISCO_SERVICE = 'http://automation.whatismyip.com/n09230945.asp'
+MAX_PORT = 2**16
+
+def check_args(dir, port)
+	if !File.directory?(File.expand_path(dir))
+		puts "WARNING: '#{dir}' is not a directory"
+	end
+
+	if port > MAX_PORT
+		puts "ERROR: port numer too high, #{port} is > #{MAX_PORT}"
+		exit
+	end
+end
+
+def print_addresses(dir, port)
+	begin
+		ip = open(IP_DISCO_SERVICE).read
+	rescue Errno::ENETUNREACH => err
+		puts "WARNING: Cannot reach IP discovery service"
+		ip = "NOT_AVAILABLE"
+	end
+
+	local_uri = "http://localhost:#{port}/"
+	remote_uri = "http://#{ip}:#{port}/"
+
+	puts "Server starting... (CTRL-C to terminate)"
+	puts "  local address: <#{local_uri}>"
+	puts "  public address: <#{remote_uri}>"
+	puts
+end
+
+def start_server(dir, port)
+	config = {
+		:DocumentRoot => dir,
+		:Port => port,
+	}
+
+	server = WEBrick::HTTPServer.new(config)
+
+	['INT', 'TERM'].each { |signal|
+		trap(signal) {server.shutdown}
+	}
+
+	server.start
+end
+
+if ARGV.count < 2
+	puts "servedir [DIRECTORY] [PORT]"
+	exit
+end
+
+dir = ARGV[0] || Dir.pwd
+port = ARGV[1].to_i || 8080
+
+check_args(dir, port)
+print_addresses(dir, port)
+start_server(dir, port)

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: servedir
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Gioele Barabucci
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-02-11 00:00:00 Z
+dependencies: []
+
+description: 
+email: 
+- gioele@svario.it
+executables: 
+- servedir
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/servedir
+- README.md
+- UNLICENSE
+homepage: http://github.com/gioele/servedir
+licenses: 
+- UNLICENSE
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.16
+signing_key: 
+specification_version: 3
+summary: servedir is a tiny Ruby program used to serve a directory over HTTP from boxes that are behind a NAT (most ADSL users).
+test_files: []
+
+has_rdoc: