testrail-ruby 0.0.26 → 0.0.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 904c7cb657f6119209dc39dab2ff4bede4b639c5
-  data.tar.gz: 7c42db52877d5de46334bae1ee84e749ddb382b4
+  metadata.gz: 928183b23034905ff5b66c5a8aa1f6ce5635ecd8
+  data.tar.gz: 802c7abb8fe7766de441ba64fbcc0083e2d47299
 SHA512:
-  metadata.gz: a42df30911e8911ab678b8addab502a259220ccf07fd574ae2780667d7795f574ffe5e9bb759ab40917e51ffe61a2f6a27e06980aa6dc77b21458dfd331d9df9
-  data.tar.gz: 697a7bb11855a1c67e2da489fff779fcf8aa8b586a6f6180377378bfc36f54813c7f4d5ea19755616b4fd61fd5be9e10717ca3cfd64385f328a6a56b0c7f0a21
+  metadata.gz: a601eec402e070a1322282b6bf262a2f94c625aaf49b7ff9aa3ccc1548d575e635a92cbf41f6f5e76e59c16863d3ca189cb22f2c427b1f469c907f11f37d1abe
+  data.tar.gz: 4f820237599e4b8f86db03a5841f91bccf572b32eb60e9faa6df0912a0026fc604a906df2a945706c86af655df94dffdefac138e6517462cb614959608d8c8b1

data/lib/endpoints.rb

@@ -1,688 +1,493 @@
 module Endpoints
-##########################++
-####get_case################
-############################
   # Returns an existing test case
   # @param case_id [int] The id of the test case you want.
-  # @example Code Example
-  #   @client.get_case(1)
-  # @example Endpoint Example
-  #   GET index.php?/api/v2/get_case/1
-  # @example Response Example
-  #    {
-  #      "created_by": 5,
-  #      "created_on": 1392300984,
-  #      "custom_expected": "..",
-  #      "custom_preconds": "..",
-  #      "custom_steps": "..",
-  #      "custom_steps_separated": [
-  #          {
-  #              "content": "Step 1",
-  #              "expected": "Expected Result 1"
-  #          },
-  #          {
-  #              "content": "Step 2",
-  #              "expected": "Expected Result 2"
-  #         }
-  #      ],
-  #      "estimate": "1m 5s",
-  #      "estimate_forecast": null,
-  #      "id": 1,
-  #      "milestone_id": 7,
-  #      "priority_id": 2,
-  #      "refs": "RF-1, RF-2",
-  #      "section_id": 1,
-  #      "suite_id": 1,
-  #      "title": "Change document attributes (author, title, organization)",
-  #      "type_id": 4,
-  #      "updated_by": 1,
-  #      "updated_on": 1393586511
-  #    }
+  # @param [Hash] opts
+  # @example Endpoint
+  #   index.php?/api/v2/get_case/:case_id
   # @see http://docs.gurock.com/testrail-api2/reference-cases
-  def get_case(case_id)
-    send_get("get_case/#{case_id.to_s}")
+  def get_case(case_id, opts = nil)
+    send_get("get_case/#{case_id}", opts)
   end
 
-##########################++
-####get_cases###############
-############################
   # Returns a list of test cases for a test suite or specific section in a test suite.
   # @param project_id [int] The id of the project that contains your tests
   # @param [Hash] opts
-  # @option opts [int]            :suite_id       The ID of the test suite (optional if the project is operating in single suite mode)
-  # @option opts [int]            :section_id     The ID of the section (optional)
-  # @option opts [unix timestamp] :created_after  Only return test cases created after this date (as UNIX timestamp).
-  # @option opts [unix timestamp] :created_before Only return test cases created before this date (as UNIX timestamp).
-  # @option opts [int(list)]      :created_by     A comma-separated list of creators (user IDs) to filter by.
-  # @option opts [int(list)]      :milestone_id   A comma-separated list of milestone IDs to filter by (not available if the milestone field is disabled for the project).
-  # @option opts [int(list)]      :priority_id    A comma-separated list of priority IDs to filter by.
-  # @option opts [int(list)]      :template_id    A comma-separated list of template IDs to filter by (requires TestRail 5.2 or later)
-  # @option opts [int(list)]      :type_id        A comma-separated list of case type IDs to filter by.
-  # @option opts [unix timestamp] :updated_after  Only return test cases updated after this date (as UNIX timestamp).
-  # @option opts [unix timestamp] :updated_before Only return test cases updated before this date (as UNIX timestamp).
-  # @option opts [int(list)]      :updated_by     A comma-separated list of users who updated test cases to filter by.
-  # @example Code Example
-  #   @client.get_cases(1, {"suite_id":1, "section_id":1})
-  # @example Endpoint Example
-  #   GET index.php?/api/v2/get_cases/1&suite_id=1&section_id=1
-  # @example Response Example
-  #   [
-  #    { "id": 1, "title": "..", .. },
-  #    { "id": 2, "title": "..", .. },
-  #    ..
-  #   ]
+  # @example Endpoint
+  #   index.php?/api/v2/get_cases/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-cases
-  def get_cases(project_id, suite_id, opts = {})
-    send_get("get_cases/#{project_id.to_s}&suite_id=#{suite_id.to_s}", opts)
+  def get_cases(project_id, opts = {})
+    options = opts.to_a.map { |x| "#{x[0]}=#{x[1]}" }.join("&")
+    send_get("get_cases/#{project_id.to_s}&#{options}", opts)
   end
 
-##################deprecated
-####get_cases_by_section####
-############################
   # Return all test cases in a given project by suite_id and section_id
-  # @deprecated use get_cases instead
+  # @param project_id [int] The id of the project that contains your tests
+  # @param suite_id [int] The id of the suite within the project
+  # @param section_id [int] The id of the section within the suite
+  # @param [Hash] opts
+  # @example Endpoint
+  #   index.php?/api/v2/get_cases/:project_id&suite_id=:suite_id&section_id=:section_id
+  # @see http://docs.gurock.com/testrail-api2/reference-cases
   def get_cases_by_section(project_id, suite_id, section_id, opts = {})
-    send_get("get_cases/#{project_id.to_s}&suite_id=#{suite_id.to_s}&section_id=#{section_id.to_s}", opts)
+    send_get("get_cases/:#{project_id.to_s}&suite_id=:#{suite_id.to_s}&section_id=:#{section_id.to_s}", opts)
   end
 
-##################deprecated
-####get_cases_by_suite######
-############################
   # Return all test cases in a given project by suite_id
-  # @deprecated use get_cases instead
+  # @param project_id [int] The id of the project that contains your tests
+  # @param suite_id [int] The id of the suite within the project
+  # @param [Hash] opts
+  # @example Endpoint
+  #   index.php?/api/v2/get_cases/:project_id&suite_id=:suite_id
+  # @see http://docs.gurock.com/testrail-api2/reference-cases
   def get_cases_by_suite(project_id, suite_id, opts = {})
-    send_get("get_cases/#{project_id.to_s}&suite_id=#{suite_id.to_s}", opts)
+    send_get("get_cases/:#{project_id.to_s}&suite_id=:#{suite_id.to_s}", opts)
   end
 
-############################
-####add_case################
-############################
   # Creates a new test case
   # @param section_id [int] The id of the test case
   # @param [Hash] opts
-  # @option opts [string]   :title        The title of the test case (required)
-  # @option opts [int]      :template_id  The ID of the template (field layout) (requires TestRail 5.2 or later)
-  # @option opts [int]      :type_id      The ID of the case type
-  # @option opts [int]      :priority_id  The ID of the case priority
-  # @option opts [timespan] :estimate     The estimate, e.g. "30s" or "1m 45s"
-  # @option opts [int]      :milestone_id The ID of the milestone to link to the test case
-  # @option opts [string]   :refs         A comma-separated list of references/requirements
-  # @example Code Example
-  #   @client.add_case(1, {"title":"testCaseName", "type_id":1})
-  # @example Endpoint Example
-  #   index.php?/api/v2/add_case/1&title="foo"&type_id=1
+  # @example Endpoint
+  #   index.php?/api/v2/add_case/:section_id
   # @see http://docs.gurock.com/testrail-api2/reference-cases
   def add_case(section_id, opts = {})
-    send_post("add_case/#{section_id.to_s}", opts)
+    send_post("add_case/:#{section_id.to_s}", opts)
   end
 
-############################
-####update_case#############
-############################
   # Update test result by case id
   # @param case_id [int] The id of the test case
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/update_case/:case_id
   # @see http://docs.gurock.com/testrail-api2/reference-cases
   def update_case(case_id, opts = {})
     send_post("update_case/:#{case_id.to_s}", opts)
   end
 
-############################
-####delete_case################
-############################
   # Delete test case by case id
   # @param case_id [int] The id of the test case
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/delete_case/:case_id
   # @see http://docs.gurock.com/testrail-api2/reference-cases
   def delete_case(case_id, opts = {})
     send_post("delete_case/:#{case_id.to_s}", opts)
   end
 
-############################
-####get_suite###############
-############################
   # Return suite by suite id
   # @param suite_id [int] The suite id
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_suite/:suite_id
   # @see http://docs.gurock.com/testrail-api2/reference-suites
   def get_suite(suite_id, opts = {})
     send_get("get_suite/:#{suite_id.to_s}", opts)
   end
 
-############################
-####get_suites##############
-############################
   # Return all suites in project by project id
-  # @param project_id (see get_cases)
+  # @param project_id [int] The id of the project containing suites
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_suites/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-suites
   def get_suites(project_id, opts = {})
     send_get("get_suites/:#{project_id.to_s}", opts)
   end
 
-############################
-####add_suite###############
-############################
   # Add a test suite
   # @param project_id [int] The id of the project containing suites
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_suite/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-suites
   def add_suite(project_id, opts = {})
     send_post("add_suite/:#{project_id.to_s}", opts)
   end
 
-############################
-####update_suite############
-############################
   # update a test suite
   # @param suite_id [int] The suite id
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/update_suite/:suite_id
   # @see http://docs.gurock.com/testrail-api2/reference-suites
   def update_suite(suite_id, opts = {})
     send_post("update_suite/:#{suite_id.to_s}", opts)
   end
 
-############################
-####delete_suite############
-############################
   # Delete a test suite
   # @param suite_id [int] The suite id
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/delete_suite/:suite_id
   # @see http://docs.gurock.com/testrail-api2/reference-suites
   def delete_suite(suite_id, opts = {})
     send_post("delete_suite/:#{suite_id.to_s}", opts)
   end
 
-
-############################
-####get_section#############
-############################
   # Return section by id
   # @param section_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_section/:section_id
   # @see http://docs.gurock.com/testrail-api2/reference-sections
   def get_section(section_id, opts = {})
     send_get("get_section/:#{section_id.to_s}", opts)
   end
 
-############################
-####get_sections############
-############################
   # Get sections for suite
   # @param suite_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_sections/:project_id&suite_id=:suite_id
   # @see http://docs.gurock.com/testrail-api2/reference-sections
   def get_sections(project_id, suite_id, opts = {})
     send_get("get_sections/#{project_id.to_s}&suite_id=#{suite_id.to_s}", opts)
   end
 
-############################
-####add_section#############
-############################
   # Add section to suite
   # @param project_id [int]
   # @param [Hash] opts
   # @option opts [Int] suite_id
   # @option opts [String] name
   # @option opts [Int] parent_id
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_section/:project_id
-  # @example Code Example
+  # @example Code
   #   @client.add_section(1, {"suite_id": 5, "name": "This is a new section", "parent_id": 10})
   # @see http://docs.gurock.com/testrail-api2/reference-sections
   def add_section(project_id, opts = {})
     send_post("add_section/#{project_id.to_s}", opts)
   end
 
-############################
-####get_milestone###########
-############################
   # Get milestone by milestone id
   # @param milestone_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_milestone/:milestone_id
   # @see http://docs.gurock.com/testrail-api2/reference-milestones
   def get_milestone(milestone_id, opts = {})
     send_get("get_milestone/:#{milestone_id.to_s}", opts)
   end
 
-############################
-####get_milestones##########
-############################
   # Get project milestones by project id
   # @param project_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_milestones/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-milestones
   def get_milestones(project_id, opts = {})
     send_get("get_milestones/:#{project_id.to_s}", opts)
   end
 
-############################
-####add_milestone###########
-############################
   # Add milestone to project id
   # @param project_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_milestone/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-milestones
   def add_milestone(project_id, opts = {})
     send_post("add_milestone/:#{project_id.to_s}", opts)
   end
 
-############################
-####update_milestone########
-############################
   # Add milestone to project id
   # @param milestone_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/update_milestone/:milestone_id
   # @see http://docs.gurock.com/testrail-api2/reference-milestones
   def update_milestone(milestone_id, opts = {})
     send_post("update_milestone/:#{milestone_id.to_s}", opts)
   end
 
-############################
-####delete_milestone########
-############################
   # Add milestone to project id
   # @param milestone_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/delete_milestone/:milestone_id
   # @see http://docs.gurock.com/testrail-api2/reference-milestones
   def delete_milestone(milestone_id, opts = {})
     send_post("delete_milestone/:#{milestone_id.to_s}", opts)
   end
 
-############################
-####get_plan################
-############################
   # Get plan by id
   # @param plan_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_plan/:plan_id
   # @see http://docs.gurock.com/testrail-api2/reference-plans
   def get_plan(plan_id, opts = {})
     send_get("get_plan/:#{plan_id.to_s}", opts)
   end
 
-############################
-####get_plans###############
-############################
   # Get plans in project by project id
   # @param project_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_plans/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-plans
   def get_plans(project_id, opts = {})
     send_get("get_plans/:#{project_id.to_s}", opts)
   end
 
-############################
-####add_plan################
-############################
   # Add plan to project by project id
   # @param project_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_plan/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-plans
   def add_plan(project_id, opts = {})
     send_post("add_plan/:#{project_id.to_s}", opts)
   end
 
-############################
-####add_plan_entry##########
-############################
   # Add plan entries by plan id
   # @param plan_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_plan_entry/:plan_id
   # @see http://docs.gurock.com/testrail-api2/reference-plans
   def add_plan_entry(plan_id, opts = {})
     send_post("add_plan_entry/:#{plan_id.to_s}", opts)
   end
 
-############################
-####update_plan#############
-############################
   # Update plan by plan id
   # @param plan_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/update_plan/:plan_id
   # @see http://docs.gurock.com/testrail-api2/reference-plans
   def update_plan(plan_id, opts = {})
     send_post("update_plan/:#{plan_id.to_s}", opts)
   end
 
-############################
-####update_plan_entry#######
-############################
   # Update plan entry by plan id
   # @param plan_id [int]
   # @param entry_id [int] Id of entry
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/update_plan_entry/:plan_id/:entry_id
   # @see http://docs.gurock.com/testrail-api2/reference-plans
   def update_plan_entry(plan_id, entry_id, opts = {})
     send_post("update_plan_entry/:#{plan_id.to_s}/:#{entry_id.to_s}", opts)
   end
 
-############################
-####close_plan##############
-############################
   # Close plan by plan id
   # @param plan_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/close_plan/:plan_id
   # @see http://docs.gurock.com/testrail-api2/reference-plans
   def close_plan(plan_id, opts = {})
     send_post("close_plan/:#{plan_id.to_s}", opts)
   end
 
-############################
-####delete_plan#############
-############################
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/delete_plan/:plan_id
   # @see http://docs.gurock.com/testrail-api2/reference-plans
   def delete_plan(plan_id, opts)
     send_post("delete_plan/:#{plan_id.to_s}", opts)
   end
 
-############################
-####delete_plan_by_entry####
-############################
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/delete_plan_entry/:plan_id/:entry_id
   def delete_plan_entry(plan_id, entry_id, opts = {})
     send_post("delete_plan_entry/:#{plan_id.to_s}/:#{entry_id.to_s}", opts)
   end
 
-############################
-####get_project#############
-############################
   # Get project by project id
   # @param project_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_project/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-projects
   def get_project(project_id, opts = {})
-    send_get("get_project/#{project_id}", opts)
+    send_get("get_project/:#{project_id.to_s}", opts)
   end
 
-############################
-####get_projects############
-############################
   # Get all projects
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_projects
   # @see http://docs.gurock.com/testrail-api2/reference-projects
   def get_projects(opts = {})
     send_get('get_projects', opts)
   end
 
-############################
-####add_project#############
-############################
   # Add a project
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_project
   # @see http://docs.gurock.com/testrail-api2/reference-projects
   def add_project(opts = {})
     send_post("add_project", opts)
   end
 
-############################
-####update_project##########
-############################
   # Update a project
   # @param project_id [int] The project you want to update
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/update_project/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-projects
   def update_project(project_id, opts)
     send_post("update_project/:#{project_id.to_s}", opts)
   end
 
-############################
-####delete_project##########
-############################
+
   # Delete a project
   # @param project_id [int] The project you want to delete
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/delete_project/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-projects
   def delete_project(project_id, opts)
     send_post("delete_project/:#{project_id.to_s}", opts)
   end
 
-############################
-####get_results#############
-############################
   # Returns a list of test results for a test
   # @param test_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_results/:test_id
   # @see http://docs.gurock.com/testrail-api2/reference-results
   def get_results(test_id, opts = {})
     send_get("get_results/:#{test_id.to_s}", opts)
   end
 
-############################
-####get_results_for_case####
-############################
   # Returns a list of test results for a test run and case combination
   # @param run_id [int]
   # @param case_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_results_for_case/:run_id/:case_id
   # @see http://docs.gurock.com/testrail-api2/reference-results
   def get_results_for_case(run_id, case_id, opts = {})
     send_get("get_results_for_case/:#{run_id.to_s}/:#{case_id.to_s}", opts)
   end
 
-############################
-####get_results_for_run#####
-############################
   # Returns a list of test results for a test run
   # @param run_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_results_for_run/:run_id
   # @see http://docs.gurock.com/testrail-api2/reference-results
   def get_results_for_run(run_id, opts = {})
     send_get("get_results_for_run/:#{run_id.to_s}", opts)
   end
 
-############################
-####add_result##############
-############################
   # Adds a new test result, comment or assigns a test. It's recommended to use add_results instead if you plan to add results for multiple tests.
   # @param test_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_result/:test_id
   # @see http://docs.gurock.com/testrail-api2/reference-results
   def add_result(test_id, opts = {})
     send_post("add_result/:#{test_id.to_s}", opts)
   end
 
-############################
-####add_result_for_case#####
-############################
   # Adds a new test result, comment or assigns a test (for a test run and case combination)
   # @param run_id [int]
   # @param case_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_result_for_case/:run_id/:case_id
   # @see http://docs.gurock.com/testrail-api2/reference-results
   def add_result_for_case(run_id, case_id, opts = {})
     send_post("add_result_for_case/:#{run_id.to_s}/:#{case_id.to_s}", opts)
   end
 
-############################
-####add_results#############
-############################
   # Adds one or more new test results, comments or assigns one or more tests
   # @param run_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_results/:run_id
   # @see http://docs.gurock.com/testrail-api2/reference-results
   def add_results(run_id, opts = {})
     send_post("add_results/:#{run_id.to_s}", opts)
   end
 
-############################
-####add_results_for_cases###
-############################
   # Adds one or more new test results, comments or assigns one or more tests (using the case IDs)
   # @param run_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_results_for_cases/:run_id
   # @see http://docs.gurock.com/testrail-api2/reference-results
   def add_results_for_cases(run_id, opts = {})
     send_post("add_results_for_cases/:#{run_id.to_s}", opts)
   end
 
-############################
-####get_run#################
-############################
   # Get run by run id
   # @param run_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_run/:run_id
   # @see http://docs.gurock.com/testrail-api2/reference-runs
   def get_run(run_id, opts = {})
     send_get("get_run/:#{run_id.to_s}", opts)
   end
 
-############################
-####get_runs################
-############################
   # Get runs by project id
   # @param project_id [int]
   # @param plan_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_runs/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-runs
   def get_runs(project_id, opts = {})
     send_get("get_runs/#{project_id.to_s}", opts)
   end
 
-############################
-####add_run#################
-############################
   # Add run by suite id
   # @param project_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/add_run/:project_id
   # @see http://docs.gurock.com/testrail-api2/reference-runs
   def add_run(project_id, opts = {})
     send_post("add_run/:#{project_id.to_s}", opts)
   end
 
-############################
-####update_run##############
-############################
   # Updates existing test run
   # @param run_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/update_run/:run_id
   # @see http://docs.gurock.com/testrail-api2/reference-runs
   def update_run(run_id, opts = {})
     send_post("update_run/:#{run_id.to_s}", opts)
   end
 
-############################
-####close_run###############
-############################
   # Closes an existing test run and archives its tests & results
   # @param run_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/close_run/:run_id
   # @see http://docs.gurock.com/testrail-api2/reference-runs
   def close_run(run_id, opts = {})
     send_post("close_run/#{run_id.to_s}", opts)
   end
 
-############################
-####delete_run##############
-############################
   # Deletes an existing test run.
   # @param run_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/delete_run/:run_id
   # @see http://docs.gurock.com/testrail-api2/reference-runs
   def delete_run(run_id, opts = {})
     send_post("delete_run/:#{run_id.to_s}", opts)
   end
 
-############################
-####get_test################
-############################
   # Returns an existing test
   # @param test_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_test/:test_id
   # @see http://docs.gurock.com/testrail-api2/reference-tests
   def get_test(test_id, opts = {})
     send_get("get_test/:#{test_id.to_s}", opts)
   end
 
-############################
-####get_tests###############
-############################
   # Returns a list of tests for a test run
   # @param run_id [int]
   # @param [Hash] opts
-  # @example Endpoint Example
+  # @example Endpoint
   #   index.php?/api/v2/get_tests/:run_id
   # @see http://docs.gurock.com/testrail-api2/reference-tests
   def get_tests(run_id, opts = {})

data/lib/testrail-ruby.rb

@@ -21,47 +21,23 @@ module TestRail
     attr_accessor :password
 
     def initialize(base_url)
-      if !base_url.match(/\/$/)
-        base_url += '/'
-      end
+      base_url += '/' unless base_url =~ /\/$/
       @url = base_url + 'index.php?/api/v2/'
     end
 
-    #
-    # Send Get
-    #
-    # Issues a GET request (read) against the API and returns the result
-    # (as Ruby hash).
-    #
-    # Arguments:
-    #
-    # uri                 The API method to call including parameters
-    #                     (e.g. get_case/1)
-    #
-    def send_get(uri)
-      _send_request('GET', uri, nil)
+    def send_get(uri, data)
+      _send_request('GET', uri, data)
     end
 
-    #
-    # Send POST
-    #
-    # Issues a POST request (write) against the API and returns the result
-    # (as Ruby hash).
-    #
-    # Arguments:
-    #
-    # uri                 The API method to call including parameters
-    #                     (e.g. add_case/1)
-    # data                The data to submit as part of the request (as
-    #                     Ruby hash, strings must be UTF-8 encoded)
-    #
     def send_post(uri, data)
       _send_request('POST', uri, data)
     end
 
     private
+
     def _send_request(method, uri, data)
       url = URI.parse(@url + uri)
+      puts "URL: #{url}"
       if method == 'POST'
         request = Net::HTTP::Post.new(url.path + '?' + url.query)
         request.body = JSON.dump(data)
@@ -78,20 +54,20 @@ module TestRail
       end
       response = conn.request(request)
 
-      if response.body && !response.body.empty?
-        result = JSON.parse(response.body)
-      else
-        result = {}
-      end
+      result = if response.body && !response.body.empty?
+                 JSON.parse(response.body)
+               else
+                 {}
+               end
 
       if response.code != '200'
-        if result && result.key?('error')
-          error = '"' + result['error'] + '"'
-        else
-          error = 'No additional error message received'
-        end
-        raise APIError.new('TestRail API returned HTTP %s (%s)' %
-          [response.code, error])
+        error = if result && result.key?('error')
+                  '"' + result['error'] + '"'
+                else
+                  'No additional error message received'
+                end
+        raise APIError, 'TestRail API returned HTTP %s (%s)' %
+                        [response.code, error]
       end
 
       result

data/lib/version.rb

@@ -1,3 +1,3 @@
 module Testrail
-  VERSION = '0.0.26'.freeze
+  VERSION = '0.0.27'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: testrail-ruby
 version: !ruby/object:Gem::Version
-  version: 0.0.26
+  version: 0.0.27
 platform: ruby
 authors:
 - Frances Morales
@@ -105,7 +105,6 @@ files:
 - README.md
 - Rakefile
 - lib/endpoints.rb
-- lib/testrail-ruby-broken.rb
 - lib/testrail-ruby.rb
 - lib/version.rb
 - spec/spec_helper.rb

data/lib/testrail-ruby-broken.rb

@@ -1,85 +0,0 @@
-require_relative 'version'
-require_relative 'endpoints'
-require 'net/http'
-require 'net/https'
-require 'uri'
-require 'json'
-
-## #USAGE:
-## #@client = TestRail::APIClient.new('YourBaseURLHere')
-## #@client.user = 'UserName'
-## #@client.password = 'Password'
-
-module TestRail
-  class APIClient
-    @url = ''
-    @user = ''
-    @password = ''
-
-    include Endpoints
-    attr_accessor :user
-    attr_accessor :password
-
-    def initialize(base_url)
-      base_url += '/' unless base_url =~ /\/$/
-      @url = base_url + 'index.php?/api/v2/'
-    end
-
-    def send_get(uri, data)
-      puts "Getting: #{uri}"
-      puts "Sending Data: #{data}"
-      _send_request('GET', uri, data)
-    end
-
-    def send_post(uri, data)
-      puts "Posting: #{uri}"
-      puts "Sending Data: #{data}"
-      _send_request('POST', uri, data)
-    end
-
-    private
-
-    def _send_request(method, uri, data)
-      url = URI.parse(@url + uri)
-      puts "URL: #{url}"
-      puts "url.query: #{url.query}"
-      puts "Data Payload: #{data}"
-      if method == 'POST'
-        request = Net::HTTP::Post.new(url.path + '?' + url.query)
-        request.body = JSON.dump(data)
-      else
-        request = Net::HTTP::Get.new(url.path + '?' + url.query)
-      end
-      request.basic_auth(@user, @password)
-      request.add_field('Content-Type', 'application/json')
-
-      conn = Net::HTTP.new(url.host, url.port)
-      if url.scheme == 'https'
-        conn.use_ssl = true
-        conn.verify_mode = OpenSSL::SSL::VERIFY_NONE
-      end
-      response = conn.request(request)
-
-      result = if response.body && !response.body.empty?
-                 JSON.parse(response.body)
-               else
-                 {}
-               end
-
-      if response.code != '200'
-        error = if result && result.key?('error')
-                  '"' + result['error'] + '"'
-                else
-                  'No additional error message received'
-                end
-        raise APIError, 'TestRail API returned HTTP %s (%s)' %
-                        [response.code, error]
-      end
-
-      result
-    end
-  end
-
-  class APIError < StandardError
-  end
-end