Learn How to Code
Search
⌃K

Project: Event manager

Learn how to build an event management app that pulls information from an external API.
This tutorial has been adapted from The Turing School's and Jump Start Lab's Event Manager and updated to use Google's Civic Information API.

Learning outcomes

After completing this tutorial, you will be able to:

Practice

Imagine that a friend of yours runs a non-profit organization around political activism. A number of people have registered for an upcoming event. She has asked for your help in engaging these future attendees. For the first task, she wants you to find the government representatives for each attendee based on their zip code.

Initial setup

Create a project directory folder named event_manager wherever you want to store your project. In the project directory, create another folder named lib and inside that folder create a plain text file named event_manager.rb. Using your command-line interface (CLI), you can enter the following commands:
$ mkdir event_manager
$ cd event_manager
$ mkdir lib
$ touch lib/event_manager.rb
Creating and placing your event_manager.rb file in lib directory is entirely optional; however, it adheres to a common convention within most ruby applications. The filepaths we use in this tutorial will assume that we have put our event_manager.rb file within the lib directory.
Ruby source file names should be written all in lower-case characters and instead of camel-casing multiple words together, they are instead separated by an underscore (often called snake_case).
Open lib/event_manager.rb in your text editor and add the line:
puts 'EventManager Initialized!'
Validate that ruby is installed correctly and you have created the file correctly by running it from the root of your event_manager directory:
$ ruby lib/event_manager.rb
Event Manager Initialized!
If ruby is not installed and available on your environment path then you will be presented with the following message:
$ ruby lib/event_manager.rb
-bash: ruby: command not found
If the file was not created then you will be presented with the following error message:
$ ruby lib/event_manager.rb
ruby: No such file or directory -- lib/event_manager.rb (LoadError)
If this happens, make sure the correct directory exists and try creating the file again.
For this project we are going to use the following sample data:
Download the small sample csv file and save it in the root of the project directory, event_manager. Using your CLI, confirm that you are right directory and enter the following command:
$ curl -o event_attendees.csv https://raw.githubusercontent.com/TheOdinProject/curriculum/master/ruby_programming/files_and_serialization/event_attendees.csv
After the file is downloaded, you should see something like:
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 2125 100 2125 0 0 3269 0 --:--:-- --:--:-- --:--:-- 12073

Loading a file

A comma-separated values (CSV) file stores tabular data (numbers and text) in plain-text form. The CSV format is readable by a large number of applications (e.g. Excel, Numbers, Calc). Its portability makes it a popular option when sharing large sets of tabular data from a database or spreadsheet applications.
The first few rows of the CSV file you downloaded look like this:
,RegDate,first_Name,last_Name,Email_Address,HomePhone,Street,City,State,Zipcode
1,11/12/08 10:47,Allison,Nguyen,arannon@jumpstartlab.com,6154385000,3155 19th St NW,Washington,DC,20010
2,11/12/08 13:23,SArah,Hankins,[email protected],414-520-5000,2022 15th Street NW,Washington,DC,20009
3,11/12/08 13:30,Sarah,Xx,[email protected],(941)979-2000,4175 3rd Street North,Saint Petersburg,FL,33703
4,11/25/08 19:21,David,Thomas,[email protected],650-799-0000,9 garrison ave,Jersey City,NJ,7306

Read the file contents

​File is a core ruby class that allows you to perform a large number of operations on files on your filesystem. The most straightforward is File.read.
puts 'EventManager initialized.'
​
contents = File.read('event_attendees.csv')
puts contents
In this example, it does not matter whether you use single quotes or double quotes. There are differences, but they are essentially the same when representing a string of characters, such as this initial greeting or the name of the file.
We are assuming the file is present here. However, it is a good practice to confirm that a file exists. File has the ability to check if a file exists at the specified filepath on the filesystem through File.exist? "event_attendees.csv".

Read the file line by line

Reading and displaying the entire contents of the file showed us how to quickly access the data. Our goal is to display the first names of all the attendees. There are numerous String methods that would allow us to manipulate this large string. Using File.readlines will save each line as a separate item in an array.
puts 'EventManager initialized.'
​
lines = File.readlines('event_attendees.csv')
lines.each { |line| puts line }
First, we read the entire contents of the file as an array of lines. Second, we iterate over the array of lines and output the contents of each line.

Display the first names of all attendees

Instead of outputting the entire contents of each line we want to show only the first name. That requires us to look at the current contents of our Event Attendees file.
,RegDate,first_Name,last_Name,Email_Address,HomePhone,Street,City,State,Zipcode
1,11/12/08 10:47,Allison,Nguyen,arannon@jumpstartlab.com,6154385000,3155 19th St NW,Washington,DC,20010
The first row contains header information. This row provides descriptional text for each column of data. It tells us the data columns are laid out as follows from left-to-right:
  • ID - the empty column represents a unique identifier or row number of all
    the subsequent rows
  • RegDate - the date the user registered for the event
  • first_Name - their first name
  • last_Name - their last name
  • Email_Address - their email address
  • HomePhone - their home phone number
  • Street - their street address
  • City - their city
  • State - their state
  • Zipcode - their zipcode
The lack of consistent formatting of these headers is not ideal when choosing to model your own data. These column names are our extreme example of a poorly formed external service. Great applications are often built on the backs of such services.
We are interested in the first_Name column. At the moment, we have a string of text that represents the entire row. We need to convert the string into an array of columns. The separation of the columns can be identified by the comma "," separator. We want to split the string into pieces wherever we see a comma.
Ruby's String#split allows you to convert a string of text into an array along a particular character. By default when you send the split message to the String without a parameter it will break the string apart along each space " " character. Therefore, we need to specify the comma "," character to separate the columns.
puts 'EventManager initialized.'
​
lines = File.readlines('event_attendees.csv')
lines.each do |line|
columns = line.split(',')
p columns
end
Within our array of columns we want to access our 'first_Name'. This would be the third column or third element at the array's second index columns[2]. Remember, arrays start counting at 0 instead of 1, so columns[0] is how we would access the array's first element, and columns[2] will give us the third.
puts 'EventManager initialized.'
​
lines = File.readlines('event_attendees.csv')
lines.each do |line|
columns = line.split(',')
name = columns[2]
puts name
end

Skipping the header row

The header row was a great help to us in understanding the contents of the CSV file. However, the row itself does not represent an actual attendee. To ensure that we only output attendees, we could remove the header row from the file, but that would make it difficult if we later returned to the file and tried to understand the columns of data.
Another option is to ignore the first row when we display the names. Currently we handle all the rows exactly the same, which makes it difficult to understand which one is the header row.
One way to solve this problem would be to skip the line when it exactly matches our current header row.
puts 'EventManager initialized.'
​
lines = File.readlines('event_attendees.csv')
lines.each do |line|
if line ==
" ,RegDate,first_Name,last_Name,Email_Address,HomePhone,Street,City,State,Zipcode\n"
next
end
columns = line.split(',')
name = columns[2]
puts name
end
When this program is run, the next if line checks every line to see if it matches the provided string. If so, it skips that line from the rest of the loop
A problem with this solution is that the content of our header row could change in the future. Additional columns could be added or the existing columns updated.
A second way to solve this problem is for us to track the index of the current line.
puts 'EventManager initialized.'
​
lines = File.readlines('event_attendees.csv')
row_index = 0
lines.each do |line|
row_index = row_index + 1
next if row_index == 1
columns = line.split(',')
name = columns[2]
puts name
end
This is a such a common operation that Array defines Array#each_with_index.
puts 'EventManager initialized.'
​
lines = File.readlines('event_attendees.csv')
lines.each_with_index do |line, index|
next if index == 0
columns = line.split(',')
name = columns[2]
puts name
end
This solves the problem if the header row were to change in the future. It assumes that the header row is the first row in the file.

Look for a solution before building a solution

Either of these solutions would be OK given our current attendees file. Problems may arise if we are given a new CSV file that is generated or manipulated by another source. This is because the CSV parser that we have started to create does not take into account a number of other features supported by the CSV file format.
Two important ones:
  • CSV files often contain comments which are lines that start with a pound (#) character
  • A column is unable to support a value which contains a comma (,) character
Our goal is to get in contact with our event attendees. It is not to define a CSV parser. This is often a hard concept to let go of when initially solving a problem with programming. An important rule to abide by while building software is:
Look for a Solution before Building a Solution
Ruby actually provides a CSV parser that we will use instead throughout the remainder of this exercise.

Parsing with CSV

It is likely the case that if you want to solve a problem, someone has already done it in some capacity. They may have even been kind enough to share their solution or the tools that they created. This is the kind of goodwill that pervades the Open Source community and Ruby ecosystem.
In this iteration we are going to convert our current CSV parser to use Ruby's CSV. We will then use this new parser to access our attendees' zip codes.

Switching over to use the CSV library

Ruby's core language comes with a wealth of great classes. Not all of them are loaded every single time ruby code is executed. This ensures unneeded functionality is not loaded unless required, preventing ruby from having slower start up times.
You can browse the many libraries available through the documentation.
require 'csv'
puts 'EventManager initialized.'
​
contents = CSV.open('event_attendees.csv', headers: true)
contents.each do |row|
name = row[2]
puts name
end
First we need to tell Ruby that we want it to load the CSV library. This is done through the require method which accepts a parameter of the functionality to load.
The way CSV loads and parses data is very similar to what we previously defined.
Instead of read or readlines we use CSV's open method to load our file. The library also supports the concept of headers and so we provide some additional parameters which state this file has headers.
There are pros and cons to using an external library. One of the pros is that this library makes it easy for us to express that our file has headers. One of the cons is that we have to learn how the library is implemented.

Accessing columns by their names

CSV files with headers have an additional option which allows you to access the column values by their headers. Our CSV file defines several different formats for the column names. The CSV library provides an additional option which allows us to convert the header names to symbols.
Converting the headers to symbols will make our column names more uniform and easier to remember. The header "first_Name" will be converted to :first_name and "HomePhone" will be converted to :homephone.
require 'csv'
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
puts name
end

Displaying the zip codes of all attendees

Accessing the zipcode is very easy using the new header name, :zipcode.
require 'csv'
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
zipcode = row[:zipcode]
puts "#{name} #{zipcode}"
end
We now are able to output the name of the individual and their zipcode.
Now that we are able to visualize both pieces of data we realize that we have a problem....

Cleaning up our zip codes

The zip codes in our small sample show us:
  • Most zip codes are correctly expressed as a five-digit number
  • Some zip codes are represented with fewer than five digits
  • Some zip codes are missing
Before we are able to figure out our attendees' representatives, we need to solve the second issue and the third issue.
  • Some zip codes are represented with fewer than five digits
If we looked at the larger sample of data, we would see that the majority of the shorter zip codes are from states in the north-eastern part of the United States. Many zip codes there start with 0. This data was likely stored in the database as an integer, and not as text, which caused the leading zeros to be removed.
So in the case of zip codes of fewer than five digits, we will assume that we can pad missing zeros to the front.
  • Some zip codes are missing
Some of our attendees are missing a zip code. It is likely that they forgot to enter the data when they filled out the form. The zip code data was not likely marked as mandatory and so our future attendees were not presented with an error message.
We could try to figure out the zip code based on the rest of the address provided. But we could be wrong with our guess, so instead we will use a default, bad zip code of "00000".

Pseudocode for cleaning zip codes

Before we start to explore a solution with Ruby code it is often helpful to express what we are hoping to accomplish in English words.
require 'csv'
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
zipcode = row[:zipcode]
​
# if the zip code is exactly five digits, assume that it is ok
# if the zip code is more than five digits, truncate it to the first five digits
# if the zip code is less than five digits, add zeros to the front until it becomes five digits
​
puts "#{name} #{zipcode}"
end
  • If the zip code is exactly five digits, assume that it is ok
In the case when the zip code is five digits in length we have it easy. We simply want to do nothing.
  • If the zip code is more than five digits, truncate it to the first five digits
While zip codes can be expressed with additional resolution (more digits after a dash), we are only interested in the first five digits.
  • If the zip code is less than five digits, add zeros to the front until it
    becomes five digits
There are many possible ways that we can solve this issue. These are a few paths:
  • Use a while or until loop to prepend zeros until the length is five
  • Calculate the length of the current zip code and add missing zeros to the front
  • Add five zeros to the front of the current zip code and then trim the last five digits
  • Use String#rjust to append zeros to the front of the string.

Handling bad and good zip codes

The following solution employs:
  • ​String#length - returns the length of the string.
  • ​String#rjust - to pad the string with zeros.
  • ​String#slice - to create sub-strings either through the slice method or the array-like notation []
require 'csv'
​
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
zipcode = row[:zipcode]
​
if zipcode.length < 5
zipcode = zipcode.rjust(5, '0')
elsif zipcode.length > 5
zipcode = zipcode[0..4]
end
​
puts "#{name} #{zipcode}"
end
When we run our application, we see the first few lines output correctly and then the application terminates.
$ ruby lib/event_manager.rb
EventManager initialized.
Allison 20010
SArah 20009
Sarah 33703
David 07306
lib/event_manager.rb:11:in `block in <main>': undefined method `length' for nil:NilClass (NoMethodError)
from /Users/burtlo/.rvm/rubies/ruby-1.9.3-p374/lib/ruby/1.9.1/csv.rb:1792:in `each'
from lib/event_manager.rb:7:in `<main>'
  • What is the error message "undefined method 'length' for nil:NilClass (NoMethodError)" saying?
Reviewing our CSV data, we notice that the next row specifies no value. An empty field translates into a nil instead of an empty string. This is a choice made by the CSV library maintainers. So we now need to handle this situation.

Handling missing zip codes

Our solution above does not handle the case when the zip code has not been specified. CSV returns a nil value when no value has been specified in the column. All objects in Ruby respond to #nil?. All objects will return false except for a nil.
We can update our implementation to handle this new case by simply adding a check for nil?.
require 'csv'
​
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
zipcode = row[:zipcode]
​
if zipcode.nil?
zipcode = '00000'
elsif zipcode.length < 5
zipcode = zipcode.rjust(5, '0')
elsif zipcode.length > 5
zipcode = zipcode[0..4]
end
​
puts "#{name} #{zipcode}"
end
$ ruby lib/event_manager.rb
EventManager initialized.
Allison 20010
SArah 20009
Sarah 33703
David 07306
Chris 00000
Aya 90210
Mary Kate 21230
Audrey 95667
Shiyu 96734
Eli 92037
Colin 02703
Megan 43201
Meggie 94611
Laura 00924
Paul 14517
Shannon 03082
Shannon 98122
Nash 98122
Amanda 14841

Moving clean zip codes to a method

It is important for us to take a look at our implementation. During this examination we should ask ourselves:
  • Does the code clearly express what it is trying to accomplish?
The implementation does a decent job at expressing what it accomplishes. The biggest problem is that it is expressing this near so many other concepts. To make this implementation clearer we should move this logic into its own method named clean_zipcode.
require 'csv'
​
def clean_zipcode(zipcode)
if zipcode.nil?
'00000'
elsif zipcode.length < 5
zipcode.rjust(5, '0')
elsif zipcode.length > 5
zipcode[0..4]
else
zipcode
end
end
​
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
​
zipcode = clean_zipcode(row[:zipcode])
​
puts "#{name} #{zipcode}"
end
This may feel like a very small, inconsequential change, but small changes like these help make your code cleaner and your intent clearer.

Refactoring clean zip codes

With our clean zip code logic tucked away in our clean_zipcode method, we can examine it further to see if we can make it even more succinct.
  • Coercion over Questions
A good rule when developing in Ruby is to favor coercing values into similar values so that they will behave the same. We have a special case to deal specifically with a nil value. It would be much easier if instead of checking for a nil value, we convert the nil into a string with NilClass#to_s.
$ nil.to_s
=> ""
Examining String#rjust in irb, we can see that when we provide a string with a length greater than five, it performs no work. This means we can apply it in both cases, as it will have the same intended effect.
$ "123456".rjust(5, '0')
=> "123456"
Lastly, examining String#slice in irb, we can see that for a number that is exactly five digits in length, it has no effect. This also means we can apply it in cases when the zip code is five or more digits, and it will have the same effect.
$ "12345"[0..4]
=> "12345"
Combining all of these steps together, we can write a more succinct clean_zipcode method:
def clean_zipcode(zipcode)
zipcode.to_s.rjust(5, '0')[0..4]
end

Using Google's Civic Information API

We now have our list of attendees with their valid zip codes (at least for most of them). Using their zip code and the Google Civic Information API, we are able to query for the representatives of a given area.
The Civic Information API allows registered individuals (registration is free) to obtain some information about the representatives for each level of government for an address.
For any U.S. residential address, you can look up who represents that address at each elected level of government. During supported elections, you can also look up polling places, early vote location, candidate data, and other election official information.

Accessing the API

Take a close look at this sample URL for accessing the Civic Information API:
Here's how it breaks down:
  • https:// : Use the Secure HTTP protocol
  • www.googleapis.com/civicinfo/v2/ : The API server address on the internet
  • representatives : The method called on that server
  • ? : Parameters to the method
    • & : The parameter separator
    • address=80203 : The zipcode we want to lookup
    • levels=country : The level of government we want to select
    • roles=legislatorUpperBody : Return the representatives from the Senate
    • roles=legislatorLowerBody : Returns the representatives from the House
    • key=AIzaSyClRzDqDh5MsXwnCWi0kOiiBivP6JsSyBw : A registered API Key to authenticate our requests
When we're accessing the representatives method of their API, we're sending in a key which is the string that identifies JumpstartLab as the accessor of the API, then we're selecting the data we want returned to us using the address, levels, and roles criteria. Try modifying the address with your own zipcode and load the page.
This document is JSON formatted. If you copy and paste the data into a pretty printer, you can see there is an officials key that has many legislator names. The response also includes a lot of other information. Cool!
Let's look for a solution before we attempt to build a solution.

Installing the Google API client

Ruby comes packaged with the gem command. This tool allows you to download libraries by simply knowing the name of the library you want to install.
$ gem install google-api-client
Successfully installed google-api-client-0.15.0
1 gem installed
If you receive a signet error when installing the Google API gem, it is due to modern Ruby updates requiring an updated version of signet that is not compatible with the API. To fix, please downgrade your version of signet before installing the gem.

Showing all legislators in a zip code

The gem comes equipped with some vague example documentation. The documentation is also available online with their source code.
Reading through the documentation on how to set up and use the google-api-client gem, we find that we need to perform the following steps:
  • Set the API Key
  • Send the query with the given criteria
  • Parse the response for the names of your legislators.
Exploration of data is easy using irb:
$ require 'google/apis/civicinfo_v2'
=> true
​
$ civic_info = Google::Apis::CivicinfoV2::CivicInfoService.new
=> #<Google::Apis::CivicinfoV2::CivicInfoService:0x007faf2dd47108 ... >
​
$ civic_info.key = 'AIzaSyClRzDqDh5MsXwnCWi0kOiiBivP6JsSyBw'
=> "AIzaSyClRzDqDh5MsXwnCWi0kOiiBivP6JsSyBw"
​
$ response = civic_info.representative_info_by_address(address: 80202, levels: 'country', roles: ['legislatorUpperBody', 'legislatorLowerBody'])
=> #<Google::Apis::CivicinfoV2::RepresentativeInfoResponse:0x007faf2d9088d0 @divisions={"ocd-division/country:us/state:co"=>#<Google::Apis::CivicinfoV2::GeographicDivision:0x007faf2e55ea80 @name="Colorado", @office_indices=[0]> } > ...continues...
Whoa. That's a lot of information. Buried in there are the names of our legislators. We can access them by calling the .officials method on the response. Now that we know how to access the information we want, we can focus our attention back on our program.
require 'csv'
require 'google/apis/civicinfo_v2'
​
civic_info = Google::Apis::CivicinfoV2::CivicInfoService.new
civic_info.key = 'AIzaSyClRzDqDh5MsXwnCWi0kOiiBivP6JsSyBw'
​
def clean_zipcode(zipcode)
zipcode.to_s.rjust(5, '0')[0..4]
end
​
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
​
zipcode = clean_zipcode(row[:zipcode])
​
legislators =
civic_info.representative_info_by_address(
address: zipcode,
levels: 'country',
roles: %w[legislatorUpperBody legislatorLowerBody],
)
legislators = legislators.officials
​
puts "#{name} #{zipcode} #{legislators}"
end
Running our application, we find an error.
$ ruby lib/event_manager.rb
/ruby-2.4.0/gems/google-api-client-0.15.0/lib/google/apis/core/http_command.rb:218:in 'check_status': parseError: Failed to parse address (Google::Apis::ClientError)
What does this mean? It means that the Google API was unable to use an address we gave it. When we dig further, we see that right before this error the information from David with a zip code of 07306 is printed. Looking at the data we can now see that the attendee after David did not enter a zip code. Data missing like this is common, so we have to have a way of dealing with it. Luckily, Ruby makes that easy with its Exception Class. We can add a begin and rescue clause to the API search to handle any errors.
require 'csv'
require 'google/apis/civicinfo_v2'
​
civic_info = Google::Apis::CivicinfoV2::CivicInfoService.new
civic_info.key = 'AIzaSyClRzDqDh5MsXwnCWi0kOiiBivP6JsSyBw'
​
def clean_zipcode(zipcode)
zipcode.to_s.rjust(5, '0')[0..4]
end
​
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
​
zipcode = clean_zipcode(row[:zipcode])
​
begin
legislators =
civic_info.representative_info_by_address(
address: zipcode,
levels: 'country',
roles: %w[legislatorUpperBody legislatorLowerBody],
)
legislators = legislators.officials
rescue StandardError
'You can find your representatives by visiting www.commoncause.org/take-action/find-elected-officials'
end
​
puts "#{name} #{zipcode} #{legislators}"
end
The legislators that we are displaying is an array. In turn, the array is sending the to_s message to each of the objects within the array, each legislator. The output that we are seeing is the raw legislator object.
We really want to capture the first name and last name of each legislator.

Collecting the names of the legislators

Instead of outputting each raw legislator we want to print only their first name and last name. We will need to complete the following steps:
  • For each zip code, iterate over the array of legislators.
  • For each legislator, we want to find the representative's name.
  • Add the name to a new collection of names.
To do this, we can use the map function built into ruby. It works just like .each but returns a new array of the data we want to include.
legislator_names = legislators.map { |legislator| legislator.name }
We can further simplify this into its final form:
legislator_names = legislators.map(&:name)

Cleanly displaying legislators

If we were to replace legislators with legislator_names in our output, we would be presented with a slightly better output.
$ ruby lib/event_manager.rb
EventManager initialized.
Allison 20010 ["Eleanor Norton"]
SArah 20009 ["Eleanor Norton"]
Sarah 33703 ["Marco Rubio", "Bill Nelson", "C. Young"]
...
The problem now is that when using string interpolation, Ruby is converting our new array of legislator names into a string, but Ruby does not know exactly how you want to display the contents.
We need to explicitly convert our array of legislator names to a string. This way we are sure it will output correctly. This could be tedious work except Array again comes to the rescue with the Array#join method.
​Array#join allows the specification of a separator string. We want to create a comma-separated list of legislator names with legislator_names.join(", ")
contents.each do |row|
name = row[:first_name]
​
zipcode = clean_zipcode(row[:zipcode])
​
begin
legislators =
civic_info.representative_info_by_address(
address: zipcode,
levels: 'country',
roles: %w[legislatorUpperBody legislatorLowerBody],
)
legislators = legislators.officials
​
legislator_names = legislators.map(&:name)
​
legislators_string = legislator_names.join(', ')
rescue StandardError
'You can find your representatives by visiting www.commoncause.org/take-action/find-elected-officials'
end
​
puts "#{name} #{zipcode} #{legislators_string}"
end
Running our application this time should give us a much more pleasant looking output:
$ ruby lib/event_manager.rb
EventManager initialized.
Allison 20010 Eleanor Norton
SArah 20009 Eleanor Norton
Sarah 33703 Marco Rubio, Bill Nelson, C. Young
...

Moving displaying legislators to a method

Similar to before, with this step complete, we want to look at our implementation and ask ourselves:
  • Does the code clearly express what it is trying to accomplish?
This code is fairly clear in its understanding. It is simply expressing its intent near so many other things. It is also expressing itself differently from how zip codes are handled. This dissimilarity breeds confusion when returning to the code.
We want to extract our legislator names into a new method named legislators_by_zipcode, which accepts a single zip code as a parameter and returns a comma-separated string of legislator names.
require 'csv'
require 'google/apis/civicinfo_v2'
​
def clean_zipcode(zipcode)
zipcode.to_s.rjust(5, '0')[0..4]
end
​
def legislators_by_zipcode(zip)
civic_info = Google::Apis::CivicinfoV2::CivicInfoService.new
civic_info.key = 'AIzaSyClRzDqDh5MsXwnCWi0kOiiBivP6JsSyBw'
​
begin
legislators =
civic_info.representative_info_by_address(
address: zip,
levels: 'country',
roles: %w[legislatorUpperBody legislatorLowerBody],
)
legislators = legislators.officials
legislator_names = legislators.map(&:name)
legislator_names.join(', ')
rescue StandardError
'You can find your representatives by visiting www.commoncause.org/take-action/find-elected-officials'
end
end
​
puts 'EventManager initialized.'
​
contents =
CSV.open('event_attendees.csv', headers: true, header_converters: :symbol)
​
contents.each do |row|
name = row[:first_name]
​
zipcode = clean_zipcode(row[:zipcode])
​
legislators = legislators_by_zipcode(zipcode)
​
puts "#{name} #{zipcode} #{legislators}"
end
An additional benefit of this implementation is that it encapsulates how we actually retrieve the names of the legislators. This will be of benefit later if we decide on an alternative to the google-api gem or want to introduce a level of caching to prevent look ups for similar zip codes.

Form letters

We have our attendees and their respective representatives. We can now generate a personalized call to action.
For each attendee we want to include a customized letter that thanks them for attending the conference and provides a list of their representatives. Something that looks like:
<html>
<head>
<meta charset='utf-8'>
<title>Thank You!</title>
</head>
<body>
<h1>Thanks FIRST_NAME!</h1>
<p>Thanks for coming to our conference. We couldn't have done it without you!</p>
​
<p>
Political activism is at the heart of any democracy and your voice needs to be heard.
Please consider reaching out to your following representatives:
</p>
​
<table>
<tr><th>Legislators</th></tr>
<tr><td>LEGISLATORS</td></tr>
</table>
</body>
</html>

Storing our template to a file

We could define this template as a large string within our current application.
form_letter =
"
<html>
<head>
<title>Thank You!</title>
</head>
<body>
<h1>Thanks FIRST_NAME!</h1>
<p>Thanks for coming to our conference. We couldn't have done it without you!</p>
​
<p>
Political activism is at the heart of any democracy and your voice needs to be heard.
Please consider reaching out to your following representatives:
</p>
​
<table>
<tr><th>Legislators</th></tr>
<tr><td>LEGISLATORS</td></tr>
</table>
</body>
</html>
"
Ruby has quite a few ways that we can define strings. This format %{ String Contents } is one choice when defining a string that spans multiple lines.
However, placing this large blob of text, this template, within our application will make it much more difficult to understand the template and the application code and thus make it more difficult to change the template and the application code.
Instead of including the template within our application, we will instead load the template using the same File tools we used at the beginning of the exercise.
  • Create a file named 'form_letter.html' in the root of your project directory.
  • Copy the html template defined above into that file and save it.
Within our application we will load our template:
template_letter = File.read('form_letter.html')