Name: Contact Name Mangler
Path: modules/recon/contacts-contacts/mangle.py
Author: Tim Tomes (@LaNMaSteR53)

Description:
Applies a mangle pattern to all of the contacts stored in the database, creating email addresses or usernames for each harvested contact. Updates the 'contacts' table with the results.

Options:

Name	Current Value	Required	Description
DOMAIN		no	target email domain
MAX-LENGTH	30	yes	maximum length of email address prefix or username
OVERWRITE	False	yes	overwrite existing email addresses
PATTERN	False	<fn>.<ln>	pattern applied to mangle first and last name
SOURCE	default	yes	source of input (see 'show info' for details)
SUBSTITUTE	-	yes	character to substitute for invalid email address characters

Source Options:

default	SELECT rowid, first_name, middle_name, last_name, email FROM contacts ORDER BY first_name
<string>	string representing a single input
<path>	path to a file containing a list of inputs
query <sql>	database query returning one column of inputs

Comments:
* Pattern options: <fi>,<fn>,<mi>,<mn>,<li>,<ln>
* Example: <fi>.<ln> => [email protected]
* Note: Omit the 'domain' option to create usernames