workable 1.0.0 → 2.0.0rc1

data/lib/workable/transformation.rb

@@ -0,0 +1,26 @@
+module Workable
+  class Transformation
+    def initialize(mappings)
+      @mappings = mappings || {}
+    end
+
+    # selects transformation strategy based on the inputs
+    # @param transformation [Method|Proc|nil] the transformation to perform
+    # @param data           [Hash|Array|nil]  the data to transform
+    # @return               [Object|nil]
+    #    results of the transformation if given, raw data otherwise
+    def apply(mapping, data)
+      transformation = @mappings[mapping]
+      return data unless transformation
+
+      case data
+      when nil
+        data
+      when Array
+        data.map { |datas| transformation.call(datas) }
+      else
+        transformation.call(data)
+      end
+    end
+  end
+end

data/lib/workable/version.rb

@@ -1,3 +1,3 @@
 module Workable
-  VERSION = "1.0.0"
+  VERSION = '2.0.0rc1'
 end

data/spec/fixtures.rb

@@ -1,138 +1,50 @@
 # coding: utf-8
-# dead-simple methods instead of full vcr cassettes, because why not?
+# JSONs stolen from official workable API docs
+
+def about_json_fixture
+  read_fixture 'about.json'
+end
 
 def jobs_index_json_fixture
-  JSON.generate({
-    "name" => "wojsznis",
-    "description" => nil,
-    "jobs" => [
-      {
-        "key" => "7c60",
-        "title" => "Ruby on Rails dev",
-        "full_title" => "Ruby on Rails dev - CODE",
-        "code" => "CODE",
-        "shortcode" => "03FF356C8B",
-        "state" => "published",
-        "department" => "DEPT",
-        "url" => "https://wojsznis.workable.com/jobs/30606",
-        "application_url" => "https://wojsznis.workable.com/jobs/30606/candidates/new",
-        "shortlink" => "https://wojsznis.workable.com/j/03FF356C8B",
-        "location" => {
-          "country" => "Poland",
-          "country_code" => "PL",
-          "region" => "Małopolskie",
-          "region_code" => "MA",
-          "city" => "Kraków",
-          "zip_code" => "30-000",
-          "telecommuting" => true
-        },
-        "created_at" => "2015-01-05"
-      }
-    ]
-})
+  read_fixture 'jobs.json'
 end
 
 def job_json_fixture
-  JSON.generate({
-    "key" => "7c60",
-    "title" => "Ruby on Rails dev",
-    "full_title" => "Ruby on Rails dev - CODE",
-    "code" => "CODE",
-    "shortcode" => "03FF356C8B",
-    "state" => "draft",
-    "department" => "DEPT",
-    "url" => "https://wojsznis.workable.com/jobs/30606",
-    "application_url" => "https://wojsznis.workable.com/jobs/30606/candidates/new",
-    "shortlink" => "https://wojsznis.workable.com/j/03FF356C8B",
-    "location" => {
-      "country" => "Poland",
-      "country_code" => "PL",
-      "region" => "Małopolskie",
-      "region_code" => "MA",
-      "city" => "Kraków",
-      "zip_code" => "30-338",
-      "telecommuting" => true
-    },
-    "created_at" => "2015-01-05",
-    "full_description" => "<p>Example job brief.</p>\r\n<ul>\n<li>test 1</li>\r\n<li>test 2</li>\r\n<li>test 3</li>\r\n</ul><p></p>\r\n<p><b>End of test.</b></p><p><strong>Requirements</strong></p><ul>\n<li>req 1</li>\r\n<li>req 2</li>\r\n</ul><p><strong>Benefits</strong></p><ul>\n<li>ben 1</li>\r\n<li>ben 2</li>\r\n</ul>",
-    "description" => "<p>Example job brief.</p>\r\n<ul>\n<li>test 1</li>\r\n<li>test 2</li>\r\n<li>test 3</li>\r\n</ul><p></p>\r\n<p><b>End of test.</b></p>",
-    "requirements" => "<ul>\n<li>req 1</li>\r\n<li>req 2</li>\r\n</ul>",
-    "benefits" => "<ul>\n<li>ben 1</li>\r\n<li>ben 2</li>\r\n</ul>",
-    "employment_type" => "Full-time",
-    "industry" => "Information Technology and Services",
-    "function" => "Engineering",
-    "experience" => "Mid-Senior level",
-    "education" => "Professional"
-  })
+  read_fixture 'job.json'
 end
 
 def job_candidates_json_fixture
-  JSON.generate({
-    "candidates" => [
-      {
-        "key" => "f7087",
-        "name" => "Test LastName",
-        "firstname" => "Test",
-        "lastname" => "LastName",
-        "headline" => "headline",
-        "account" => {
-          "subdomain" => "wojsznis",
-          "name" => "wojsznis"
-        },
-        "job" => {
-          "shortcode" => "03FF356C8B",
-          "title" => "Ruby on Rails dev"
-        },
-        "stage" => "Applied",
-        "disqualified" => false,
-        "sourced" => false,
-        "profile_url" => "http://wojsznis.workable.com/backend/jobs/30606/candidates/1010613",
-        "address" => "Address",
-        "phone" => "",
-        "email" => "example@test.com",
-        "outbound_mailbox" => "eaqpdpbc@outbound.workablemail.com",
-        "domain" => "unknown",
-        "created_at" => "2015-01-05 11:56:40",
-        "updated_at" => "2015-01-05 11:56:48",
-        "cover_letter" => "",
-        "summary" => "",
-        "education_entries" => [ ],
-        "experience_entries" => [ ],
-        "skills" => [ ],
-        "answers" => [
-          {
-            "question" => {
-                "body" => "Why you want this job?"
-            },
-            "answer" => {
-                "body" => "<p>Sample answer</p>"
-            }
-          }
-        ],
-        "resume_url" => "",
-        "tags" => [ ]
-      }
-    ]
-  })
+  read_fixture 'job_candidates.json'
+end
+
+def job_candidate_json_fixture
+  read_fixture 'job_candidate.json'
 end
 
 def stages_json_fixture
-  JSON.generate({"stages" => [
-    {"slug"=>"sourced",    "name"=>"Sourced",    "kind"=>"sourced",     "position"=>1},
-    {"slug"=>"applied",    "name"=>"Applied",    "kind"=>"applied",     "position"=>2},
-    {"slug"=>"soft-talk",  "name"=>"Soft Talk",  "kind"=>"interview",   "position"=>3},
-    {"slug"=>"wait",       "name"=>"Wait",       "kind"=>"shortlisted", "position"=>4},
-    {"slug"=>"assessment", "name"=>"Assessment", "kind"=>"assessment",  "position"=>5},
-    {"slug"=>"review",     "name"=>"Review",     "kind"=>"assessment",  "position"=>6},
-    {"slug"=>"tech-talk",  "name"=>"Tech Talk",  "kind"=>"interview",   "position"=>7},
-    {"slug"=>"prepare",    "name"=>"Prepare",    "kind"=>"interview",   "position"=>8},
-    {"slug"=>"ready",      "name"=>"Ready",      "kind"=>"shortlisted", "position"=>9},
-    {"slug"=>"later",      "name"=>"Later",      "kind"=>"shortlisted", "position"=>10}
-  ]})
+  read_fixture 'stages.json'
 end
 
 def job_questions_json_fixture
-  JSON.generate({"questions" => [
-    {"key"=>"fe8", "body"=>"How many fingers do you have?", "type"=>"free_text"}
-  ]})
+  read_fixture 'job_questions.json'
+end
+
+def recruiters_json_fixture
+  read_fixture 'recruiters.json'
+end
+
+def members_json_fixture
+  read_fixture 'members.json'
+end
+
+def new_candiate_hash_fixture
+  JSON.parse(read_fixture('new_candidate.json'))
+end
+
+def new_candiate_response_json_fixture
+  read_fixture 'new_candidate_response.json'
+end
+
+def read_fixture(filename)
+  File.read File.expand_path("../fixtures/#{filename}", __FILE__)
 end

data/spec/fixtures/about.json

@@ -0,0 +1,8 @@
+{
+  "id": "20ff5c50",
+  "name": "Groove Tech",
+  "subdomain": "groove-tech",
+  "description": "<p>We’ve all spent tons of hours trying to book a trip! Well, our guys finally got tired of going through this frustrating process and passionately decided to do something about it: To change the traveller’s experience. Four years later, we stick to that idea by daily plotting the traveling revolution.</p> <p>Like busy little bees, all 98 of us, customise our user-friendly software and innovative services to match leisure and business travellers needs throughout the entire journey. We create innovative and top notch travel products for a simple reason: You deserve it.</p> <p>Whether it’s about booking tickets or hotels, whatever the budget, us travel lovers are dedicated to deliver you a lifetime experience. How? By empowering you to easily discover, book and have fun at the whole world!</p> <p>We are innovators, idealists and perfectionists. We love raising the bar to delight and amaze our customers and that’s exactly why working with us requires a lot of you. But it’s a lot more than that. We’ll brightly reward you. We’ll develop your career. We’ll keep you excited! In other words we promise being the most exciting place for you to work at.</p> <p>We are growing as crazy and we need you industry experts and passionate individuals to do things that matter and take us off! Come aboard ready to share, learn and grow.</p>",
+  "summary": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam elementum posuere erat, quis mattis lectus ullamcorper sit amet. Praesent nec aliquet erat. Donec quis arcu id metus tristique eleifend. Aenean sed nunc id tortor vulputate auctor. Pellentesque ut volutpat augue, vel aliquam lectus. Maecenas mattis dictum risus, id varius nisi sodales vitae. Aenean pulvinar lacinia condimentum. Nulla id leo a tortor elementum dapibus id condimentum nibh.",
+  "website_url": "https://www.workable.com"
+}

data/spec/fixtures/job.json

@@ -0,0 +1,31 @@
+{
+  "id": "167636b1",
+  "title": "Office Manager",
+  "full_title": "Office Manager - US/4/OM",
+  "shortcode": "GROOV005",
+  "code": "US/4/OM",
+  "state": "published",
+  "department": "Administration",
+  "url": "https://groove-tech.lvh.me:3000/jobs/376844767",
+  "application_url": "https://groove-tech.lvh.me:3000/jobs/376844767/candidates/new",
+  "shortlink": "https://groove-tech.lvh.me:3000/j/GROOV005",
+  "location": {
+    "country": "United States",
+    "country_code": "US",
+    "region": "Illinois",
+    "region_code": "IL",
+    "city": "Chicago",
+    "zip_code": "60290",
+    "telecommuting": false
+  },
+  "created_at": "2015-06-08T00:00:00Z",
+  "full_description": " <p>We are looking for an Office Manager to organize and coordinate office operations and procedures, in order to ensure organizational effectiveness, efficiency and safety.The ideal candidate will be experienced in handling a wide range of administrative and executive support related tasks and will be able to work independently with little or no supervision. This person must be exceedingly well organized, flexible and enjoy the administrative challenges of supporting an office of diverse people.</p> <p>Responsibilities:<ul> <li>Serve as the point person for maintenance, mailing, shopping, supplies, equipment, bills, and errands</li> <li>Organize and schedule meetings and appointments</li> <li>Partner with HR to maintain office policies as necessary</li> <li>Organize office operations and proceduresCoordinate with IT department on all office equipment</li> <li>Manage relationships with vendors, service providers, and landlord, ensuring that all items are invoiced and paid on time</li> <li>Manage contract and price negotiations with office vendors, service providers and office lease</li> <li>Manage office G&A budget, ensure accurate and timely reporting</li> <li>Provide general support to visitors</li> </ul></p><p><strong>Requirements</strong></p><ul> <li>4+ years of office management, administrative or assistant experience</li> <li>Knowledge of office management systems and procedures</li> <li>Excellent time management skills and ability to multi-task and prioritize work</li> <li>Attention to detail and problem solving skills</li> <li>Excellent written and verbal communication skills</li> <li>Strong organizational and planning skills</li> <li>Proficiency in MS Office</li> </ul><p><strong>Benefits</strong></p><ul>\\\n <li>Great opportunities for career development</li> <li>All your equipment provided including a laptop</li> <li>Increasing vacation days with each year of employment</li> </ul>",
+  "description": " <p>We are looking for an Office Manager to organize and coordinate office operations and procedures, in order to ensure organizational effectiveness, efficiency and safety.The ideal candidate will be experienced in handling a wide range of administrative and executive support related tasks and will be able to work independently with little or no supervision. This person must be exceedingly well organized, flexible and enjoy the administrative challenges of supporting an office of diverse people.</p> <p>Responsibilities:<ul> <li>Serve as the point person for maintenance, mailing, shopping, supplies, equipment, bills, and errands</li> <li>Organize and schedule meetings and appointments</li> <li>Partner with HR to maintain office policies as necessary</li> <li>Organize office operations and proceduresCoordinate with IT department on all office equipment</li> <li>Manage relationships with vendors, service providers, and landlord, ensuring that all items are invoiced and paid on time</li> <li>Manage contract and price negotiations with office vendors, service providers and office lease</li> <li>Manage office G&A budget, ensure accurate and timely reporting</li> <li>Provide general support to visitors</li> </ul></p>",
+  "requirements": "<ul> <li>4+ years of office management, administrative or assistant experience</li> <li>Knowledge of office management systems and procedures</li> <li>Excellent time management skills and ability to multi-task and prioritize work</li> <li>Attention to detail and problem solving skills</li> <li>Excellent written and verbal communication skills</li> <li>Strong organizational and planning skills</li> <li>Proficiency in MS Office</li> </ul>",
+  "benefits": "<ul> <li>Great opportunities for career development</li> <li>All your equipment provided including a laptop</li> <li>Increasing vacation days with each year of employment</li> </ul>",
+  "employment_type": "Full-time",
+  "industry": "Business Supplies and equipment",
+  "function": "Administrative",
+  "experience": "Associate",
+  "education": "High School or equivalent"
+}

data/spec/fixtures/job_candidate.json

@@ -0,0 +1,119 @@
+{
+  "candidate": {
+    "id": "108d1748",
+    "name": "Cindy Sawyers",
+    "firstname": "Cindy",
+    "lastname": "Sawyers",
+    "headline": "Operations Manager",
+    "image_url": null,
+    "account": {
+      "subdomain": "groove-tech",
+      "name": "Groove Tech"
+    },
+    "job": {
+      "shortcode": "GROOV005",
+      "title": "Office Manager"
+    },
+    "stage": "Applied",
+    "disqualified": false,
+    "disqualified_at": null,
+    "disqualification_reason": null,
+    "sourced": false,
+    "profile_url": "https://groove-tech.workable.com/backend/jobs/376844767/candidates/277680758",
+    "address": "332 Clemmie Roads, Colorado, USA",
+    "phone": "(785)991-6256",
+    "email": "cindy_sawyers@gmail.com",
+    "outbound_mailbox": "azjp_gws@outbound.workable.mailgun.org",
+    "domain": "twitter.com",
+    "uploader_id": null,
+    "created_at": "2015-07-01T00:00:00Z",
+    "updated_at": "2015-07-06T12:16:51Z",
+    "cover_letter": null,
+    "summary": "A focussed, results-driven team player with many year experience in the field. Working my way up to management level, I have experience of every aspect of this role. I understand the challenges it brings, and have a proven track record of providing solutions.",
+    "education_entries": [
+      {
+        "degree": "B.A. Business Studies",
+        "school": "University of Chicago",
+        "field_of_study": null,
+        "start_date": "2001-01-01",
+        "end_date": "2005-01-01"
+      },
+      {
+        "degree": "Diploma",
+        "school": "Juliet Hargreaves High School",
+        "field_of_study": null,
+        "start_date": "1997-01-01",
+        "end_date": "2001-01-01"
+      }
+    ],
+    "experience_entries": [
+      {
+        "title": "Executive Assistant",
+        "summary": "<ul><li>Dealt with contacts and correspondence.</li><li>Managed suppliers, contractors and office systems.</li><li>Maintained handbooks, policies and practices, ensuring they were understood and adhered to by all staff.</li><li>Coordinated and project managed the office relocation and renovation.</li></ul>",
+        "start_date": "2013-01-01",
+        "end_date": null,
+        "company": "Overflow Furnishings",
+        "industry": null,
+        "current": true
+      },
+      {
+        "title": "Resources Manager",
+        "summary": "<ul><li>Coordinated agendas and papers, minute taking and maintaining records for the management committee.</li><li>Managed vendor/supplier relationships.</li><li>Responsible for overall management of the office, including budgets and building and facilities management.</li><li>Ensured compliance with health and safety and other workplace legislation, including regular risk assessments.</li></ul>",
+        "start_date": "2009-01-01",
+        "end_date": "2013-01-01",
+        "company": "Kidlaw Supplies",
+        "industry": null,
+        "current": false
+      },
+      {
+        "title": "Administrative Officer",
+        "summary": "<ul><li>Managed the implementation and development of an effective recruitment program.</li><li>Organised Fire and First Aid training.</li><li>Developed induction and handover processes for staff, interns, trustees and volunteers.</li><li>Planned and managed the CEO\\\\’s diary of internal and external meetings.</li></ul>",
+        "start_date": "2005-01-01",
+        "end_date": "2009-01-01",
+        "company": "Spakes IT Services",
+        "industry": null,
+        "current": false
+      }
+    ],
+    "skills": [
+      {
+        "name": "Administration"
+      },
+      {
+        "name": "Organization"
+      },
+      {
+        "name": "Budgeting"
+      },
+      {
+        "name": "Project Management"
+      },
+      {
+        "name": "MS Office"
+      },
+      {
+        "name": "Event Management"
+      }
+    ],
+    "answers": [],
+    "resume_url": null,
+    "social_profiles": [
+      {
+        "type": "twitter",
+        "name": "Twitter",
+        "username": "cindy_sawyers",
+        "url": "http://www.twitter.com/cindy_sawyers"
+      },
+      {
+        "type": "linkedin",
+        "name": "LinkedIn",
+        "url": "http://www.linkedin.com/in/cindy_sawyers"
+      },
+      {
+        "type": "googleplus",
+        "url": "https://plus.google.com/1849771376195546"
+      }
+    ],
+    "tags": []
+  }
+}

data/spec/fixtures/job_candidates.json

@@ -0,0 +1,58 @@
+
+
+{
+  "candidates": [
+    {
+      "id": "ce4da98",
+      "name": "Lakita Marrero",
+      "firstname": "Lakita",
+      "lastname": "Marrero",
+      "headline": "Operations Manager",
+      "account": {
+        "subdomain": "groove-tech",
+        "name": "Groove Tech"
+      },
+      "job": {
+        "shortcode": "GROOV005",
+        "title": "Office Manager"
+      },
+      "stage": "Interview",
+      "disqualified": true,
+      "disqualification_reason": null,
+      "sourced": false,
+      "profile_url": "https://groove-tech.workable.com/backend/jobs/376844767/candidates/216323526",
+      "email": "lakita_marrero@gmail.com",
+      "domain": "twitter.com",
+      "created_at": "2015-06-26T00:00:00Z",
+      "updated_at": "2015-07-08T14:46:48Z"
+    },
+    {
+      "id": "108d1748",
+      "name": "Cindy Sawyers",
+      "firstname": "Cindy",
+      "lastname": "Sawyers",
+      "headline": "Talented Operations Executive",
+      "account": {
+        "subdomain": "groove-tech",
+        "name": "Groove Tech"
+      },
+      "job": {
+        "shortcode": "GROOV005",
+        "title": "Office Manager"
+      },
+      "stage": "Applied",
+      "disqualified": false,
+      "disqualification_reason": null,
+      "sourced": false,
+      "profile_url": "https://groove-tech.workable.com/backend/jobs/376844767/candidates/277680758",
+      "email": "cindy_sawyers@gmail.com",
+      "domain": "indeed.com",
+      "created_at": "2015-07-08T00:00:00Z",
+      "updated_at": "2015-07-08T14:46:48Z"
+    }
+  ],
+  "paging": {
+    "next": "https://www.workable.com/spi/v3/accounts/subdomain/jobs/subdomain/candidates?limit=3&since_id=2700d6df"
+  }
+}
+

data/spec/fixtures/job_questions.json

@@ -0,0 +1,34 @@
+{
+  "questions": [
+    {
+      "id": "2128d717",
+      "body": "Explain one aspect of this role you believe you will excel at.",
+      "type": "free_text"
+    },
+    {
+      "id": "3399e6cd",
+      "body": "How many years administrative experience do you have?",
+      "type": "multiple_choice",
+      "single_answer": true,
+      "choices": [
+        {
+          "id": "3049114a",
+          "body": "0-3 years"
+        },
+        {
+          "id": "29406296",
+          "body": "3-5 years"
+        },
+        {
+          "id": "1e477229",
+          "body": "Over 5 years"
+        }
+      ]
+    },
+    {
+      "id": "1d3f348f",
+      "body": "Intermediate or above proficiency with MS Office?",
+      "type": "boolean"
+    }
+  ]
+}