WardListing

Description

WardListing contains a python script, getlisting.py, for downloading LDS Ward Membership information from the Ward's official LDS web site, and translating it into formats appropriate for importing into address book software.

It must be supplied with the user's login id and password, along with the URL of the target Ward's web page by editing the configuration file 'getlisting.cfg'. It will use the provided information to obtain the 'Printable' view of the Ward directory from which it will extract name, address, telephone, and family members for each family. From this information, it will then generate 3 data files:

a comma delimited text file (listing.csv)
a tab-separated text file (listing.tab)
a vCard formatted file (listing.vcf)

Most addressbook software will allow importing one of these three file formats.

Installing and using WardListing

Install Python

Unpack and install the CookieClient python library.
A copy of the library is included in the file ClientCookie-0.4.19.tar.gz. More recent versions can be obtained from http://wwwsearch.sourceforge.net/ClientCookie/.

Unpack it using the command:
```
	tar -xvzf ClientCookie-0.4.19.tar.gz
```
Install it _as_root_ by:
```
	cd ClientCookie-0.4.19
	python setup.py install
```
Copy getlisting.cfg.in to getlisting.cfg and edit it.
Copy it via:
```
	cp getlisting.cfg.in getlisting.cfg
```
Fill in the username, password, and ward web page URL. Note that the ward web page URL needs to be just the portion of the URL after the host name.
Run getlisting.py
```
        python getlisting.py
```

If everything is properly configured you should see:

    
      #################################################################
      #                                                               #
      # By using this software, you agree ensure that all information #
      # obtained through will only be used for:                       #
      #                                                               #
      # A) activities supporting the work of the Church of Jesus      #
      # Christ of Latter Day Saints, or                               #
      #                                                               #
      # B) incidental personal _non-commercial_ activity.             #
      #                                                               #
      #################################################################


    Determining member page URL... Done
    Authenticating and locating 'printable' ward listing page... Done.
    Downloading 'printable' ward listing data... Done.
    Removing header & footer from the file...
    Done
    Writing ward listing html data to 'listing.html'... Done.
    Splitting into separate family records...
    Number of family groups: NNN
    Done.
    Parsing ward listing html into individual families... Working on block #0:
    
    Working on block #1:
    XXXXXX
    NNN-NNN-NNNN
    NN XXXXX XX.
    XXXXXXXXX, XXXXXXXXXXX NNNNN
    ['XXXXXXX XXXX', 'XXXXX XXXXXXX', 'XXXXXX XXXX', 'XXXXXXXX XXXX']
    
    Working on block #2:
    XXXXX
    NNN-NNN-NNNN
    NNN XXXXXXXX XXXXX
    XXXXXX, XXXXXXXXXXX NNNNN
    ['XXXX XXXXXXX', 'XXXXXXX XXXXXXX']
    
    ...

    Working on block #NNN:
    XXXXX
    NNN-NNN-NNNN
    N XXXXXX XX
    XXXXXX, XXXXXXXXXXX NNNNN
    ['XXXX XXX']
    
    Done.
    Writing Family info to comma delimited file 'listing.csv'... Done.
    Writing Family info to tab delimited file 'listing.tab'... Done.
    Writing Family info to vcard 'listing.vcf'... Done.
    All Done.

You will now find 3 data files contianing address information about each family in the ward:
- listing.csv: Comma and double-quote delimted text file
- listing.tab: Tab and double-quote delimited text file
- listing.vcf: vCard formatted text file
At least one of these formats should be readable by your favorite address book program..

The vCard format is probably the best bet for importing into true address book programs, such as PalmDesktop, Outlook, Macintosh Address Book, etc. The .csv and .tab files will be a better bet for importing into spreadsheets and databases, such as MS-Excel, MS-Access, etc.

Downloads

WardListing Source Code and Documentation

WardListing-1.0.0.tgz (gzip compressed tar archive)
WardListing-1.0.0.zip (zip archive)