Dependencies (other than standard Ruby/bundler):
pdftk
. Get it here.
Add this line to your application's Gemfile:
gem 'iaa'
To use the latest and greatest:
gem 'iaa', github: '18F/iaa-gem', branch: 'master'
And then execute:
$ bundle
This gem makes available two classes, IAA::Form7600A
and IAA::Form7600B
.
form = IAA::Form7600A.new(pdf_path: 'path/to/7600A.pdf')
form.start_date #=> "05-20-2015"
form.end_date #> "06-20-2015"
# ... etc
form.start_date = "05-21-2015"
form.save('/path/to/save/destination')
Note: the default directory to save is the "tmp" directory within the iaa-gem directory.
form2 = IAA::Form7600A.new
form2.start_date = "07-07-2016"
form.save('/path/to/save/destination')
See lib/mappings/7600A.json
and lib/mappings/7600A.json
for all getter and setter methods. The field in these files called "attribute_name"
corresponds to all getter and setter method names. For example in lib/mappings/7600A.json
, we have:
// ...
{
"name": "Start Date",
"attribute_name": "start_date",
"options": null,
"type": "Text",
"value": "FILL IN"
},
// ...
This means instances of IAA::Form7600A
have the methdods #start_date
and #start_date=
. All of the methods are created during ::initialize
through some metaprogramming. Think of the JSON files in the mappings
folder as the canonical source of method names.
You could also use these JSON files to create IAA form fillers in other languages.
The PDFs in lib/pdfs
have been modified somewhat from their originals. Visually, nothing has changed, but a few of the underlying form field names have been changed. For example, one field, "GT & C #" caused a lot of trouble because of that pesky ampersand. So, the field value in the PDF was changed to "gt_and_c_number".
This gem includes an API server! It's just a small, mountable Sinatra application.
To set up, just mount the server inside of a Rails app, for example--or just run it standalone:
Create a Gemfile
:
source 'https://rubygems.org'
gem 'iaa'
gem 'thin'
Run bundle
.
Create a config.ru
:
require 'bundler/setup'
require 'iaa'
run Rack::URLMap.new(
'/iaa' => IAA::Server
)
And run with:
$ bundle exec thin start
POST some JSON of keys and values that match the attributes in lib/mappings/7600a.json
and get back a PDF response.
- Make sure that Docker Compose is installed.
- Navigate to iaa-gem directory and run
docker-compose build
. - Run
docker-compose run iaa
.
After checking out the repo, run gem install bundler && bin/setup
to install dependencies. Then, run rake rspec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/18F/iaa-gem.