Project

herder

0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
herdergeeksoflondon/herderHomepageDocumentationSource CodeBug TrackerWiki
The herder that manages all animals talking to the hamster
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
13,774
Stars
1
Forks
0
Watchers
2
 Releases
Current version
0.0.5
Total releases
4
First release
2012-07-12
Latest release
2012-07-23
 Issues
Open Issues
2
Closed Issues
6
Total Issues
8
Issue Closure Rate
75%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
3
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Average date of last 50 commits
2012-07-15
Reverse Dependencies
0

 Dependencies

Development

rspec
>= 0
timecop
>= 0

Runtime

activeresource
>= 0
active_resource_pagination
>= 0
reactive_resource
>= 0
will_paginate
>= 0
 Project Readme

herder

Build Status

The herder that allows all animals to talk to the hamster

Installation

Add to Gemfile for a Rails app:

gem "herder"

Bundle and then add a config/herder.yml

site: http://localhost:3000/
user: "username"
password: "password"

Or don't add the yml file to fall back on the ENV variables HERDER_SITE, HERDER_USER and HERDER_PASSWORD. This is useful for Heroku.

Basic usage

For now Herder adds a few built in ActiveResource classes.

  • Herder::Attendee
    • has many Herder::Emails
    • has many Herder::Tickets
  • Herder::Email
    • belongs to Herder::Attendee
  • Herder::Ticket
    • belongs to Herder::Attendee
    • belongs to Herder::Event
  • Herder::Event
    • has many Herder::Tickets
    • belongs to Herder::Venue
  • Herder::Venue
    • has many Herder::Events

For full usage details read the ActiveResource documentation.

Herder::Attendee.find(1)
#=> #<Attendee:0x007f9aabb84550 @attributes={"created_at"=>"2012-07-10T19:26:23Z", "diet"=>nil, "first_name"=>"John", "id"=>1, "kind"=>1, "last_name"=>"Doe", "name"=>"John Doe", "notes"=>nil, "phone_number"=>nil, "public"=>true, "tshirt"=>nil, "twitter"=>nil, "updated_at"=>"2012-07-10T19:26:23Z"}, @prefix_options={}, @persisted=true>

Alternatively you can make your own models to extend the base classes:

# in app/models/attendee.yml

class Attendee < Herder::Attendee
  # add your own convenience methods here
end

# anywhere else
Attendee.find(1)
#=> #<Attendee:0x007f9aabb84550 @attributes={"created_at"=>"2012-07-10T19:26:23Z", "diet"=>nil, "first_name"=>"John", "id"=>1, "kind"=>1, "last_name"=>"Doe", "name"=>"John Doe", "notes"=>nil, "phone_number"=>nil, "public"=>true, "tshirt"=>nil, "twitter"=>nil, "updated_at"=>"2012-07-10T19:26:23Z"}, @prefix_options={}, @persisted=true>

Using interactions

Interactions are a handy key-value attributes that can be set on other classes (Interactables). This is handy as it means we don't need to add loads of extra booleans to Hamster for every little thing we might need to keep track of.

Note: Interactions are never deleted, hence you can always get a full log of interactions including date and time of when something changed value.

Acting on a record

ticket = Ticket.find(1)
ticket.interactions.checkin = true #changes state
ticket.interactions.checkin.toggle #changes state to opposite of current state
ticket.interactions.checkin.undo! #undoes (hard delete) last state
ticket.interactions.checkin #just returns latest value for the checkin key
ticket.interactions.checkin? #just checks if value == true
ticket.interactions.limit(5).checkin #just returns last 5 values for checkin
ticket.interactions.limit(5).oldest.checkin #just returns first 5 (oldest) values for checkin
ticket.interactions #full list of interaction objects

Acting on a table

Note: These methods return the objects they are performed on (in this case Ticket).

event = Event.find(1)
event.tickets.where("interactions.confirmed = true") #confirmed tickets for event #1
event.tickets.where("interactions.confirmed != true") #unconfirmed tickets for event #1
event.tickets.where("interactions.cancelled = true") #cancelled tickets for event #1
event.tickets.where("interactions.checkin ~ true") #attended tickets for event #1
event.tickets.where("interactions.checkin !~ true") #noshow tickets for event #1
event.tickets.where("interactions.checkin = true") #onsite tickets for event #1
event.tickets.where("interactions.checkin != true") #offsite tickets for event #1
event.tickets.where("interactions.checkin ~ ? AND interactions.created_at < ? AND interactions.created_at > ?", true, Time.now, 3.days.ago) #attended during period
event.tickets.where("interactions.checkin !~ ? AND interactions.created_at < ? AND interactions.created_at > ?", false, Time.now, 3.days.ago) # did not check out during period
event.tickets.where("interactions.permanently_left = true") #not-coming-back
event.tickets.where("interactions.permanently_left != true") #coming-back

Changelog

  • 0.0.5 - Dependency fix
  • 0.0.4 - Added events and venues
  • 0.0.3 - Added interactions and interactables
  • 0.0.2 - Added emails, tickets, and association
  • 0.0.1 - Added basic attendee interface

License

See LICENSE