No description, website, or topics provided.
Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
.gitignore~
README.md
config.cfg
default_phonebook.txt
number_regex.py
person.py
phonebook
phonebook_class.py
phonebook_fixture.txt
validation_tests.py

README.md

#Phonebook Phonebook is an basic command-line phonebook application implementing the Hacker School phonebook specification. It stores names and phone numbers in comma-separated text files (though it could be easily extended to use a more robust backend).

##Installation Download Phonebook:

git clone https://github.com/KatrinaE/phonebook.git phonebook

Make Phonebook executable:

cd path-to-phonebook
chmod u+x phonebook

Add Phonebook to your path, e.g.:

ln -s path-to-phonebook/phonebook /usr/local/bin/phonebook

##Usage

Available commands are:

  • create: Create a new phonebook with the given filename

      phonebook create phonebook.txt
    
  • set-default: Set the given phonebook to be the default

      phonebook set-default phonebook.txt
    

    (To use a non-default phonebook, use the -b option)

      phonebook create different-phonebook.txt
      phonebook lookup 'John Smith' -b different-phonebook.txt
    
  • add: Add a person to the phonebook

      phonebook add 'John Smith' '(987) 654-3210'
    

    A person may only be in the phonebook once - you cannot store e.g. one entry containing a person's home phone number and another entry with his cell phone number.

  • remove: Remove a person from the phonebook

      phonebook remove 'John Smith'
    
  • lookup: Look up a person by name

      phonebook lookup 'John'
    

    Lookup matches all entries containing the lookup string and prints them to the console.

  • reverse-lookup: Look up a person by phone number

      phonebook reverse-lookup '(987) 654-3210'
    

    Reverse-lookup may return more than one person if both of them have the same phone number.

    Phone numbers are validated using the parser implemented in 'Dive into Python'. It supports US phone numbers entered in any format. The numbers are stored and displayed in the format 'XXX XXX XXXX'.

To-Dos

'Default phonebook' behavior is currently untested.