media-path 0.1

data/CHANGELOG

@@ -0,0 +1,3 @@
+= Version 0.1
+  * Renamed from path to media-path
+  * Basic functionality for generating URLs, rewrites etc

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Jakub Stastny aka Botanicus
+
+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.textile

@@ -0,0 +1,40 @@
+h1. About
+
+h1. Installation
+
+* Prerelease: @gem install media-path --prerelease@
+* Stable Version: @gem install media-path@
+
+h1. Setup
+
+<pre>
+MediaMediaPath.media_root = "public"
+</pre>
+
+h2. Rewriting rules
+
+<pre>
+MediaMediaPath.rewrite { |path| "http://media.domain.org/#{path}" }
+MediaMediaPath.rewrite { |path| path.tr("_", "-") }
+</pre>
+
+h1. Usage
+
+<pre>
+path = MediaMediaPath.new("public/javascripts/mootools-core.js")
+
+path.relative
+# => "public/javascripts/mootools-core.js"
+
+path.absolute
+# => "/Users/botanicus/projects/webs/myproject/public/javascripts/mootools-core.js"
+
+path.server
+# => "/javascripts/mootools-core.js"
+</pre>
+
+h1. Links
+
+- "Source Code":http://github.com/botanicus/media-path
+- "RunCodeRun":http://runcoderun.com/botanicus/media-path
+- "API Documentation":http://rdoc.info/projects/botanicus/media-path

data/Rakefile

@@ -0,0 +1,79 @@
+#!/usr/bin/env rake1.9
+# encoding: utf-8
+
+# http://support.runcoderun.com/faqs/builds/how-do-i-run-rake-with-trace-enabled
+Rake.application.options.trace = true
+
+task :setup => ["submodules:init"]
+
+namespace :submodules do
+  desc "Init submodules"
+  task :init do
+    sh "git submodule init"
+  end
+
+  desc "Update submodules"
+  task :update do
+    Dir["vendor/*"].each do |path|
+      if File.directory?(path) && File.directory?(File.join(path, ".git"))
+        Dir.chdir(path) do
+          puts "=> #{path}"
+          puts %x[git reset --hard]
+          puts %x[git fetch]
+          puts %x[git reset origin/master --hard]
+          puts
+        end
+      end
+    end
+  end
+end
+
+task :gem do
+  sh "gem build media-path.gemspec"
+end
+
+namespace :gem do
+  task :prerelease do
+    require_relative "lib/media-path"
+    gemspec = Dir["*.gemspec"].first
+    content = File.read(gemspec)
+    prename = "#{gemspec.split(".").first}.pre.gemspec"
+    version = MediaPath::VERSION.sub(/^(\d+)\.(\d+)\.\d+$/) { "#$1.#{$1.to_i + 1}" }
+    File.open(prename, "w") do |file|
+      file.puts(content.gsub(/(\w+::VERSION)/, "'#{version}.pre'"))
+    end
+    sh "gem build #{prename}"
+    rm prename
+  end
+end
+
+desc "Release new version of media-path"
+task release: ["release:tag", "release:gemcutter"]
+
+namespace :release do
+  desc "Create Git tag"
+  task :tag do
+    require_relative "lib/media-path"
+    puts "Creating new git tag #{MediaPath::VERSION} and pushing it online ..."
+    sh "git tag -a -m 'Version #{MediaPath::VERSION}' #{MediaPath::VERSION}"
+    sh "git push --tags"
+    puts "Tag #{MediaPath::VERSION} was created and pushed to GitHub."
+  end
+
+  desc "Push gem to Gemcutter"
+  task :gemcutter do
+    puts "Pushing to Gemcutter ..."
+    sh "gem push #{Dir["*.gem"].last}"
+  end
+
+  desc "Create and push prerelease gem"
+  task :pre => ["gem:prerelease", :gemcutter]
+end
+
+desc "Run specs"
+task :default => :setup do
+  rubylib = (ENV["RUBYLIB"] || String.new).split(":")
+  libdirs = Dir["vendor/*/lib"]
+  ENV["RUBYLIB"] = (libdirs + rubylib).join(":")
+  exec "./script/spec --options spec/spec.opts spec"
+end

data/TODO.txt

@@ -0,0 +1,6 @@
+=== Version 0.2 ===
+- 100% specs passing
+- YARD API documentation
+
+=== Version 0.3 ===
+- MediaPath::Soft for files that maybe don't exist

data/deps.rip

@@ -0,0 +1,5 @@
+#!/usr/bin/env rip install
+
+# Syntax:
+# repository [tag or commit to install]
+git://github.com/botanicus/rubyexts.git

data/lib/media-path.rb

@@ -0,0 +1,269 @@
+# coding: utf-8
+
+require "rubyexts/class"
+
+class MediaPath
+  VERSION ||= "0.1"
+
+  # @since 0.0.1
+  def self.first_file(*choices)
+    choices.find { |file| File.file?(File.expand_path(file)) }
+  end
+
+  # @since 0.0.1
+  def self.first_directory(*choices)
+    choices.find { |file| File.directory?(File.expand_path(file)) }
+  end
+
+  # @since 0.0.1
+  def self.check_directory_path(path)
+    return if path.nil? # because of exceptions
+    raise ArgumentError.new("MediaPath can't be created from empty string") if path.empty?
+    path = File.expand_path(path)
+    raise ArgumentError, "MediaPath '#{path}' doesn't exist" unless File.directory?(path)
+    return path
+  end
+
+  # @since 0.0.1
+  cattr_reader :media_root
+  def self.media_root=(path)
+    @@media_root = self.check_directory_path(path)
+  end
+
+  # @since 0.0.1
+  def self.root
+    @@root rescue Dir.pwd
+  end
+
+  # @since 0.0.1
+  def self.root=(path)
+    @@root = self.check_directory_path(path)
+  end
+
+  # @since 0.0.1
+  cattr_reader :rewrite_rules
+  def self.rewrite_rules=(rules)
+    @@rewrite_rules = rules
+  end
+
+  self.rewrite_rules ||= Array.new
+
+  # @since 0.0.1
+  # @note It make problems in case of reloading
+  def self.rewrite(&rule)
+    # @@rewrite_rules.push(&rule) # WTF?
+    @@rewrite_rules += [rule]
+  end
+
+  # @since 0.0.1
+  attr_reader :absolute
+
+  # @since 0.0.1
+  alias_method :path, :absolute
+
+  # @since 0.0.1
+  attr_accessor :root, :media_root
+
+  # MediaPath.new("public/uploads")
+  # MediaPath.new("#{Merb.root}/public/uploads")
+  # @since 0.0.1
+  def initialize(path)
+    self.root = self.class.root
+    raise ArgumentError.new("Argument for creating new MediaPath must be string") unless path.is_a?(String)
+    raise ArgumentError.new("MediaPath can't be created from empty string") if path.empty?
+    path.chomp!("/") unless path == "/" # no trailing /
+    if path.match(%r{^/}) || path.match(%r[^[A-Z]//]) # / or C://
+      @absolute = File.expand_path(path)
+    else
+      @absolute = File.expand_path(File.join(self.class.root, path))
+    end
+    raise Errno::ENOENT, "File does not exist: '#{@absolute}'" unless File.exist?(@absolute)
+  end
+
+  # @since 0.0.1
+  def root
+    @root || Dir.pwd
+  end
+
+  # @since 0.0.1
+  def media_root
+    @media_root ||= self.class.media_root
+    return @media_root unless @media_root.nil?
+    raise "#{self.class}#media_root can't be nil! If you like setup media_root for all instances, use #{self.class}.media_root" if @media_root.nil?
+  end
+
+  # @since 0.0.1
+  def media_root=(path)
+    @media_root = self.class.check_directory_path(path)
+  end
+
+  # @since 0.0.1
+  def root=(path)
+    @root = self.class.check_directory_path(path)
+  end
+
+  # @since 0.0.1
+  def relative
+    path = @absolute.dup
+    path[self.root] = String.new
+    path.sub!(%r[^/], "")
+    return path
+  end
+
+  # @since 0.0.1
+  def parent
+    parent = File.expand_path(File.join(@absolute, ".."))
+    MediaPath.new(parent)
+  end
+
+  # @since 0.0.1
+  def url
+    url = @absolute.dup
+    url[self.media_root] = String.new
+    rules = self.class.rewrite_rules
+    rules.empty? ? url : rules.map { |rule| url = rule.call(url) }.last
+  end
+
+  # @since 0.0.1
+  def ==(another)
+    raise TypeError unless another.is_a?(self.class)
+    @absolute == another.absolute
+  end
+  alias_method :eql?, :==
+
+  # @since 0.0.1
+  def join(*segments)
+    raise ArgumentError if segments.any? { |segment| not segment.is_a?(String) }
+    raise ArgumentError if segments.any? { |segment| segment.match(%r{^/}) }
+    self.class.new(File.join(@absolute, *segments))
+  end
+
+  # @since 0.0.1
+  def +(segment)
+    raise ArgumentError unless segment.is_a?(String)
+    raise ArgumentError if segment.match(%r{^/})
+    self.class.new("#@absolute/#{segment}")
+  end
+
+  # Dir["#{path}/*"]
+  # @since 0.0.1
+  alias_method :to_s, :absolute
+
+  # @since 0.0.1
+  def entries
+    Dir["#@absolute/*"].map do |path|
+      self.class.new(path)
+    end
+  end
+
+  # @since 0.0.1
+  def inspect
+    %["file://#@absolute"]
+  end
+
+  # @since 0.0.1
+  def basename
+    File.basename(@absolute)
+  end
+
+  # @since 0.0.1
+  def write(&block)
+    File.open(@absolute, "w", &block)
+  end
+
+  # @since 0.0.1
+  def read(&block)
+    if block_given?
+      File.open(@absolute, "r", &block)
+    else
+      File.read(@absolute)
+    end
+  end
+
+  # @since 0.0.1
+  def append(&block)
+    File.open(@absolute, "a", &block)
+  end
+
+  # @since 0.0.1
+  def rewrite(&block)
+    File.open(@absolute, "w+", &block)
+  end
+
+  # MediaPathname("x.html.erb").extname
+  # => ".erb"
+  # @since 0.0.1
+  def extension(file)
+    self.to_s[/\.\w+?$/] # html.erb.
+    # return @path.last.sub(/\.(\w+)$/, '\1') # dalsi moznost
+  end
+
+  # @since 0.0.1
+  def to_a
+    return self.to_s.split("/")
+  end
+
+  # @since 0.0.1
+  def without_extension
+    return self.to_s.sub(/#{extension}$/, '')
+  end
+
+  # alias_method :childrens, :children
+  # @since 0.0.1
+  def make_executable
+    File.chmod(0755, @filename)
+  end
+
+  # @since 0.0.1
+  def make_unexecutable
+    File.chmod(0644, @filename)
+  end
+
+  # @since 0.0.1
+  def run(command)
+    Dir.chdir(self) do
+      return %x(#{command})
+    end
+  end
+
+  # @since 0.0.1
+  def exist?
+    File.exist?(@absolute)
+  end
+
+  # @since 0.0.1
+  def load
+    Kernel.load(@absolute)
+  end
+
+  # @since 0.0.1
+  def hidden?
+    self.basename.to_s.match(/^\./).to_bool
+  end
+
+  # @since 0.0.1
+  def empty?
+    (self.directory? and self.children.empty?) || File.zero?()
+  end
+
+  # @since 0.0.1
+  def md5(file)
+    require 'digest/md5'
+    Digest::MD5.hexdigest(File.read(file))
+  end
+
+  # @since 0.0.1
+  def self.without_extension(file)
+    return file.sub(/\.\w+$/, '')
+  end
+
+  # @since 0.0.1
+  def self.basename_without_extension(file)
+    return File.basename(file.sub(/\.\w+$/, ''))
+  end
+
+  # @since 0.0.1
+  def self.change_extension(file, extension)
+    return file.sub(/\.\w+$/, ".#{extension}")
+  end
+end

data/media-path.gemspec

@@ -0,0 +1,38 @@
+#!/usr/bin/env gem1.9 build
+# encoding: utf-8
+
+Dir[File.join(File.dirname(__FILE__), "vendor", "*")].each do |path|
+  if File.directory?(path) && Dir["#{path}/*"].empty?
+    warn "Dependency #{File.basename(path)} in vendor seems to be empty. Run git submodule init && git submodule update to checkout it."
+  elsif File.directory?(path) && File.directory?(File.join(path, "lib"))
+    $:.unshift File.join(path, "lib")
+  end
+end
+
+# NOTE: we can't use require_relative because when we run gem build, it use eval for executing this file
+require File.join(File.dirname(__FILE__), "lib", "media-path")
+
+Gem::Specification.new do |s|
+  s.name = "media-path"
+  s.version = MediaPath::VERSION
+  s.authors = ["Jakub Šťastný aka Botanicus"]
+  s.homepage = "http://github.com/botanicus/media-path"
+  s.summary = "MediaPath abstraction that provides easier interaction with paths and corresponding URLs." # TODO
+  s.description = "" # TODO
+  s.cert_chain = nil
+  s.email = ["knava.bestvinensis", "gmail.com"].join("@")
+  s.has_rdoc = true
+
+  # files
+  s.files = Dir.glob("**/*") - Dir.glob("pkg/*")
+  s.require_paths = ["lib"]
+
+  # Ruby version
+  s.required_ruby_version = ::Gem::Requirement.new(">= 1.9.1")
+
+  # runtime dependencies
+  s.add_dependency "rubyexts"
+
+  # RubyForge
+  s.rubyforge_project = "media-path"
+end