permalink_fu 1.0.0

data/README.markdown

@@ -0,0 +1,64 @@
+# PermalinkFu
+
+A simple plugin for creating URL-friendly permalinks (slugs) from attributes.
+
+Uses [`ActiveSupport::Multibyte::Handlers::UTF8Handler`](http://api.rubyonrails.org/classes/ActiveSupport/Multibyte/Handlers/UTF8Handler.html) (part of Rails since 1.2) rather than `iconv` (which is [inconsistent between platforms](http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/243426)) for normalization/decomposition.
+
+
+## Usage
+
+    class Article < ActiveRecord::Base
+      has_permalink :title
+    end
+
+This will escape the title in a before_validation callback, turning e.g. "Föö!! Bàr" into "foo-bar".
+
+The permalink is by default stored in the `permalink` attribute.
+
+    has_permalink :title, :as => :slug
+  
+will store it in `slug` instead.
+
+    has_permalink [:category, :title]
+  
+will store a permalink form of `"#{category}-#{title}"`.
+
+Permalinks are guaranteed unique: "foo-bar-2", "foo-bar-3" etc are used if there are conflicts. You can set the scope of the uniqueness like
+
+    has_permalink :title, :scope => :blog_id
+
+This means that two articles with the same `blog_id` can not have the same permalink, but two articles with different `blog_id`s can.
+
+Two finders are provided:
+
+    Article.find_by_permalink(params[:id])
+    Article.find_by_permalink!(params[:id])
+    
+These methods keep their name no matter what attribute is used to store the permalink.
+
+The `find_by_permalink` method returns `nil` if there is no match; the `find_by_permalink!` method will raise `ActiveRecord::RecordNotFound`.
+
+You can override the model's `to_param` method with
+
+    has_permalink :title, :param => true
+    
+This means that the permalink will be used instead of the primary key (id) in generated URLs. Remember to change your controller code from e.g. `find` to `find_by_permalink!`.
+
+You can add conditions to `has_permalink` like so:
+
+  	class Article < ActiveRecord::Base
+  	  has_permalink :title, :if => Proc.new { |article| article.needs_permalink? }
+  	end
+
+Use the `:if` or `:unless` options to specify a Proc, method, or string to be called or evaluated. The permalink will only be generated if the option evaluates to true.
+
+You can use `PermalinkFu.escape` to escape a string manually.
+
+
+## Credits
+
+Originally extracted from [Mephisto](http://mephistoblog.com) by [technoweenie](http://github.com/technoweenie/permalink_fu/).
+
+Conditions added by [Pat Nakajima](http://github.com/nakajima/permalink_fu/).
+
+[Henrik Nyh](http://github.com/technoweenie/permalink_fu/) replaced `iconv` with `ActiveSupport::Multibyte`.

data/lib/data/x00.yml

@@ -0,0 +1,257 @@
+---
+- "\z"
+- "\x01"
+- "\x02"
+- "\x03"
+- "\x04"
+- "\x05"
+- "\x06"
+- "\a"
+- "\x08"
+- '	'
+- "\n"
+- "\v"
+- "\f"
+- "\r"
+- "\x0e"
+- "\x0f"
+- "\x10"
+- "\x11"
+- "\x12"
+- "\x13"
+- "\x14"
+- "\x15"
+- "\x16"
+- "\x17"
+- "\x18"
+- "\x19"
+- "\x1a"
+- "\e"
+- "\x1c"
+- "\x1d"
+- "\x1e"
+- "\x1f"
+- ' '
+- '!'
+- '"'
+- '#'
+- $
+- '%'
+- '&'
+- "'"
+- (
+- )
+- '*'
+- +
+- ','
+- -
+- .
+- /
+- 0
+- 1
+- 2
+- 3
+- 4
+- 5
+- 6
+- 7
+- 8
+- 9
+- ':'
+- ;
+- <
+- =
+- '>'
+- '?'
+- '@'
+- A
+- B
+- C
+- D
+- E
+- F
+- G
+- H
+- I
+- J
+- K
+- L
+- M
+- N
+- O
+- P
+- Q
+- R
+- S
+- T
+- U
+- V
+- W
+- X
+- Y
+- Z
+- ']'
+- \
+- ']'
+- '^'
+- _
+- '`'
+- a
+- b
+- c
+- d
+- e
+- f
+- g
+- h
+- i
+- j
+- k
+- l
+- m
+- n
+- o
+- p
+- q
+- r
+- s
+- t
+- u
+- v
+- w
+- x
+- y
+- z
+- '{'
+- '|'
+- '}'
+- '~'
+- 
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ''
+- ' '
+- '!'
+- C/
+- PS
+- $?
+- Y=
+- '|'
+- SS
+- '"'
+- (c)
+- a
+- <<
+- '!'
+- ''
+- (r)
+- -
+- deg
+- +-
+- 2
+- 3
+- "'"
+- u
+- P
+- '*'
+- ','
+- 1
+- o
+- '>>'
+- 1/4
+- 1/2
+- 3/4
+- '?'
+- A
+- A
+- A
+- A
+- A
+- A
+- AE
+- C
+- E
+- E
+- E
+- E
+- I
+- I
+- I
+- I
+- D
+- N
+- O
+- O
+- O
+- O
+- O
+- x
+- O
+- U
+- U
+- U
+- U
+- U
+- Th
+- ss
+- a
+- a
+- a
+- a
+- a
+- a
+- ae
+- c
+- e
+- e
+- e
+- e
+- i
+- i
+- i
+- i
+- d
+- n
+- o
+- o
+- o
+- o
+- o
+- /
+- o
+- u
+- u
+- u
+- u
+- y
+- th
+- y

data/lib/data/x01.yml

@@ -0,0 +1,257 @@
+---
+- A
+- a
+- A
+- a
+- A
+- a
+- C
+- c
+- C
+- c
+- C
+- c
+- C
+- c
+- D
+- d
+- D
+- d
+- E
+- e
+- E
+- e
+- E
+- e
+- E
+- e
+- E
+- e
+- G
+- g
+- G
+- g
+- G
+- g
+- G
+- g
+- H
+- h
+- H
+- h
+- I
+- i
+- I
+- i
+- I
+- i
+- I
+- i
+- I
+- i
+- IJ
+- ''
+- J
+- j
+- K
+- k
+- k
+- L
+- l
+- L
+- l
+- L
+- l
+- L
+- l
+- L
+- l
+- N
+- n
+- N
+- n
+- N
+- n
+- "'n"
+- ng
+- NG
+- O
+- o
+- O
+- o
+- O
+- o
+- OE
+- oe
+- R
+- r
+- R
+- r
+- R
+- r
+- S
+- s
+- S
+- s
+- S
+- s
+- S
+- s
+- T
+- t
+- T
+- t
+- T
+- t
+- U
+- u
+- U
+- u
+- U
+- u
+- U
+- u
+- U
+- u
+- U
+- u
+- W
+- w
+- Y
+- y
+- Y
+- Z
+- z
+- Z
+- z
+- Z
+- z
+- s
+- b
+- B
+- B
+- b
+- 6
+- 6
+- O
+- C
+- c
+- D
+- D
+- D
+- d
+- d
+- 3
+- '@'
+- E
+- F
+- f
+- G
+- G
+- hv
+- I
+- I
+- K
+- k
+- l
+- l
+- W
+- N
+- n
+- O
+- O
+- o
+- OI
+- oi
+- P
+- p
+- YR
+- 2
+- 2
+- SH
+- sh
+- t
+- T
+- t
+- T
+- U
+- u
+- Y
+- V
+- Y
+- y
+- Z
+- z
+- ZH
+- ZH
+- zh
+- zh
+- 2
+- 5
+- 5
+- ts
+- w
+- '|'
+- '||'
+- '|='
+- '!'
+- DZ
+- Dz
+- dz
+- LJ
+- Lj
+- lj
+- NJ
+- Nj
+- nj
+- A
+- a
+- I
+- i
+- O
+- o
+- U
+- u
+- U
+- u
+- U
+- u
+- U
+- u
+- U
+- u
+- '@'
+- A
+- a
+- A
+- a
+- AE
+- ae
+- G
+- g
+- G
+- g
+- K
+- k
+- O
+- o
+- O
+- o
+- ZH
+- zh
+- j
+- DZ
+- D
+- dz
+- G
+- g
+- HV
+- W
+- N
+- n
+- A
+- a
+- AE
+- ae
+- O
+- o