data-anonymization 0.3.0 → 0.5.0

data/.gitignore

@@ -17,4 +17,5 @@ test/version_tmp
 tmp
 .idea
 sample-data/chinook-empty.sqlite
-tmp
+tmp
+examples/mongodb_whitelist_generated.rb

data/.rvmrc

@@ -1 +1 @@
-rvm use 1.9.3-p125@data-anon --create
+rvm use 1.9.3@data-anon --create

data/.travis.yml

@@ -1,4 +1,6 @@
 language: ruby
+services:
+  - mongodb
 before_script: rake empty_dest
 rvm:
   - 1.9.2

data/Gemfile

@@ -8,5 +8,7 @@ group :development, :test do
   gem 'rspec'
   gem 'pry'
   gem 'sqlite3'
+  gem 'mongo'
+  gem 'bson_ext'
 end
 

data/README.md

@@ -1,7 +1,12 @@
 # Data::Anonymization
 Tool to create anonymized production data dump to use for PERF and other TEST environments.
 
+[<img src="https://secure.travis-ci.org/sunitparekh/data-anonymization.png?branch=master">](http://travis-ci.org/sunitparekh/data-anonymization)
+[<img src="https://gemnasium.com/sunitparekh/data-anonymization.png?travis">](https://gemnasium.com/sunitparekh/data-anonymization)
+[<img src="https://codeclimate.com/badge.png">](https://codeclimate.com/github/sunitparekh/data-anonymization)
+
 ## Getting started
+
 Install gem using:
 
     $ gem install data-anonymization
@@ -39,15 +44,42 @@ Run using:
 
     $ ruby my_dsl.rb
 
+Liked it? please share
+
+[<img src="https://si0.twimg.com/a/1346446870/images/resources/twitter-bird-light-bgs.png" height="35" width="35">](https://twitter.com/share?text=A+simple+ruby+DSL+based+data+anonymization&url=http:%2F%2Fsunitparekh.github.com%2Fdata-anonymization&via=dataanon&hashtags=dataanon)
+
 ## Examples
 
-1. [Whitelist using Chinoook sample database](https://github.com/sunitparekh/data-anonymization/blob/master/whitelist_dsl.rb)
-2. [Blacklist using Chinoook sample database](https://github.com/sunitparekh/data-anonymization/blob/master/blacklist_dsl.rb)
-3. [Whitelist with composite primary key using DellStore sample database](https://github.com/sunitparekh/test-anonymization/blob/master/dell_whitelist.rb)
-4. [Blacklist with composite primary key using DellStore sample database](https://github.com/sunitparekh/test-anonymization/blob/master/dell_blacklist.rb)
+SQLite database
+
+1. [Whitelist](https://github.com/sunitparekh/data-anonymization/blob/master/examples/whitelist_dsl.rb)
+2. [Blacklist](https://github.com/sunitparekh/data-anonymization/blob/master/examples/blacklist_dsl.rb)
+
+MongoDB
+
+1. [Whitelist](https://github.com/sunitparekh/data-anonymization/blob/master/examples/mongodb_whitelist_dsl.rb)
+2. [Blacklist](https://github.com/sunitparekh/data-anonymization/blob/master/examples/mongodb_blacklist_dsl.rb)
+
+Postgresql database having **composite primary key**
+
+1. [Whitelist](https://github.com/sunitparekh/test-anonymization/blob/master/dell_whitelist.rb)
+2. [Blacklist](https://github.com/sunitparekh/test-anonymization/blob/master/dell_blacklist.rb)
+
 
 ## Changelog
 
+#### 0.5.0 (rc1 released. install gem using --pre option)
+
+Major changes:
+
+1. MongoDB support
+2. Command line utility to generate whitelist DSL for RDBMS & MongoDB (reduces pain for writing whitelist dsl)
+3. Added support for reporting fields missing mapping in case of whitelist
+4. Errors reported at the end of process. Job doesn't fail for a single error.
+
+
+Please see the [Github 0.5.0 milestone page](https://github.com/sunitparekh/data-anonymization/issues?milestone=2&state=open) for more details on changes/fixes in release 0.5.0
+
 #### 0.3.0 (Sep 4, 2012)
 
 Major changes:
@@ -56,7 +88,7 @@ Major changes:
 2. Change in default String strategy from LoremIpsum to RandomString based on end user feedback.
 3. Fixed issue with table column name 'type' as this is default name for STI in activerecord.
 
-Please see the [Github 0.3.0 milestone page](https://github.com/sunitparekh/data-anonymization/issues?milestone=1&page=1&state=open) for more details on changes/fixes in release 0.3.0
+Please see the [Github 0.3.0 milestone page](https://github.com/sunitparekh/data-anonymization/issues?milestone=1&state=closed) for more details on changes/fixes in release 0.3.0
 
 #### 0.2.0 (August 16, 2012)
 
@@ -71,15 +103,10 @@ Please see the [Github 0.3.0 milestone page](https://github.com/sunitparekh/data
 
 ## Roadmap
 
-#### 0.4.0
-
-1. MongoDB anonymization support (NoSQL document based database support)
+MVP done. Fix defects and support queries, suggestions, enhancements logged in Github issues :-)
 
-#### 0.5.0
+## Share feedback
 
-1. Generate DSL from database and build schema from source as part of Whitelist approach.
-
-#### Share feedback
 Please use Github [issues](https://github.com/sunitparekh/data-anonymization/issues) to share feedback, feature suggestions and report issues.
 
 ## What is data anonymization?
@@ -126,295 +153,305 @@ end
 2. Change [default field strategies](#default-field-strategies) to avoid using same strategy again and again in your DSL.
 3. To run anonymization in parallel at Table level, provided no FK constraint on tables use DataAnon::Parallel::Table strategy
 
-## Running in Parallel
-Currently provides capability of running anonymization in parallel at table level provided no FK constraints on tables.
-It uses [Parallel gem](https://github.com/grosser/parallel) provided by Michael Grosser.
-By default it starts multiple parallel ruby processes processing table one by one.
-```ruby
-database 'DellStore' do
-  strategy DataAnon::Strategy::Whitelist
-  execution_strategy DataAnon::Parallel::Table  # by default sequential table processing
-  ...
-end
-```
+## DSL Generation
 
+We provide a command line tool to generate whitelist scripts for RDBMS and NoSQL databases. The user needs to supply the connection details to the database and a script is generated by analyzing the schema. Below are examples of how to use the tool to generate the scripts for RDBMS and NoSQL datastores
 
-## DataAnon::Core::Field
-The object that gets passed along with the field strategies.
-
-has following attribute accessor
+When you install the data-anonymization tool, the **datanon** command become available on the terminal. If you type **datanon --help** and execute you should see the below
 
-- `name` current field/column name
-- `value` current field/column value
-- `row_number` current row number
-- `ar_record` active record of the current row under processing
-
-## Field Strategies
+```
+Tasks:
 
-### LoremIpsum
-Default anonymization strategy for `string` content. Uses default 'Lorem ipsum...' text or text supplied in strategy to generate same length string.
+datanon generate_mongo_dsl -d, --database=DATABASE -h, --host=HOST                        # Generates a base anonymization script(whitelist strategy) for a Mongo DB using the database schema
+datanon generate_rdbms_dsl -a, --adapter=ADAPTER -d, --database=DATABASE -h, --host=HOST  # Generates a base anonymization script(whitelist strategy) for a RDBMS database using the database schema
+datanon help [TASK]                                                                       # Describe available tasks or one specific task
 
-```ruby
-anonymize('UserName').using FieldStrategy::LoremIpsum.new
-```
-```ruby
-anonymize('UserName').using FieldStrategy::LoremIpsum.new("very large string....")
-```
-```ruby
-anonymize('UserName').using FieldStrategy::LoremIpsum.new(File.read('my_file.txt'))
 ```
 
-### RandomString
-Generates random string of same length.
-```ruby
-anonymize('UserName').using FieldStrategy::RandomString.new
-```
+### RDBMS whitelist generation
 
-### StringTemplate
-Simple string evaluation within [DataAnon::Core::Field](#dataanon-core-field) context. Can be used for email, username anonymization.
-Make sure to put the string in 'single quote' else it will get evaluated inline.
-```ruby
-anonymize('UserName').using FieldStrategy::StringTemplate.new('user#{row_number}')
-```
-```ruby
-anonymize('Email').using FieldStrategy::StringTemplate.new('valid.address+#{row_number}@gmail.com')
-```
-```ruby
-anonymize('Email').using FieldStrategy::StringTemplate.new('useremail#{row_number}@mailinator.com')
-```
+The gem uses ActiveRecord(AR) abstraction to connect to relational databases. You can generate a whitelist script in seconds for any relational database supported by Active Record. To do so use the following command
 
-### SelectFromList
-Select randomly one of the values specified.
-```ruby
-anonymize('State').using FieldStrategy::SelectFromList.new(['New York','Georgia',...])
-```
-```ruby
-anonymize('NameTitle').using FieldStrategy::SelectFromList.new(['Mr','Mrs','Dr',...])
 ```
+datanon generate_rdbms_dsl [options]
 
-### SelectFromFile
-Similar to SelectFromList only difference is the list of values are picked up from file. Classical usage is like states field anonymization.
-```ruby
-anonymize('State').using FieldStrategy::SelectFromFile.new('states.txt')
 ```
 
-### FormattedStringNumber
-Keeping the format same it changes each digit in the string with random digit.
-```ruby
-anonymize('CreditCardNumber').using FieldStrategy::FormattedStringNumber.new
-```
+The options available are :
 
-### SelectFromDatabase
-Similar to SelectFromList with difference is the list of values are collected from the database table using distinct column query.
-```ruby
-# values are collected using `select distinct state from customers` query
-anonymize('State').using FieldStrategy::SelectFromDatabase.new('customers','state')
-```
+1. adapter(-a)  : The activerecord adapter to use to connect to the database (eg. mysql2, postgresql)
+2. host(-h)     : DB host name or IP address
+3. database(-d) : The name of the database to generate the whitelist script for
+4. username(-u) : Username for DB authentication
+5. password(-w) : Password for DB authentication
+6. port(-p)     : The port the database service is running on. Default port provided by AR will be used if 				   nothing is specififed.
 
-### RandomAddress
-Generates address using the [geojson](http://www.geojson.org/geojson-spec.html) format file. The default US/UK file chooses randomly from 300 addresses.
-The large data set can be downloaded from [here](http://www.infochimps.com/datasets/simplegeo-places-dump)
-```ruby
-anonymize('Address').using FieldStrategy::RandomAddress.region_US
-```
-```ruby
-anonymize('Address').using FieldStrategy::RandomAddress.region_UK
-```
-```ruby
-# get your own geo_json file and use it
-anonymize('Address').using FieldStrategy::RandomAddress.new('my_geo_json.json')
-```
+The adapter, host and database options are mandatory. The others are optional.
 
-### RandomCity
-Similar to RandomAddress, generates city using the [geojson](http://www.geojson.org/geojson-spec.html) format file. The default US/UK file chooses randomly from 300 addresses.
-The large data set can be downloaded from [here](http://www.infochimps.com/datasets/simplegeo-places-dump)
-```ruby
-anonymize('City').using FieldStrategy::RandomCity.region_US
-```
-```ruby
-anonymize('City').using FieldStrategy::RandomCity.region_UK
-```
-```ruby
-# get your own geo_json file and use it
-anonymize('City').using FieldStrategy::RandomCity.new('my_geo_json.json')
-```
+A few examples of the command is shown below
 
-### RandomProvince
-Similar to RandomAddress, generates province using the [geojson](http://www.geojson.org/geojson-spec.html) format file. The default US/UK file chooses randomly from 300 addresses.
-The large data set can be downloaded from [here](http://www.infochimps.com/datasets/simplegeo-places-dump)
-```ruby
-anonymize('Province').using FieldStrategy::RandomProvince.region_US
-```
-```ruby
-anonymize('Province').using FieldStrategy::RandomProvince.region_UK
-```
-```ruby
-# get your own geo_json file and use it
-anonymize('Province').using FieldStrategy::RandomProvince.new('my_geo_json.json')
 ```
+datanon generate_rdbms_dsl -a mysql2 -h db.host.com -p 3306 -d production_db -u root -w password
 
-### RandomZipcode
-Similar to RandomAddress, generates zipcode using the [geojson](http://www.geojson.org/geojson-spec.html) format file. The default US/UK file chooses randomly from 300 addresses.
-The large data set can be downloaded from [here](http://www.infochimps.com/datasets/simplegeo-places-dump)
-```ruby
-anonymize('Address').using FieldStrategy::RandomZipcode.region_US
-```
-```ruby
-anonymize('Address').using FieldStrategy::RandomZipcode.region_UK
-```
-```ruby
-# get your own geo_json file and use it
-anonymize('Address').using FieldStrategy::RandomZipcode.new('my_geo_json.json')
-```
+datanon generate_rdbms_dsl -a postgresql -h 123.456.7.8 -d production_db
 
-### RandomPhoneNumber
-Keeping the format same it changes each digit in the string with random digit.
-```ruby
-anonymize('PhoneNumber').using FieldStrategy::RandomPhoneNumber.new
 ```
 
-### AnonymizeDateTime
-Anonymizes each field(except year and seconds) within the natural range (e.g. hour between 1-24 and day within the month) based on true/false
-input for that field. By default, all fields are anonymized.
-```ruby
-#anonymizes month and hour fields, leaving the day and minute fields untouched
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDateTime.new(true,false,true,false)
-```
+The relevant db gems must be installed so that AR has the adapters required to establish the connection to the databases. The script generates a file named **rdbms_whitelist_generated.rb** in the same location as the project.  
 
-In addition to customizing which fields you want anonymized, there are some helper methods which allow for quick anonymization
-```ruby
-# anonymizes only the month field
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDateTime.only_month
-# anonymizes only the day field
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDateTime.only_day
-# anonymizes only the hour field
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDateTime.only_hour
-# anonymizes only the minute field
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDateTime.only_minute
-```
+### MongoDB whitelist generation
 
-### AnonymizeTime
-Exactly similar to the above DateTime strategy, except that the returned object is of type `Time`
+Similar to the the relational databases, a whitelist script for mongo db can be generated by analysing the database structure
 
-### AnonymizeDate
-Anonmizes day and month fields within natural range based on true/false input for that field. By defaut both fields are
-anonymized
-```ruby
-# anonymizes month and leaves day unchanged
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDate.new(true,false)
 ```
+datanon generate_mongo_dsl [options]
 
-In addition to customizing which fields you want anonymized, there are some helper methods which allow for quick anonymization
-```ruby
-# anonymizes only the month field
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDate.only_month
-# anonymizes only the day field
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDate.only_day
 ```
 
-### DateTimeDelta
-Shifts data randomly within given range. Default shifts date within 10 days + or - and shifts time within 30 minutes.
-```ruby
-anonymize('DateOfBirth').using FieldStrategy::DateTimeDelta.new
-```
-```ruby
-# shifts date within 20 days and time within 50 minutes
-anonymize('DateOfBirth').using FieldStrategy::DateTimeDelta.new(20, 50)
-```
+The options available are :
 
-### TimeDelta
-Exactly similar to the above DateTime strategy, except that the returned object is of type `Time`
+1. host(-h)     : DB host name or IP address
+2. database(-d) : The name of the database to generate the whitelist script for
+3. username(-u) : Username for DB authentication
+4. password(-w) : Password for DB authentication
+5. port(-p)     : The port the database service is running on. 
+6. whitelist patterns(-r): A regex expression which can be used to match records in the database to list as whitelisted fields in the generated script.
 
-### DateDelta
+The host and database options are mandatory. The others are optional.
 
-Shifts date randomly within given delta range. Default shits date within 10 days + or -
-```ruby
-anonymize('DateOfBirth').using FieldStrategy::AnonymizeDate.new
-```
-```ruby
-# shifts date within 25 days
-anonymize('DateOfBirth').using FieldStrategy::DateDelta.new(25)
-```
+A few examples of the command is shown below
 
-### RandomEmail
-Generates email randomly using the given HOSTNAME and TLD.
-By defaults generates hostname randomly along with email id.
-```ruby
-anonymize('Email').using FieldStrategy::RandomEmail.new('thoughtworks','com')
 ```
+datanon generate_mongo_dsl -h db.host.com -d production_db -u root -w password
 
-### GmailTemplate
-Generates a valid unique gmail address by taking advantage of the gmail + strategy. Takes in a valid gmail username and
-generates emails of the form username+<number>@gmail.com
-```ruby
-anonymize('Email').using FieldStrategy::GmailTemplate.new('username')
-```
+datanon generate_mongo_dsl -h 123.456.7.8 -d production_db
 
-### RandomMailinatorEmail
-Generates random email using mailinator hostname. e.g. <randomstring>@mailinator.com
-```ruby
-anonymize('Email').using FieldStrategy::RandomMailinatorEmail.new
 ```
 
-### RandomUserName
-Generates random user name of same length as original user name.
-```ruby
-anonymize('Username').using FieldStrategy::RandomUserName.new
-```
+The **mongo** gem is required in order to install the mongo db drivers. The script generates a file named **mongodb_whitelist_generated.rb** in the same location as the project. 
 
-### RandomFirstName
-Randomly picks up first name from the predefined list in the file. Default [file](https://raw.github.com/sunitparekh/data-anonymization/master/resources/first_names.txt) is part of the gem.
-File should contain first name on each line.
-```ruby
-anonymize('FirstName').using FieldStrategy::RandomFirstName.new
-```
-```ruby
-anonymize('FirstName').using FieldStrategy::RandomFirstName.new('my_first_names.txt')
-```
 
-### RandomLastName
-Randomly picks up last name from the predefined list in the file. Default [file](https://raw.github.com/sunitparekh/data-anonymization/master/resources/last_names.txt) is part of the gem.
-File should contain last name on each line.
-```ruby
-anonymize('LastName').using FieldStrategy::RandomLastName.new
-```
-```ruby
-anonymize('LastName').using FieldStrategy::RandomLastName.new('my_last_names.txt')
-```
 
-### RandomFullName
-Generates full name using the RandomFirstName and RandomLastName strategies.
-It also creates the s
-```ruby
-anonymize('FullName').using FieldStrategy::RandomFullName.new
-```
-```ruby
-anonymize('FullName').using FieldStrategy::RandomLastName.new('my_first_names.txt', 'my_last_names.txt')
-```
+## Running in Parallel
+Currently provides capability of running anonymization in parallel at table level provided no FK constraints on tables.
+It uses [Parallel gem](https://github.com/grosser/parallel) provided by Michael Grosser.
+By default it starts multiple parallel ruby processes processing table one by one.
 
-### RandomInteger
-Generates random integer number between given two numbers. Default range is 0 to 100.
 ```ruby
-anonymize('Age').using FieldStrategy::RandomInteger.new(18,70)
+database 'DellStore' do
+  strategy DataAnon::Strategy::Whitelist
+  execution_strategy DataAnon::Parallel::Table  # by default sequential table processing
+  ...
+end
 ```
 
-### RandomIntegerDelta
-Shifts the current value randomly within given delta + and -. Default is 10
-```ruby
-anonymize('Age').using FieldStrategy::RandomIntegerDelta.new(2)
-```
 
-### RandomFloat
-Generates random float number between given two numbers. Default range is 0.0 to 100.0
-```ruby
-anonymize('points').using FieldStrategy::RandomInteger.new(3.0,5.0)
-```
+## DataAnon::Core::Field
+The object that gets passed along with the field strategies.
+
+has following attribute accessor
+
+- `name` current field/column name
+- `value` current field/column value
+- `row_number` current row number
+- `ar_record` active record of the current row under processing
+
+## Field Strategies
+
+
+<table>
+<tr>
+<th align="left">Content</th>
+<th align="left">Name</th>
+<th align="left">Description</th>
+</tr>
+<tr>
+<td align="left">Text</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/LoremIpsum">LoremIpsum</a></td>
+<td align="left">Generates a random Lorep Ipsum String</td>
+</tr>
+<tr>
+<td align="left">Text</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomString">RandomString</a></td>
+<td align="left">Generates a random string of equal length</td>
+</tr>
+<tr>
+<td align="left">Text</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/StringTemplate">StringTemplate</a></td>
+<td align="left">Generates a string based on provided template</td>
+</tr>
+<tr>
+<td align="left">Text</td>
+<td align="left"><a>SelectFromList</a></td>
+<td align="left">Randomly selects a string from a provided list</td>
+</tr>
+<tr>
+<td align="left">Text</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/SelectFromFile">SelectFromFile</a></td>
+<td align="left">Randomly selects a string from a provided file</td>
+</tr>
+<tr>
+<td align="left">Text</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/FormattedStringNumber">FormattedStringNumber</a></td>
+<td align="left">Randomize digits in a string while maintaining the format</td>
+</tr>
+<tr>
+<td align="left">Text</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/SelectFromDatabase">SelectFromDatabase</a></td>
+<td align="left">Selects randomly from the result of a query on a database</td>
+</tr>
+<tr>
+<td align="left">Text</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomUrl">RandomURL</a></td>
+<td align="left">Anonymizes a URL while mainting the structure</td>
+</tr>
+</table><table>
+<tr>
+<th align="left">Content</th>
+<th align="left">Name</th>
+<th align="left">Description</th>
+</tr>
+<tr>
+<td align="left">Number</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomInteger">RandomInteger</a></td>
+<td align="left">Generates a random integer between provided limits (default 0 to 100)</td>
+</tr>
+<tr>
+<td align="left">Number</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomIntegerDelta">RandomIntegerDelta</a></td>
+<td align="left">Generates a random integer within -delta and delta of original integer</td>
+</tr>
+<tr>
+<td align="left">Number</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomFloat">RandomFloat</a></td>
+<td align="left">Generates a random float between provided limits (default 0.0 to 100.0)</td>
+</tr>
+<tr>
+<td align="left">Number</td>
+<td align="left"><a>RandomFloatDelta</a></td>
+<td align="left">Generates a random float within -delta and delta of original float</td>
+</tr>
+<tr>
+<td align="left">Number</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomBigDecimalDelta">RandomBigDecimalDelta</a></td>
+<td align="left">Similar to previous but creates a big decimal object</td>
+</tr>
+</table><table>
+<tr>
+<th align="left">Content</th>
+<th align="left">Name</th>
+<th align="left">Description</th>
+</tr>
+<tr>
+<td align="left">Address</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomAddress">RandomAddress</a></td>
+<td align="left">Randomly selects an address from a geojson flat file [Default US address]</td>
+</tr>
+<tr>
+<td align="left">City</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomCity">RandomCity</a></td>
+<td align="left">Similar to address, picks a random city from a geojson flafile [Default US cities]</td>
+</tr>
+<tr>
+<td align="left">Province</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomProvince">RandomProvince</a></td>
+<td align="left">Similar to address, picks a random city from a geojson flafile [Default US provinces]</td>
+</tr>
+<tr>
+<td align="left">Zip code</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomZipcode">RandomZipcode</a></td>
+<td align="left">Similar to address, picks a random zipcode from a geojson flafile [Default US zipcodes]</td>
+</tr>
+<tr>
+<td align="left">Phone number</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomPhoneNumber">RandomPhoneNumber</a></td>
+<td align="left">Randomizes a phone number while preserving locale specific fomatting</td>
+</tr>
+</table><table>
+<tr>
+<th align="left">Content</th>
+<th align="left">Name</th>
+<th align="left">Description</th>
+</tr>
+<tr>
+<td align="left">DateTime</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/AnonymizeDateTime">AnonymizeDateTime</a></td>
+<td align="left">Anonymizes each field (except year and seconds) within natural range of the field depending on true/false flag provided</td>
+</tr>
+<tr>
+<td align="left">Time</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/AnonymizeTime">AnonymizeTime</a></td>
+<td align="left">Exactly similar to above except returned object is of type 'Time'</td>
+</tr>
+<tr>
+<td align="left">Date</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/AnonymizeDate">AnonymizeDate</a></td>
+<td align="left">Anonymizes day and month within natural ranges based on true/false flag</td>
+</tr>
+<tr>
+<td align="left">DateTimeDelta</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/DateTimeDelta">DateTimeDelta</a></td>
+<td align="left">Shifts data randomly within given range. Default shifts date within 10 days + or - and shifts time within 30 minutes.</td>
+</tr>
+<tr>
+<td align="left">TimeDelta</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/TimeDelta">TimeDelta</a></td>
+<td align="left">Exactly similar to above except returned object is of type 'Time'</td>
+</tr>
+<tr>
+<td align="left">DateDelta</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/DateDelta">DateDelta</a></td>
+<td align="left">Shifts date randomly within given delta range. Default shits date within 10 days + or -</td>
+</tr>
+</table><table>
+<tr>
+<th align="left">Content</th>
+<th align="left">Name</th>
+<th align="left">Description</th>
+</tr>
+<tr>
+<td align="left">Email</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomEmail">RandomEmail</a></td>
+<td align="left">Generates email randomly using the given HOSTNAME and TLD.</td>
+</tr>
+<tr>
+<td align="left">Email</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/GmailTemplate">GmailTemplate</a></td>
+<td align="left">Generates a valid unique gmail address by taking advantage of the gmail + strategy</td>
+</tr>
+<tr>
+<td align="left">Email</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomMailinatorEmail">RandomMailinatorEmail</a></td>
+<td align="left">Generates random email using mailinator hostname.</td>
+</tr>
+</table><table>
+<tr>
+<th align="left">Content</th>
+<th align="left">Name</th>
+<th align="left">Description</th>
+</tr>
+<tr>
+<td align="left">First name</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomFirstName">RandomFirstName</a></td>
+<td align="left">Randomly picks up first name from the predefined list in the file. Default <a href="https://raw.github.com/sunitparekh/data-anonymization/master/resources/first_names.txt">file</a> is part of the gem.</td>
+</tr>
+<tr>
+<td align="left">Last name</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomLastName">RandomLastName</a></td>
+<td align="left">Randomly picks up first name from the predefined list in the file. Default <a href="https://raw.github.com/sunitparekh/data-anonymization/master/resources/first_names.txt">file</a> is part of the gem.</td>
+</tr>
+<tr>
+<td align="left">Full Name</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomFullName">RandomFullName</a></td>
+<td align="left">Generates full name using the RandomFirstName and RandomLastName strategies.</td>
+</tr>
+<tr>
+<td align="left">User name</td>
+<td align="left"><a href="http://rubydoc.info/github/sunitparekh/data-anonymization/DataAnon/Strategy/Field/RandomUserName">RandomUserName</a></td>
+<td align="left">Generates random user name of same length as original user name.</td>
+</tr>
+</table>
 
-### RandomFloatDelta
-Shifts the current value randomly within given delta + and -. Default is 10.0
-```ruby
-anonymize('points').using FieldStrategy::RandomFloatDelta.new(2.5)
-```
 
 ## Write you own field strategies
 field parameter in following code is [DataAnon::Core::Field](#dataanon-core-field)
@@ -444,11 +481,11 @@ write your own anonymous field strategies within DSL,
 ## Default field strategies
 
 ```ruby
-# Work in progress... TO BE COMPLETED
-DEFAULT_STRATEGIES = {:string => FieldStrategy::LoremIpsum.new,
+DEFAULT_STRATEGIES = {:string => FieldStrategy::RandomString.new,
                       :fixnum => FieldStrategy::RandomIntegerDelta.new(5),
                       :bignum => FieldStrategy::RandomIntegerDelta.new(5000),
                       :float => FieldStrategy::RandomFloatDelta.new(5.0),
+                      :bigdecimal => FieldStrategy::RandomBigDecimalDelta.new(500.0),
                       :datetime => FieldStrategy::DateTimeDelta.new,
                       :time => FieldStrategy::TimeDelta.new,
                       :date => FieldStrategy::DateDelta.new,
@@ -457,7 +494,7 @@ DEFAULT_STRATEGIES = {:string => FieldStrategy::LoremIpsum.new,
 }
 ```
 
-Overriding default field strategies,
+Overriding default field strategies & can be used to provide default strategy for missing data type.
 
 ```ruby
 database 'Chinook' do
@@ -497,7 +534,7 @@ DataAnon::Utils::Logging.logger.level = Logger::INFO
 ## Credits
 
 - [ThoughtWorks Inc](http://www.thoughtworks.com), for allowing us to build this tool and make it open source.
-- [Birinder](https://twitter.com/birinder_) and [Panda](https://twitter.com/sarbashrestha) for reviewing the documentation.
+- [Panda](https://twitter.com/sarbashrestha) for reviewing the documentation.
 - [Dan Abel](http://www.linkedin.com/pub/dan-abel/0/61b/9b0) for introducing me to Blacklist and Whitelist approach for data anonymization.
 - [Chirga Doshi](https://twitter.com/chiragsdoshi) for encouraging me to get this done.
 - [Aditya Karle](https://twitter.com/adityakarle) for the Logo. (Coming Soon...)