nice_password 1.0.0

data/Gemfile

@@ -0,0 +1,9 @@
+source "http://rubygems.org"
+
+group :development do
+  gem 'jeweler'
+end
+
+group :test do
+  gem 'rspec'
+end

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Nova Fabrica, Inc.
+
+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.rdoc

@@ -0,0 +1,75 @@
+=NicePassword
+
+NicePassword creates easy-to-remember but still somewhat secure passwords by mixing common words from a "safe" dictionary with random numbers. The password is easier to read and to remember than purely random strings of letters and numbers, making it "nicer" on users.  NicePassword is ideal whenever you need Rails to auto-generate a password for a user--such as after the user clicks a "send me a new password" link or as a "suggested password" on a password edit page.
+
+Examples of NicePasswords:
+  campaign34bone
+  parent492wheat
+  orbit8low5mix
+
+The dictionary contains a list of words which are reasonably safe for use in a corporate environment. For example, besides omitting obscene and slang words, words such as 'kill' and 'hate' are excluded.
+
+
+==Usage
+
+To generate a password just call NicePassword.new.
+
+  > NicePassword.new
+  # => basic34lesser
+
+Options that can be passed when creating a new NicePassword include:
+
+* :length - total number of characters, default is 12
+* :words - total number of words, between 1-4, default is 2
+* :digits - number of digits between each word (not the total number), default is 2
+* :language - abbreviation for language to use for the words, default is 'en' (English)
+* :dictionary - a custom dictionary (as an array) to use instead of the default dictionaries
+
+  > NicePassword.new(:language => 'fr', :length => 16, :words => 3, :digits => 3)
+  # => été826gris641rue
+
+
+==Languages and Dictionaries
+
+The included dictionaries are:
+* English: 'en'
+* French: 'fr'
+* Spanish: 'es'
+
+English is the default language.  You can set a different default language using:
+
+  NicePassword.default_language = 'fr'
+  
+Or you can choose a language on a case-by-case basis by passing in the language abbreviation as the value to the :language option (see Usage above).
+
+If you want to use your own dictionary (either with custom words or for another language), you just pass in an array of words as the value to the :dictionary option. You will want to make sure that your dictionary has several words of each length and includes single letters.
+
+
+==Security
+
+NicePassword passwords are not as secure as a random string would be--that is obvious.  However, they are much more secure than the passwords most users pick on their own.
+
+Random strings are hard to remember, easy to mistype and increase the likelihood that a user will switch to a very weak password at the first opportunity.  Because NicePasswords are much easy to remember, a user is more likely to keep them.  If they still opt to switch to a stronger or weaker password, then you are no worse off, but provided a better user experience.
+
+The inclusion of digits between the dictionary words is intended to make a brute force dictionary attack much harder. Increasing the number of digits between words, or the number of words with digits between them, will increase the security strength of the password.
+
+
+==Info
+  
+Authors: Kevin Skoglund & Matthew Bergman, Nova Fabrica, Inc.
+
+License: Copyright 2010 by Kevin Skoglund. released under the attached MIT-LICENSE. 
+
+GitHub: http://github.com/novafabrica/nice_password/tree/master
+
+
+==Bug Reports and Feedback
+
+Bug reports should be submitted at https://github.com/novafabrica/nice_password/issues
+
+Other feedback is welcomed at info@novafabrica.com
+
+
+==Warranty
+
+This software is provided "as is" and without any express or implied warranties, including, without limitation, the implied warranties of merchantability and fitness for a particular purpose.

data/Rakefile

@@ -0,0 +1,58 @@
+begin
+  # Rspec 1.3.0
+  require 'spec/rake/spectask'
+  desc 'Default: run specs'
+  task :default => :spec
+  Spec::Rake::SpecTask.new do |t|
+    t.spec_files = FileList["spec/**/*_spec.rb"]
+  end
+
+  Spec::Rake::SpecTask.new('rcov') do |t|
+    t.spec_files = FileList["spec/**/*_spec.rb"]
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec']
+  end
+  
+rescue LoadError
+  # Rspec 2.0
+  require 'rspec/core/rake_task'
+
+  desc 'Default: run specs'
+  task :default => :spec  
+  Rspec::Core::RakeTask.new do |t|
+    t.pattern = "spec/**/*_spec.rb"
+  end
+  
+  Rspec::Core::RakeTask.new('rcov') do |t|
+    t.pattern = "spec/**/*_spec.rb"
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec']
+  end
+
+rescue LoadError
+  puts "Rspec not available. Install it with: gem install rspec"  
+end
+
+namespace 'rails2.3' do
+  task :spec do
+    gemfile = File.join(File.dirname(__FILE__), 'lib', 'acts_as_taggable_on', 'compatibility', 'Gemfile')
+    ENV['BUNDLE_GEMFILE'] = gemfile
+    Rake::Task['spec'].invoke    
+  end
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "nice_password"
+    gemspec.summary = "Generate easy to read/remember passwords"
+    gemspec.description = "NicePassword creates easy-to-remember, reasonably-secure passwords by mixing dictionary words and random numbers."
+    gemspec.email = "kevin@novafabrica.com"
+    gemspec.homepage = "http://github.com/novafabrica/nice_password"
+    gemspec.authors = ["Kevin Skoglund", "Matthew Bergman"]
+    gemspec.files =  FileList["[A-Z]*", "{generators,lib,spec,rails}/**/*"] - FileList["**/*.log"]
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/lib/nice_password.rb

@@ -0,0 +1,5 @@
+require 'nice_password/core_ext'
+require 'nice_password/nice_password'
+require 'nice_password/errors'
+
+

data/lib/nice_password/core_ext.rb

@@ -0,0 +1,11 @@
+class Hash
+  
+  # Slice a hash to include only the given keys.
+  def slice(*keys)
+    keys = keys.map! { |key| convert_key(key) } if respond_to?(:convert_key)
+    hash = self.class.new
+    keys.each { |k| hash[k] = self[k] if has_key?(k) }
+    hash
+  end
+
+end

data/lib/nice_password/dictionaries/en.yml

@@ -0,0 +1,1330 @@
+---
+- a
+- able
+- about
+- above
+- accept
+- accident
+- accuse
+- across
+- act
+- activist
+- actor
+- add
+- administration
+- admit
+- advise
+- affect
+- afraid
+- after
+- again
+- against
+- age
+- agency
+- ago
+- agree
+- agriculture
+- aid
+- aim
+- air
+- airplane
+- airport
+- alive
+- all
+- ally
+- almost
+- alone
+- along
+- already
+- also
+- although
+- always
+- ambassador
+- amend
+- ammunition
+- among
+- amount
+- an
+- ancient
+- and
+- anger
+- animal
+- anniversary
+- announce
+- another
+- answer
+- any
+- apologize
+- appeal
+- appear
+- appoint
+- approve
+- area
+- argue
+- arms
+- army
+- around
+- arrest
+- arrive
+- art
+- artillery
+- as
+- ash
+- ask
+- assist
+- astronaut
+- asylum
+- at
+- atmosphere
+- atom
+- attack
+- attempt
+- attend
+- automobile
+- autumn
+- awake
+- award
+- away
+- b
+- back
+- bad
+- balance
+- ball
+- balloon
+- ballot
+- ban
+- bank
+- bar
+- base
+- battle
+- be
+- beach
+- beat
+- beauty
+- because
+- become
+- bed
+- beg
+- begin
+- behind
+- believe
+- bell
+- belong
+- below
+- best
+- better
+- between
+- big
+- bill
+- bird
+- bite
+- bitter
+- black
+- blame
+- blanket
+- bleed
+- blind
+- block
+- blood
+- blow
+- blue
+- boat
+- body
+- boil
+- bomb
+- bone
+- book
+- border
+- born
+- borrow
+- both
+- bottle
+- bottom
+- box
+- boy
+- brain
+- brave
+- bread
+- break
+- breathe
+- bridge
+- brief
+- bright
+- bring
+- broadcast
+- brother
+- brown
+- build
+- bullet
+- burn
+- burst
+- bury
+- bus
+- business
+- busy
+- but
+- buy
+- by
+- c
+- cabinet
+- call
+- calm
+- camera
+- campaign
+- can
+- cancel
+- candidate
+- cannon
+- capital
+- capture
+- car
+- care
+- careful
+- carry
+- case
+- cat
+- catch
+- cattle
+- cause
+- ceasefire
+- celebrate
+- cell
+- center
+- century
+- ceremony
+- chairman
+- champion
+- chance
+- change
+- charge
+- chase
+- cheat
+- check
+- cheer
+- chemicals
+- chief
+- child
+- choose
+- church
+- circle
+- citizen
+- city
+- civil
+- civilian
+- clash
+- clean
+- clear
+- clergy
+- climb
+- clock
+- close
+- cloth
+- clothes
+- cloud
+- coal
+- coalition
+- coast
+- coffee
+- cold
+- collect
+- colony
+- color
+- come
+- comedy
+- command
+- comment
+- committee
+- common
+- communicate
+- company
+- compete
+- complete
+- compromise
+- computer
+- concern
+- condemn
+- condition
+- conference
+- confirm
+- conflict
+- congratulate
+- congress
+- connect
+- conservative
+- consider
+- contain
+- continent
+- continue
+- control
+- convention
+- cook
+- cool
+- cooperate
+- copy
+- correct
+- cost
+- constitution
+- cotton
+- count
+- country
+- court
+- cover
+- cow
+- crash
+- create
+- creature
+- credit
+- crew
+- crime
+- criminal
+- crisis
+- criticize
+- crops
+- cross
+- crowd
+- crush
+- cry
+- culture
+- cure
+- current
+- custom
+- cut
+- d
+- dam
+- damage
+- dance
+- danger
+- dark
+- date
+- daughter
+- day
+- deal
+- debate
+- decide
+- declare
+- deed
+- deep
+- defeat
+- defend
+- deficit
+- degree
+- delay
+- delegate
+- demand
+- democracy
+- demonstrate
+- denounce
+- deny
+- depend
+- deploy
+- describe
+- desert
+- design
+- desire
+- details
+- develop
+- device
+- different
+- difficult
+- dig
+- dinner
+- diplomat
+- direct
+- direction
+- disappear
+- disarm
+- discover
+- discuss
+- dismiss
+- dispute
+- dissident
+- distance
+- distant
+- dive
+- divide
+- do
+- doctor
+- document
+- dollar
+- door
+- down
+- draft
+- dream
+- drink
+- drive
+- drown
+- dry
+- during
+- dust
+- duty
+- e
+- each
+- early
+- earn
+- earth
+- earthquake
+- ease
+- east
+- eat
+- economy
+- edge
+- educate
+- effect
+- effort
+- egg
+- either
+- elect
+- electricity
+- electron
+- element
+- embassy
+- emergency
+- emotion
+- employ
+- empty
+- end
+- enemy
+- energy
+- enforce
+- engine
+- engineer
+- enjoy
+- enough
+- enter
+- equipment
+- equal
+- escape
+- especially
+- establish
+- even
+- event
+- ever
+- every
+- evidence
+- evil
+- environment
+- exact
+- examine
+- example
+- excellent
+- except
+- exchange
+- excite
+- excuse
+- execute
+- exile
+- exist
+- expand
+- expect
+- expel
+- experiment
+- expert
+- explain
+- explode
+- explore
+- export
+- express
+- extend
+- extra
+- extreme
+- f
+- face
+- fact
+- factory
+- fail
+- fair
+- fall
+- family
+- famous
+- fanatic
+- far
+- farm
+- fast
+- father
+- fear
+- feast
+- federal
+- feed
+- feel
+- few
+- field
+- fierce
+- fight
+- fill
+- film
+- final
+- find
+- fine
+- finish
+- fire
+- firm
+- first
+- fish
+- fix
+- flag
+- flat
+- flee
+- float
+- flood
+- floor
+- flow
+- flower
+- fluid
+- fly
+- fog
+- follow
+- food
+- foot
+- for
+- force
+- forget
+- forgive
+- form
+- former
+- forward
+- free
+- freeze
+- fresh
+- friend
+- frighten
+- from
+- front
+- fruit
+- fuel
+- funeral
+- furious
+- future
+- g
+- gain
+- game
+- gas
+- gather
+- general
+- gentle
+- get
+- gift
+- girl
+- give
+- glass
+- go
+- goal
+- gold
+- good
+- goodbye
+- goods
+- govern
+- government
+- grain
+- grandfather
+- grandmother
+- grass
+- gray
+- great
+- green
+- grind
+- ground
+- group
+- grow
+- guarantee
+- guard
+- guerilla
+- guide
+- guilty
+- gun
+- h
+- hair
+- half
+- halt
+- hang
+- happen
+- happy
+- harbor
+- hard
+- harm
+- hat
+- head
+- headquarters
+- health
+- hear
+- heart
+- heat
+- heavy
+- helicopter
+- help
+- here
+- hero
+- hide
+- high
+- hill
+- history
+- hit
+- hold
+- hole
+- holiday
+- holy
+- home
+- honest
+- honor
+- hope
+- horse
+- hospital
+- hot
+- hotel
+- hour
+- house
+- how
+- however
+- huge
+- human
+- humor
+- hunger
+- hunt
+- hurry
+- hurt
+- husband
+- i
+- ice
+- idea
+- if
+- imagine
+- immediate
+- import
+- important
+- improve
+- in
+- incident
+- incite
+- include
+- increase
+- independent
+- industry
+- inflation
+- influence
+- inform
+- injure
+- innocent
+- insect
+- inspect
+- instead
+- instrument
+- insult
+- intelligent
+- intense
+- interest
+- interfere
+- international
+- intervene
+- invade
+- invent
+- invest
+- investigate
+- invite
+- involve
+- iron
+- island
+- issue
+- it
+- j
+- jail
+- jewel
+- job
+- join
+- joint
+- joke
+- judge
+- jump
+- jungle
+- jury
+- just
+- k
+- keep
+- kick
+- kind
+- kiss
+- knife
+- know
+- l
+- labor
+- laboratory
+- lack
+- lake
+- land
+- language
+- large
+- last
+- late
+- laugh
+- launch
+- law
+- lead
+- leak
+- learn
+- leave
+- left
+- legal
+- lend
+- less
+- let
+- letter
+- level
+- liberal
+- lie
+- life
+- light
+- lightning
+- like
+- limit
+- line
+- link
+- liquid
+- list
+- listen
+- little
+- live
+- load
+- local
+- lonely
+- long
+- look
+- lose
+- loud
+- love
+- low
+- loyal
+- luck
+- m
+- machine
+- mad
+- mail
+- main
+- major
+- majority
+- make
+- male
+- man
+- map
+- march
+- mark
+- marker
+- mass
+- material
+- may
+- mayor
+- measure
+- medicine
+- meet
+- melt
+- member
+- memorial
+- memory
+- mercy
+- message
+- metal
+- method
+- microscope
+- middle
+- military
+- milk
+- mind
+- mine
+- mineral
+- minister
+- minor
+- minute
+- miss
+- missile
+- missing
+- mistake
+- mix
+- moderate
+- modern
+- money
+- month
+- moon
+- more
+- morning
+- most
+- mother
+- motion
+- mountain
+- mourn
+- move
+- much
+- music
+- must
+- mystery
+- n
+- name
+- nation
+- navy
+- near
+- necessary
+- need
+- negotiate
+- neither
+- nerve
+- neutral
+- never
+- new
+- news
+- next
+- nice
+- night
+- "no"
+- noise
+- nominate
+- noon
+- normal
+- north
+- not
+- note
+- nothing
+- now
+- nowhere
+- number
+- nurse
+- o
+- obey
+- object
+- observe
+- occupy
+- ocean
+- of
+- "off"
+- offer
+- officer
+- official
+- often
+- oil
+- old
+- "on"
+- once
+- only
+- open
+- operate
+- opinion
+- oppose
+- opposite
+- or
+- orbit
+- orchestra
+- order
+- organize
+- other
+- oust
+- out
+- over
+- owe
+- own
+- p
+- pain
+- paint
+- palace
+- pamphlet
+- pan
+- paper
+- parachute
+- parade
+- pardon
+- parent
+- parliament
+- part
+- party
+- pass
+- passenger
+- passport
+- past
+- path
+- pay
+- peace
+- people
+- percent
+- perfect
+- perhaps
+- period
+- permanent
+- permit
+- person
+- physics
+- piano
+- picture
+- piece
+- pilot
+- pipe
+- pirate
+- place
+- planet
+- plant
+- play
+- please
+- plenty
+- plot
+- poem
+- point
+- police
+- policy
+- politics
+- pollute
+- popular
+- population
+- port
+- position
+- possess
+- possible
+- postpone
+- pour
+- power
+- praise
+- pray
+- prepare
+- present
+- president
+- press
+- pressure
+- prevent
+- price
+- priest
+- private
+- prize
+- probably
+- problem
+- produce
+- professor
+- program
+- progress
+- project
+- promise
+- property
+- propose
+- protect
+- protest
+- proud
+- prove
+- provide
+- public
+- publication
+- publish
+- pull
+- pump
+- punish
+- purchase
+- pure
+- purpose
+- push
+- put
+- q
+- question
+- quick
+- quiet
+- r
+- rabbi
+- race
+- radar
+- radiation
+- radio
+- raid
+- railroad
+- rain
+- raise
+- rapid
+- rare
+- rate
+- reach
+- read
+- ready
+- real
+- realistic
+- reason
+- reasonable
+- rebel
+- receive
+- recent
+- recognize
+- record
+- red
+- reduce
+- reform
+- refuse
+- regret
+- relationship
+- release
+- religion
+- remain
+- remember
+- remove
+- repair
+- repeat
+- report
+- repress
+- request
+- rescue
+- resolution
+- responsible
+- rest
+- restrain
+- restrict
+- result
+- return
+- revolt
+- rich
+- ride
+- right
+- riot
+- rise
+- river
+- road
+- rock
+- rocket
+- roll
+- room
+- root
+- rope
+- rough
+- round
+- rub
+- rubber
+- ruin
+- rule
+- run
+- s
+- sacrifice
+- sad
+- safe
+- sail
+- salt
+- same
+- satellite
+- satisfy
+- save
+- say
+- school
+- science
+- scream
+- sea
+- search
+- season
+- seat
+- second
+- secret
+- security
+- see
+- seek
+- seem
+- seize
+- self
+- sell
+- senate
+- send
+- sense
+- sentence
+- separate
+- series
+- serious
+- sermon
+- serve
+- set
+- settle
+- several
+- severe
+- shake
+- shape
+- share
+- sharp
+- shell
+- shine
+- ship
+- shock
+- shoe
+- shoot
+- short
+- should
+- shout
+- show
+- shrink
+- shut
+- side
+- sign
+- signal
+- silence
+- silver
+- similar
+- simple
+- since
+- sing
+- sink
+- sister
+- sit
+- situation
+- size
+- skeleton
+- skill
+- sky
+- sleep
+- slide
+- slow
+- small
+- smash
+- smell
+- smile
+- smoke
+- smooth
+- snow
+- so
+- social
+- soft
+- soldier
+- solid
+- solve
+- some
+- son
+- soon
+- sorry
+- sort
+- sound
+- south
+- space
+- speak
+- special
+- speed
+- spend
+- spill
+- spilt
+- spirit
+- split
+- sports
+- spread
+- spring
+- spy
+- stamp
+- stand
+- star
+- start
+- state
+- station
+- statue
+- stay
+- steal
+- steam
+- steel
+- step
+- stick
+- still
+- stomach
+- stone
+- stop
+- store
+- storm
+- story
+- stove
+- straight
+- strange
+- street
+- stretch
+- strike
+- strong
+- struggle
+- study
+- stupid
+- submarine
+- substance
+- substitute
+- subversion
+- succeed
+- such
+- sudden
+- suffer
+- sugar
+- summer
+- sun
+- supervise
+- supply
+- support
+- suppose
+- suppress
+- sure
+- surplus
+- surprise
+- surround
+- survive
+- suspect
+- suspend
+- swear
+- sweet
+- swim
+- sympathy
+- system
+- t
+- take
+- talk
+- tall
+- tank
+- target
+- task
+- taste
+- tax
+- teach
+- team
+- tear
+- tears
+- technical
+- telephone
+- telescope
+- television
+- tell
+- temperature
+- temporary
+- tense
+- term
+- territory
+- test
+- textiles
+- than
+- thank
+- that
+- the
+- theater
+- then
+- there
+- thick
+- thin
+- thing
+- think
+- third
+- this
+- threaten
+- through
+- throw
+- tie
+- time
+- tissue
+- to
+- today
+- together
+- tomorrow
+- tonight
+- too
+- tool
+- top
+- touch
+- toward
+- town
+- trade
+- tradition
+- tragic
+- train
+- transport
+- trap
+- travel
+- treasure
+- treat
+- treaty
+- tree
+- trial
+- tribe
+- trick
+- trip
+- troops
+- trouble
+- truce
+- truck
+- trust
+- try
+- turn
+- u
+- under
+- understand
+- unite
+- universe
+- university
+- unless
+- until
+- up
+- urge
+- urgent
+- use
+- usual
+- v
+- valley
+- value
+- vehicle
+- version
+- veto
+- victory
+- village
+- violin
+- virus
+- visit
+- voice
+- volcano
+- vote
+- voyage
+- w
+- wages
+- wait
+- walk
+- wall
+- want
+- war
+- warm
+- warn
+- wash
+- waste
+- watch
+- water
+- wave
+- way
+- wealth
+- weapon
+- wear
+- weather
+- weigh
+- welcome
+- well
+- west
+- wet
+- what
+- wheat
+- wheel
+- when
+- where
+- which
+- while
+- white
+- who
+- why
+- wide
+- wife
+- wild
+- will
+- willing
+- win
+- wind
+- window
+- wire
+- wise
+- wish
+- with
+- withdraw
+- without
+- wonder
+- wood
+- woods
+- word
+- work
+- world
+- worry
+- worse
+- wreck
+- write
+- wrong
+- x
+- y
+- year
+- yellow
+- "yes"
+- yesterday
+- yet
+- you
+- young
+- z
+- zebra