zaru 0.0.1

data/lib/zaru.rb

@@ -0,0 +1,37 @@
+# encoding: utf-8
+
+class Zaru
+  CHARACTER_FILTER = /[\x00-\x1F\/\\:\*\?\"<>\|]/u
+  UNICODE_WHITESPACE = /[[:space:]]+/u
+
+  def initialize(filename)
+    @raw = filename.to_s.freeze
+  end
+
+  # strip whitespace on beginning and end
+  # collapse intra-string whitespace into single spaces
+  def normalize
+    @normalized ||= @raw.strip.gsub(UNICODE_WHITESPACE,' ')
+  end
+
+  # remove characters that aren't allowed cross-OS
+  def sanitize
+    @sanitized ||= normalize.gsub(CHARACTER_FILTER,'')
+  end
+
+  # normalize unicode string and cut off at 255 characters
+  # TODO
+  def truncate
+    @truncated ||= sanitize.chars.to_a.slice(0..254).join
+  end
+
+  # convert back from multibyte string
+  def to_s
+    truncate
+  end
+  
+  # convenience method
+  def self.sanitize!(filename)
+    Zaru.new(filename).to_s
+  end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: zaru
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Thomas Fuchs
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-03 00:00:00.000000000 Z
+dependencies: []
+description: Filename sanitization for Ruby
+email: thomas@slash7.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/zaru.rb
+homepage: http://rubygems.org/gems/zaru
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: zaru
+test_files: []