Skip to content
A collection of common regular expressions bundled with an easy to use interface.
Branch: master
Clone or download
Latest commit 2425abd Sep 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
build/lib.linux-x86_64-2.7 Convert to Python3 May 21, 2017
dist Update distribution Sep 8, 2014
.gitignore rm *.pyc Dec 31, 2013
LICENSE License file added Jan 12, 2014
MANIFEST Install using Dec 29, 2013 Add rust port Sep 25, 2019 Added SSN Jun 18, 2019 Update distribution Sep 8, 2014


Find all times, dates, links, phone numbers, emails, ip addresses, prices, hex colors, and credit card numbers in a string. We did the hard work so you don't have to.

Pull requests welcome!


Install via pip

sudo pip install commonregex

or via

python install


>>> from commonregex import CommonRegex
>>> parsed_text = CommonRegex("""John, please get that article on to me by 5:00PM 
                               on Jan 9th 2012. 4:00 would be ideal, actually. If you have any 
                               questions, You can reach me at (519)-236-2723x341 or get in touch with
                               my associate at""")
>>> parsed_text.times
['5:00PM', '4:00']
>>> parsed_text.dates
['Jan 9th 2012']
>>> parsed_text.links
>>> parsed_text.phones
>>> parsed_text.phones_with_exts
>>> parsed_text.emails

Alternatively, you can generate a single CommonRegex instance and use it to parse multiple segments of text.

>>> parser = CommonRegex()
>>> parser.times("When are you free?  Do you want to meet up for coffee at 4:00?")

Finally, all regular expressions used are publicly exposed.

>>> from commonregex import email
>>> import re
>>> text = "...get in touch with my associate at"
>>> re.sub(email, "", text)
'...get in touch with my associate at'
>>> from commonregex import time
>>> for m in time.finditer("Does 6:00 or 7:00 work better?"):
>>>     print m.start(),     
5 6:00 
13 7:00 

Please note that this module is currently English/US specific.

Supported Methods/Attributes

  • obj.dates, obj.dates()
  • obj.times, obj.times()
  • obj.phones, obj.phones()
  • obj.phones_with_exts, obj.phones_with_exts()
  • obj.links, obj.links()
  • obj.emails, obj.emails()
  • obj.ips, obj.ips()
  • obj.ipv6s, obj.ipv6s()
  • obj.prices, obj.prices()
  • obj.hex_colors, obj.hex_colors()
  • obj.credit_cards, obj.credit_cards()
  • obj.btc_addresses, obj.btc_addresses()
  • obj.street_addresses, obj.street_addresses()
  • obj.zip_codes, obj.zip_codes()
  • obj.po_boxes, obj.po_boxes()
  • obj.ssn_number, obj.ssn_number()

CommonRegex Ports:


[CommonRegexJS] (

[CommonRegexScala] (

[CommonRegexJava] (

[CommonRegexCobra] (

[CommonRegexDart] (

[CommonRegexRuby] (

[CommonRegexPHP] (


You can’t perform that action at this time.