string-utils 0.1.0

data/CHANGELOG.rdoc

@@ -0,0 +1 @@
+0.1.0 - First commit

data/Manifest

@@ -0,0 +1,5 @@
+CHANGELOG.rdoc
+README.rdoc
+Rakefile
+lib/string-utils.rb
+Manifest

data/README.rdoc

@@ -0,0 +1,69 @@
+string-utils
+==========
+
+This small extension enables string sanitization in models and controller.
+
+Contains a workaround for Rails sanitize helper that (as any helper) works only in views, allowing you to call my_text.sanitize also in controllers, models and libs.
+
+Provides also a function for making url friendly strings removing all unwanted characters.
+
+Basically it adds some methods and shortcuts to the String class, see the example section for usage.
+
+Works with Rails ~> 2.3.6 and ~> 3.0.0 beta
+
+Install
+=======
+
+Specify it in your Rails project config/environment.rb under the "Rails::Initializer.run do |config|" block
+
+	config.gem 'string-utils', :source => "http://gemcutter.org"
+
+Then install it from the console.
+
+	rake gems:install
+
+
+Or install manually with:
+
+	sudo gem install string-utils --source http://gemcutter.org
+
+
+Examples
+=======
+
+>> my_unsafe_text.sanitize
+Applies the sanitize helper to text.
+Works not only in views but also in models, controllers and libs!
+
+>> my_unsafe_text.san
+Shortcut for my_unsafe_text.sanitize
+
+>> "Fire in the hole: <script>alert('bam!');</script>".san
+=> "Fire in the hole: "
+
+>> "Some tags: <asdasd>an asdasd tag</adsasd>".san
+=> "Some tags: an asdasd tag"
+
+>> my_SAFE_text.hs
+Shortcut for my_SAFE_text.html_safe
+USE WITH CAUTION
+Forces the string to be html safe so it won't be escaped.
+Useful for quick-and-dirty monkey scripting in views.
+
+>> message = "I really need this <script>alert('popup')</script>".hs
+=> "I really need this <script>alert('popup')</script>"
+>> message.html_safe?
+=> true
+
+
+"My really great post".urlify
+=> "my-really-great-post"
+
+"O come l'è GANZA 'sta gemma!".urlify
+=> "o-come-l-e-ganza-sta-gemma"
+
+
+
+
+
+Copyright (c) 2010 Silvio Relli, released under the MIT license

data/Rakefile

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('string-utils', '0.1.0') do |p|
+  p.description    = "This small extension enables string sanitization in models and controller. Provides also a function for making url friendly strings removing all unwanted characters."
+  p.url            = "http://github.com/silviorelli/string-utils"
+  p.author         = "Silvio Relli"
+  p.email          = "silvio@relli.org"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.development_dependencies = []
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/lib/string-utils.rb

@@ -0,0 +1,38 @@
+# Silvio Relli's string_utils gem - released under the MIT License
+class String
+  
+  # Workaround for sanitize method not availabe in controllers, models and libs.
+  # Now you can call "mystryng".sanitize everywere.
+  def sanitize
+    ActionController::Base.helpers.sanitize(self)
+  end
+  
+  # Ensures the string is sanitized and html safe,
+  # so it won't be escaped by xss protection and erubis in rails >=2.3.6 and >=3.0.
+  def san
+    self.sanitize
+  end
+  
+  # Just a shortcut to force a string to be html safe.
+  # Use with caution.
+  def hs
+    self.html_safe
+  end
+  
+  # Makes strings be url-friendly
+  def urlify
+    str = self.downcase.gsub(/ /,'-')
+    str.gsub!(/À|à|á|Â|â|Ã|ã|Ä|ä/i,'a') 
+    str.gsub!(/È|è|É|é|Ê|ê|Ë|ë/i,'e')
+    str.gsub!(/Ì|ì|í|Î|î/i,'i')
+    str.gsub!(/Ò|ò|ó|Ô|ô|Õ|õ|Ö|ö/i,'o')
+    str.gsub!(/Ù|ù|ú|Û|û|Ü|ü/i,'u')
+    str.gsub!(/ç/i,'c')
+    str.gsub!(/œ/i,'oe')
+    str.gsub!(/ß/i,'ss')
+    str.gsub!(/[^a-z0-9\-]+/i, '')
+    str
+  end
+  
+end
+

data/string-utils.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{string-utils}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Silvio Relli"]
+  s.date = %q{2010-06-08}
+  s.description = %q{This small extension enables string sanitization in models and controller. Provides also a function for making url friendly strings removing all unwanted characters.}
+  s.email = %q{silvio@relli.org}
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "README.rdoc", "lib/string-utils.rb"]
+  s.files = ["CHANGELOG.rdoc", "README.rdoc", "Rakefile", "lib/string-utils.rb", "Manifest", "string-utils.gemspec"]
+  s.homepage = %q{http://github.com/silviorelli/string-utils}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "String-utils", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{string-utils}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{This small extension enables string sanitization in models and controller. Provides also a function for making url friendly strings removing all unwanted characters.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: string-utils
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Silvio Relli
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-08 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: This small extension enables string sanitization in models and controller. Provides also a function for making url friendly strings removing all unwanted characters.
+email: silvio@relli.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.rdoc
+- README.rdoc
+- lib/string-utils.rb
+files: 
+- CHANGELOG.rdoc
+- README.rdoc
+- Rakefile
+- lib/string-utils.rb
+- Manifest
+- string-utils.gemspec
+has_rdoc: true
+homepage: http://github.com/silviorelli/string-utils
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- String-utils
+- --main
+- README.rdoc
+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: 11
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
+requirements: []
+
+rubyforge_project: string-utils
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: This small extension enables string sanitization in models and controller. Provides also a function for making url friendly strings removing all unwanted characters.
+test_files: []
+