nitro 0.1.2

data/lib/n/utils/gfx.rb

@@ -0,0 +1,108 @@
+# = General graphics utilities collection
+#
+# code: 
+# George Moschovitis  <gm@navel.gr>
+# Elias Athanasopoulos  <elathan@navel.gr>
+# Asteraki  <stella@navel.gr>
+#
+# (c) 2004 Navel, all rights reserved.
+# $Id: gfx.rb 71 2004-10-18 10:50:22Z gmosx $
+
+module N
+
+# = GfxUtils
+#
+# === Design:
+#
+# A simple wrapper around ImageMagick.
+#
+# Implement as a module to avoid class polution. You can
+# still Ruby's advanced features to include the module in your
+# class. Passing the object to act upon allows to check for nil,
+# which isn't possible if you use self.
+#
+#
+module GfxUtils
+
+	# === Input:
+	# width, height = dimensions for the scaled image.
+	#
+	def self.create_thumbnail(src, dest, width, height)
+		# gmosx: [0] selects the 1st frame in case of animated gifs.
+		# gmosx: SOS!!! the +profile "*" is need to strip metadata that
+		#      fuckup the internet explorer!
+		if (dest =~ /jpg$/i) or (File.stat(src).size > 60000)
+			# keep only the first frame
+			system %|convert +profile "*" +compress -scale '#{width}x#{height}>' -antialias #{src}[0] #{dest}|
+		else
+			system %|convert +profile "*" +compress -scale '#{width}x#{height}>' -antialias #{src} #{dest}|
+		end
+	end
+
+	# Use ImageMagick to grab the EXIF data
+	# contained in a jpeg file and store it to a 
+	# hash: EXIF field => EXIF value.
+	#
+	# A sample EXIF table:
+	#
+	# Make=Canon
+	# Model=Canon PowerShot S110
+	# Orientation=1
+	# X Resolution=180/1
+	# YResolution=180/1
+	# ResolutionUnit=2
+	# DateTime=2002:05:16 21:02:36
+	# YCbCrPositioning=1
+	# ExifOffset=196
+	# ExposureTime=1/80
+	# FNumber=28/10
+	# ExifVersion=0210
+	# DateTimeOriginal=2002:05:16 21:02:36
+	# DateTimeDigitized=2002:05:16 21:02:36
+	# ComponentsConfiguration=...
+	# CompressedBitsPerPixel=3/1
+	# ShutterSpeedValue=202/32
+	# ApertureValue=95/32
+	# ExposureBiasValue=0/3
+	# MaxApertureValue=194698/65536
+	# SubjectDistance=772/1000
+	# MeteringMode=5
+	# Flash=1
+	# FocalLength=173/32
+	# MakerNote=.
+	# UserComment=
+	# FlashPixVersion=0100
+	# ColorSpace=1
+	# ExifImageWidth=1600
+	# ExifImageLength=1200
+	# InteroperabilityOffset=1328
+	# unknown=R98
+	# unknown=0100
+	# unknown=1600
+	# unknown=1200
+	# FocalPlaneXResolution=1600000/206
+	# FocalPlaneYResolution=1200000/155
+	# FocalPlaneResolutionUnit=2
+	# SensingMethod=2
+	# FileSource=.
+	#
+	def self.grab_exif(path)
+		info = %x|identify -format "%[EXIF:*]" #{path}|.split("\n")
+	
+		exif = {}
+		info.each { |l|
+			tag, value = l.split("=")
+			exif[tag] = value
+		} 
+		
+		unless exif.empty?
+			return exif
+		else
+			return nil
+		end
+	end
+	
+end
+
+end # module
+

data/lib/n/utils/hash.rb

@@ -0,0 +1,148 @@
+# = Hash
+#
+# various hash utilities.
+#
+# Design:
+# uses the delegator pattern to allow for multiple
+# implementations!
+#
+# *code: gmosx
+#
+# (c) 2004 Navel, all rights reserved.
+# $Id: hash.rb 71 2004-10-18 10:50:22Z gmosx $
+
+require "sync"
+
+module N;
+
+# == SafeHash
+#
+# A thread-safe hash. We use a sync object instead of a mutex,
+# because it is re-entrant.
+# An exclusive lock is needed when writing, a shared lock IS NEEDED
+# when reading
+
+class SafeHash < Hash
+	attr :sync
+
+	# gmosx: delegator is not used.
+
+	def initialize(delegator = nil)
+		@sync = ::Sync.new
+	end
+
+	def [](key)
+		return @sync.synchronize(::Sync::SH) {
+			super
+		}
+	end
+
+	def []=(key, value)
+		return @sync.synchronize(::Sync::EX) {
+			super
+		}
+	end
+
+	def delete(key)
+		return @sync.synchronize(::Sync::EX) {
+			super
+		}
+	end
+
+	def clear
+		@sync.synchronize(::Sync::EX) {
+			super
+		}
+	end
+
+	def size
+		return @sync.synchronize(::Sync::SH) {
+			super
+		}
+	end
+
+	def values
+		return @sync.synchronize(::Sync::SH) {
+			super
+		}
+	end
+
+	def keys
+		return @sync.synchronize(::Sync::SH) {
+			super
+		}
+	end
+
+end # SafeHash
+
+# == SafeHashDelegator
+#
+# A thread-safe hash. We use a sync object instead of a mutex,
+# because it is re-entrant.
+# An exclusive lock is needed when writing, a shared lock IS NEEDED
+# when reading
+#
+# Design:
+# This class uses the delegator pattern. However we dont use rubys
+# delegation facilities, they are more general and powerfull than we
+# need here (and slower). Instead a custom (but simple) solution is
+# used.
+#
+# Example:
+#
+# hash = SafeHashDelegator.new(Hash.new)
+# hash = SafeHashDelegator.new(Hash.new)
+
+class SafeHashDelegator < Hash
+	attr :delegate, :sync
+
+	def initialize(delegate)
+		@delegate = delegate
+		@sync = ::Sync.new
+	end
+
+    def [](key)
+		return @sync.synchronize(::Sync::SH) {
+			@delegate[key]
+		}
+    end
+
+    def []=(key, value)
+		return @sync.synchronize(::Sync::EX) {
+			@delegate[key] = value
+		}
+    end
+
+	def delete(key)
+		return @sync.synchronize(::Sync::EX) {
+			@delegate.delete(key)
+		}
+	end
+
+	def clear
+		@sync.synchronize(::Sync::EX) {
+			@delegate.clear
+		}
+	end
+
+	def size
+		return @sync.synchronize(::Sync::SH) {
+			@delegate.size()
+		}
+	end
+
+	def values
+		return @sync.synchronize(::Sync::SH) {
+			@delegate.values()
+		}
+	end
+
+	def keys
+		return @sync.synchronize(::Sync::SH) {
+			@delegate.keys()
+		}
+	end
+
+end # SafeHashDelegator
+
+end # module

data/lib/n/utils/html.rb

@@ -0,0 +1,147 @@
+# = HTML utilities collection
+#
+# code:: gmosx, tkout, ekarak
+#
+# (c) 2004 Navel, all rights reserved.
+# $Id: html.rb 71 2004-10-18 10:50:22Z gmosx $
+
+require "uri"
+require "cgi"
+
+module N;
+
+# = HtmlUtils
+#
+# === Design:
+#
+# Implement as a module to avoid class polution. You can still Ruby's
+# advanced features to include the module in your class.
+# Passing the object to act upon allows to check for nil, which isn't
+# possible if you use self.
+#
+# The older text_sum, text_block methods are not needed in the latest
+# code
+#
+# === TODO:
+# - add xxx! versions
+#
+module HtmlUtils
+
+	# escape html tags.
+	# usefull to make text entered by end users html safe.
+	#
+	# Input:
+	# the string to be escaped
+	#
+	# Output:
+	# the escaped string
+	#
+	def self.escape(string)
+		# gmosx: no need to return "" on nil, will be interpolated to ""
+		return nil unless string
+		return CGI::escapeHTML(string)
+	end
+
+	# TODO: move to markup!
+	#
+	# Expands the urls found in the given string. Use the target parameter
+	# to apply presentation semantics (ie open in new window)
+	#
+	# Example:
+	#  text = "visit this site: www.navel.gr"
+	#  text = Web::Utils::Html::expand_urls(text)
+	#  p text # =>
+	# "visit this site: <a href='http://www.navel.gr'>http://www.navel.gr</a>"
+	#
+	def self.expand_urls(string, target = nil)
+		return nil unless string
+
+		xstring = string.gsub(/\s(www\.[^\s]*)/, " http://\\1")
+		xstring.gsub!(/\s(ftp\.[^\s]*)/, " ftp://\\1")
+
+		xstring.gsub!(URI::REGEXP::ABS_URI_REF) { |uriref|
+			if /(http|ftp):/.match(uriref)
+				"<a" + (target.nil?? "" : " target='#{target}'") +
+						" href='#{uriref}'>#{uriref}</a>"
+			else
+				uriref
+			end
+		}
+
+		return xstring
+	end
+
+	# Strips potentially dangerous html tags, leaving only safe
+	# tags. Usefull for simple Html formatting.
+	#
+	# === Design:
+	#
+	# Escapes ALL quotes for security, use html without quotes:
+	#
+	# <font size=+1>kok</font>
+	# <a href=http://www.navel.gr
+	# ...
+	#
+	# Should handle the following case:
+	#
+	# <tr><td><a href='koko</td></tr>...
+	# passes with obvious results :(
+	# even the following fucks up browsers:
+	# <tr><td><p href='koko</td></tr>
+	#
+	# We HAVE TO CHECK VALID XHTML/XML before using this method.
+	#
+	# <img> is NOT a safe tag, because it can fuckup the
+	# layout, so it is not included in the default safe tags
+	#
+	# on open
+	#
+	# === Input:
+	# the string to be filtered
+	# extra exclude_tags
+	# extra include_tags
+	#
+	# === Output:
+	# the filtered string, only contains safe html tags
+
+	OPEN_TAGS = /<([^<>]*)(?=<)/
+	VALID_TAGS = /<([^<>]*)>(?=<)/
+	OPEN_QUOTES = /['"]([^'"]*)(?!['"])/
+
+	def self.only_safe_tags(string, exclude_tags = nil, include_tags = nil)
+		return nil unless string
+
+		# default safe tags
+		# FIXME: move the array outside of the method to avoid
+		# excessive array creation
+
+		safe_tags = ["A", "B", "I", "U", "BR", "STRONG", "LI"]
+
+		# customize if necessary
+		safe_tags += exclude_tags if exclude_tags
+		safe_tags -= include_tags if include_tags
+
+        # try to fix up invalid XHTML tags: close brackets, and
+		# escape quotes of open tags.
+		# SOS: keep the order of the escapes!
+
+		escaped = string.gsub(OPEN_TAGS, '<\1>')
+		escaped = CGI::escapeHTML(escaped)
+		escaped =  CGI::unescapeElement(escaped, safe_tags)
+		escaped.gsub!(/"/, '&quot;')
+		escaped.gsub!(/'/, '&#39;')
+
+		return escaped
+	end
+
+	# convert plain newlines into line breaks <br/>
+
+	def self.convert_newlines(string)
+		return nil unless N::StringUtils.valid?(string)
+		xstring = string.gsub(/\n/, "<br/>")
+		return xstring;
+	end
+		
+end
+
+end # module

data/lib/n/utils/http.rb

@@ -0,0 +1,98 @@
+# = HTTP utilities collection
+#
+# Some older functionality is removed, use open-uri instead.
+#
+# code:: tml, drak, ekarak
+#
+# (c) 2004 Navel, all rights reserved.
+# $Id: http.rb 71 2004-10-18 10:50:22Z gmosx $
+
+require "uri"
+require "cgi"
+require "net/http"
+
+module N
+
+module HTTP
+	# HTTP protocol EOL constants
+
+	CR = "\x0d"
+	LF = "\x0a"
+	CRLF = "\x0d\x0a"
+	EOL = CRLF
+
+	# Http protocol status codes maps.
+
+	# constants for readable code
+
+	STATUS_OK = 200
+	STATUS_PARTIAL_CONTENT = 206
+	STATUS_MOVED = 301
+	STATUS_REDIRECT = 302
+	STATUS_SEE_OTHER = 303			# gmosx: VERIFY THIS
+	STATUS_SEE_OTHER_307 = 307		# gmosx: VERIFY THIS
+	STATUS_NOT_MODIFIED = 304
+	STATUS_BAD_REQUEST = 400
+	STATUS_AUTH_REQUIRED = 401       
+	STATUS_FORBIDDEN = 403           
+	STATUS_NOT_FOUND = 404           
+	STATUS_METHOD_NOT_ALLOWED = 405  
+	STATUS_NOT_ACCEPTABLE = 406      
+	STATUS_LENGTH_REQUIRED = 411     
+	STATUS_PRECONDITION_FAILED = 412 
+	STATUS_SERVER_ERROR = 500        
+	STATUS_NOT_IMPLEMENTED = 501    
+	STATUS_BAD_GATEWAY = 502         
+	STATUS_VARIANT_ALSO_VARIES = 506 
+
+	# hash to allow id to description maping.
+
+	STATUS_STRINGS = {
+		200 => "OK",
+		206 => "Partial Content",
+		300 => "Multiple Choices",
+		301 => "Moved Permanently",
+		302 => "Found",
+		303 => "See other",			# gmosx: VERIFY THIS
+		304 => "Not Modified",
+		307 => "See other 07",		# gmosx: VERIFY THIS
+		400 => "Bad Request",
+		401 => "Authorization Required",
+		403 => "Forbidden",
+		404 => "Not Found",
+		405 => "Method Not Allowed",
+		406 => "Not Acceptable",
+		411 => "Length Required",
+		412 => "Rrecondition Failed",
+		500 => "Internal Server Error",
+		501 => "Method Not Implemented",
+		502 => "Bad Gateway",
+		506 => "Variant Also Negotiates"
+	}
+end
+
+# = HttpUtils
+#
+module HttpUtils
+
+	# Converts the given time object to an http time string.
+	# Example:
+	# Sat, 01 Jan 2000 00:00:00 GMT
+	#
+	def self.time_to_string(time)
+		return CGI::rfc1123_date(time)
+	end
+
+	# NOT IMPLEMENTED
+	#
+	# Converts an http time string to a time object.
+	# Example:
+	# Sat, 01 Jan 2000 00:00:00 GMT
+	#
+	def self.string_to_time(string)
+		raise "Not implemented"
+	end
+
+end	
+
+end # module