pasu 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3127e891fee1f5bce7a3f057fcd05a7914b16893
+  data.tar.gz: 362104b819db149f78599e57fabfd57c70e4cfd2
+SHA512:
+  metadata.gz: 1e30bbb27b83d64c8756f2698ee9dc6299d60b2ff283f75e9e88227f8208784543912545b34a88e9ace25d71ae872ec4c040fc2ffb15a0a05187b3ce07c35ab5
+  data.tar.gz: 5070ba9accab64dd258e31901b563d5e9503e4d319a922c3de36075e7a1889dfd3895559982d5d32c24946b95bf857e7c577997c8c2fce5364d744377e47f073

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Tobias Bühlmann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR
+COPYRIGHT HOLDERS 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.

data/README.md

@@ -0,0 +1,42 @@
+# Pasu
+
+[![Gem Version](https://badge.fury.io/rb/pasu.png)](http://badge.fury.io/rb/pasu) [![Dependency Status](https://gemnasium.com/tbuehlmann/pasu.png)](https://gemnasium.com/tbuehlmann/pasu)
+
+Pasu is a simple HTTP Server for serving (and uploading) Files.
+
+## Requirements
+- Ruby ~> 2.0
+
+## Installation
+
+```sh
+$ gem install pasu
+```
+
+## Usage
+
+```sh
+$ pasu
+```
+
+### Options
+
+| Option | Description | Default |
+| --- | --- | --- |
+| -v, --version | Print version. | |
+| -d, --directory DIRECTORY | Set the base directory for listing files. | pwd |
+| --no-recursion | Don't recursively list directories. | false |
+| -u, --upload | Allow uploading of files. | false |
+| --basic-auth USER:PW | Only allowing requests with valid user/pw combination provided. | None |
+| -b, --bind HOST | Bind the server to the given host. | 0.0.0.0 |
+| -p, --port PORT | Bind the server to the given port. | 8080 |
+| -s, --server RACK_HANDLER | Use your own rack handler. | Puma |
+| -h, --help | Show help message. |
+
+## Contributing
+
+1. Fork it (https://github.com/tbuehlmann/pasu/fork)
+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

data/bin/pasu

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'pasu'
+
+runner = Pasu::Runner.new
+runner.run

data/lib/pasu.rb

@@ -0,0 +1,14 @@
+require 'optparse'
+require 'pathname'
+
+require 'cuba'
+require 'cuba/render'
+require 'cuba/send_file'
+require 'puma'
+require 'slim'
+
+module Pasu
+  require 'pasu/application'
+  require 'pasu/runner'
+  require 'pasu/version'
+end

data/lib/pasu/application.rb

@@ -0,0 +1,171 @@
+module Pasu
+  class Application < Cuba
+    plugin SendFile
+    plugin Cuba::Render
+    
+    settings[:render][:template_engine] = 'slim'
+
+    class << self
+      def setup(options = {})
+        settings.merge!(default_settings)
+        settings.merge!(options)
+        setup_basic_auth
+      end
+
+      def default_settings
+        {
+          directory: Pathname.pwd,
+          recursive: true,
+          upload: false,
+          basic_auth: {},
+          host: '0.0.0.0',
+          port: 8080,
+          handler: 'Puma'
+        }
+      end
+
+      def run
+        rack_handler = Rack::Handler.get(settings[:handler])
+        rack_handler.run(
+          self,
+          Host: settings[:host],
+          Port: settings[:port],
+          Verbose: true
+        )
+      end
+
+      private
+
+      def setup_basic_auth
+        if settings[:basic_auth].any?
+          use Rack::Auth::Basic do |username, password|
+            settings[:basic_auth][username] == password
+          end
+        end
+      end
+    end
+
+    define do
+      on /(.*)/ do |escaped_path|
+        @path = unescape_path(escaped_path)
+
+        on get do
+          on file do
+            send_file(@path)
+          end
+
+          on directory do
+            @files = children(@path)
+            res.write view(:directory)
+          end
+
+          on file_not_found do
+            res.status = 404
+            res.write view(:file_not_found)
+          end
+        end
+
+        on post do
+          on upload_allowed do
+            on directory do
+              on param(:file) do |file|
+                save_file(@path, file)
+                res.redirect escape_path(@path.relative_path_from(settings[:directory]))
+              end
+
+              on no_file_attached do
+                res.status = 400
+                res.write view(:no_file_attached)
+              end
+            end
+
+            on directory_not_found do
+              res.status = 404
+              res.write view(:directory_not_found)
+            end
+          end
+
+          on upload_not_allowed do
+            res.status = 401
+            res.write view(:no_upload)
+          end
+        end
+      end
+    end
+
+    private
+
+    def escape_path(path)
+      file_names = path.each_filename.map do |file_name|
+        Rack::Utils.escape_path(file_name)
+      end.join('/')
+
+      file_names == '.' ? '/' : "/#{file_names}"
+    end
+
+    def unescape_path(escaped_path)
+      file_names = escaped_path.split('/').map do |file_name|
+        Rack::Utils.unescape(file_name)
+      end
+
+      settings[:directory].join(*file_names)
+    end
+
+    def children(path)
+      path.children.tap do |files|
+        files.select!  { |file| (file.directory? || file.file?) && file.readable? }
+        files.sort_by! { |file| [file.ftype, file.basename] }
+
+        if settings[:recursive]
+          if path != settings[:directory]
+            files.unshift(path.parent)
+          end
+        else
+          files.select!(&:file?)
+        end
+      end
+    end
+
+    def directory
+      @path.directory? && @path.readable? && allowed_directory?(@path)
+    end
+
+    def file
+      @path.file? && @path.readable? && allowed_directory?(@path.parent)
+    end
+
+    def allowed_directory?(directory)
+      is_descendant = directory.ascend do |ascendant|
+        break(true) if ascendant == settings[:directory]
+      end
+
+      (settings[:recursive] || directory == settings[:directory]) && is_descendant
+    end
+
+    # TODO: wb correct?
+    def save_file(directory, file)
+      path = directory.join(file[:filename])
+      File.open(path, 'wb') { |f| f.write(file[:tempfile].read) }
+    end
+
+    def upload_allowed
+      settings[:upload]
+    end
+
+    def upload_not_allowed
+      true
+    end
+
+    def file_not_found
+      true
+    end
+
+    def directory_not_found
+      true
+    end
+
+    def no_file_attached
+      true
+    end
+  end
+end

data/lib/pasu/runner.rb

@@ -0,0 +1,73 @@
+module Pasu
+  class Runner
+    def initialize
+      OptionParser.new do |p|
+        p.banner = 'Usage: pasu [options]'
+
+        p.separator ''
+        p.separator 'Options:'
+
+        p.on('-v', '--version', 'Print version.') do
+          puts "Pasu #{VERSION} (https://github.com/tbuehlmann/pasu)"
+          exit
+        end
+
+        p.on('-d', '--directory DIRECTORY', 'Set the base directory for listing files. (Default: pwd)') do |dir|
+          directory = Pathname.new(dir).expand_path
+
+          if directory.directory?
+            options[:directory] = directory
+          else
+            puts "Couldn't find directory #{dir}"
+            exit 1
+          end
+        end
+
+        p.on('--no-recursion', "Don't recursively list directories. (Default: false)") do
+          options[:recursive] = false
+        end
+
+        p.on('-u', '--upload', 'Allow uploading of files. (Default: false)') do
+          options[:upload] = true
+        end
+
+        p.on('--basic-auth USER:PW', 'Only allowing requests with valid user/pw combination provided. (Default: None)') do |access|
+          username, password = access.split(':')
+          options[:basic_auth] ||= {}
+          options[:basic_auth][username] = password
+        end
+
+        p.on('-b', '--bind HOST', 'Bind the server to the given host. (Default: 0.0.0.0)') do |host|
+          options[:host] = host
+        end
+
+        p.on('-p', '--port PORT', 'Bind the server to the given port. (Default: 8080)') do |port|
+          options[:port] = Integer(port)
+        end
+
+        p.on('-s', '--server RACK_HANDLER', 'Use your own rack handler. (Default: Puma)') do |handler|
+          options[:handler] = handler
+        end
+
+        p.on_tail('-h', '--help', 'Show this message.') do
+          puts p
+          exit
+        end
+      end.parse!
+    end
+
+    def options
+      @options ||= {}
+    end
+
+    def run
+      Pasu::Application.setup(options)
+
+      begin
+        Pasu::Application.run
+      rescue Errno::EADDRINUSE
+        puts "Port #{options[:port]} is already in use. Quitting."
+      end
+    end
+  end
+end

data/lib/pasu/version.rb

@@ -0,0 +1,3 @@
+module Pasu
+  VERSION = Gem::Version.new('0.0.1')
+end

data/pasu.gemspec

@@ -0,0 +1,33 @@
+# encoding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'pasu/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'pasu'
+  spec.version       = Pasu::VERSION
+  spec.authors       = ['Tobias Bühlmann']
+  spec.email         = ['tobias.buehlmann@gmx.de']
+  spec.summary       = 'Simple File Serving HTTP Server'
+  spec.description   = 'Pasu is a simple HTTP Server for serving (and uploading) Files.'
+  spec.homepage      = 'https://github.com/tbuehlmann/pasu'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split("\n")
+  spec.executables   = ['pasu']
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '~> 2.0'
+
+  spec.add_runtime_dependency 'cuba', '~> 3.1'
+  spec.add_runtime_dependency 'cuba-sendfile', '0.0.2'
+  spec.add_runtime_dependency 'slim', '~> 2.0'
+  spec.add_runtime_dependency 'tilt', '~> 2.0'
+  spec.add_runtime_dependency 'puma', '~> 2.7'
+
+  spec.add_development_dependency 'bundler', '~> 1.5'
+  spec.add_development_dependency 'rake', '~> 10.1'
+  spec.add_development_dependency 'pry', '0.9.12.6'
+end

data/views/directory.slim

@@ -0,0 +1,12 @@
+h1 Directory listing
+
+- if settings[:upload]
+  form action=escape_path(@path.relative_path_from(settings[:directory])) method='POST' enctype="multipart/form-data"
+    input type='file' name='file'
+    input type='submit' value='Upload'
+
+ul
+  - @files.each do |file|
+    li class=file.ftype
+      - text = file == @path.parent ? '..' : file.basename
+      a href=escape_path(file.relative_path_from(settings[:directory])) #{Rack::Utils.escape_html(text)}

data/views/directory_not_found.slim

@@ -0,0 +1 @@
+h1 Directory not found

data/views/file_not_found.slim

@@ -0,0 +1 @@
+h1 File not found

data/views/layout.slim

@@ -0,0 +1,8 @@
+doctype html
+html
+  head
+    title Pasu
+    css:
+      body { font-family: Helvetica, Arial, sans-serif; }
+  body
+    == content

data/views/no_file_attached.slim

@@ -0,0 +1 @@
+h1 No File attached

data/views/no_upload.slim

@@ -0,0 +1 @@
+h1 Uploading files is not permitted

data/views/upload.slim

@@ -0,0 +1,4 @@
+- if settings[:upload]
+  form action=escape(path.relative_path_from(settings[:directory])) method='POST'
+    input type='file' name='file'
+    input type='submit' value='Upload'

metadata

@@ -0,0 +1,174 @@
+--- !ruby/object:Gem::Specification
+name: pasu
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Tobias Bühlmann
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cuba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: cuba-sendfile
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+- !ruby/object:Gem::Dependency
+  name: slim
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: tilt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.12.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.12.6
+description: Pasu is a simple HTTP Server for serving (and uploading) Files.
+email:
+- tobias.buehlmann@gmx.de
+executables:
+- pasu
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- bin/pasu
+- lib/pasu.rb
+- lib/pasu/application.rb
+- lib/pasu/runner.rb
+- lib/pasu/version.rb
+- pasu.gemspec
+- views/directory.slim
+- views/directory_not_found.slim
+- views/file_not_found.slim
+- views/layout.slim
+- views/no_file_attached.slim
+- views/no_upload.slim
+- views/upload.slim
+homepage: https://github.com/tbuehlmann/pasu
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: Simple File Serving HTTP Server
+test_files: []