RubySwift

A ruby wrapper of the Swift Digital Suite Mail House API.

This is currently a relatively crude wrapper and does not tidy responses from Swift a lot. Contributions are welcome.

INSTALLATION

You can install the library via Rubygems:

$ gem install ruby-swift

Or within your Gemfile if you're using Bundler:

gem "ruby-swift"

USAGE

Initialize the connection:

swift = RubySwift.new("API_PASSWORD")

Does a person exist?

swift.person_exists?("you@example.com") # -> true

Read a person:

person = swift.read_person("you@example.com")

Add someone to a mail group:

swift.add_group_member("you@example.com", "Group Name") # -> "0"

Remove someone from a mail group:

swift.remove_group_member("you@example.com", "Group Name") # -> "0"

Create a person:

swift.write_person(email: "me@example.com", first_name: "Dennis", last_name: "Ritchie") # -> "0"

Update person:

swift.update_person(email: "you@example.com", first_name: "Donald", last_name: "Knuth") # -> "0"

Create or update existing person:

swift.write_or_update_person(email: "me@example.com", first_name: "Dennis", last_name: "Ritchie") # -> "0"

Create a group:

swift.write_group("Group name") # -> "0"

Read all groups:

groups = swift.read_groups

Read all members of a group:

people = swift.read_persons("Group Name")

Remove a group:

swift.remove_group("Group Name") # -> "0"

Remove a person:

swift.remove_person("you@example.com") # -> "0"

TODO

• Tidy up responses (Hashie?)
• Return true/false instead of "0" for write actions
• Allow custom fields in write/update