An unofficial Ruby wrapper for the NGP VAN RESTful API.
Install via Rubygems:
gem install ngp_vanOr add this line to your application's Gemfile:
gem 'ngp_van'ngp_van is cryptographically signed. To be sure the gem you install hasn’t been tampered with, add my public key as a trusted certificate:
gem cert --add <(curl -Ls https://raw.github.com/christopherstyles/ngp_van/master/certs/christopherstyles.pem)
Then install with:
gem install ngp_van -P MediumSecurity
or if using bundler:
bundle install --trust-policy MediumSecurity
The MediumSecurity trust profile will verify signed gems, but allow the installation of unsigned dependencies.
This is necessary because not all of ngp_vans dependencies are signed, so we cannot use HighSecurity.
NGP VAN can be configured using a block:
NgpVan.configure do |config|
config.application_name = 'MyCampaignApp'
# See http://developers.everyaction.com/van-api#van-authentication
config.api_key = 'de286a1a-f2e7-421a-91b8-f8cc8201558f|1'
# Defaults to "https://api.securevan.com/v4/"
config.api_endpoint = 'https://intlapi.securevan.com/v4'
# Defaults to "NGP VAN Ruby Gem #{NgpVan::VERSION}"
config.user_agent = 'CustomUserAgent'
endOptions can also be set on the configuration object:
% NgpVan.configuration.api_key = 'de286a1a-f2e7-421a-91b8-f8cc8201558f|1'
# => "de286a1a-f2e7-421a-91b8-f8cc8201558f|1"In a multi-threaded environment you may want to use multiple configurations simultaneously. In that case, pass an appropriately setup configuration class to the client object.
configuration = NgpVan::Configuration.new
configuration.api_key = 'de286a1a-f2e7-421a-91b8-f8cc8201558f|1'
client = NgpVan::Client.new(configuration)
client.district_fieldsAPI Methods can be called as module methods or as instance methods on the client.
NgpVan.district_fields
# => [
# {"districtFieldId"=>1, "name"=>"State", "parentFieldId"=>nil...},
# {"districtFieldId"=>4, "name"=>"County", "parentFieldId"=>1...}
# ]or
client = NpgVan.client
client.district_fields
# => [
# {"districtFieldId"=>1, "name"=>"State", "parentFieldId"=>nil...},
# {"districtFieldId"=>4, "name"=>"County", "parentFieldId"=>1...}
# ]After checking out the repo, run rake spec to run the tests.
A console task has also been provided to automatically load the NGP VAN environment. Run bin/console for an interactive prompt that will allow you to experiment.
% bin/console
[1] pry(main)> NgpVan::VERSION
# => "x.x.x"
[2] pry(main)> NgpVan.configuration.application_name = 'MyCampaignApplication'
# => "MyCampaignApplication"
[3] pry(main)> NgpVan.configuration.api_key = 'de286a1a-f2e7-421a-91b8-f8cc8201558f|1'
# => "de286a1a-f2e7-421a-91b8-f8cc8201558f|1"
[4] pry(main)> NgpVan.district_fields
# => [
# {"districtFieldId"=>1, "name"=>"State", "parentFieldId"=>nil...,
# {"districtFieldId"=>2, "name"=>"County", "parentFieldId"=>1...
# ]Bug reports and pull requests are welcome on GitHub at https://github.com/christopherstyles/ngp_van/issues.
This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
The gem is available as open source under the terms of the MIT License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent