@sum.cumo/node-testrail
v2.4.1
Published
An API wrapper for TestRail
Downloads
5,054
Readme
Node-TestRail
Node-TestRail is an api wrapper for TestRail. It contains an easy way to interact with all of the API commands for version 2 of the testrail API.
https://www.gurock.com/testrail/docs/api
Installation
Yarn
yarn add -D @sum.cumo/node-testrail
NPM
npm install @sum.cumo/node-testrail --save-dev
How to use (Examples)
var TestRail = require("@sum.cumo/node-testrail");
var testrail = new TestRail("https://example.testrail.com/", "[email protected]", "password");
testrail
.addResult(TEST_ID, STATUS_ID, COMMENT, VERSION, ELAPSED_TIME, DEFECTS, ASSIGNEDTO_ID)
.then((body) => {
console.log(body)
})
testrail
.getUserByEmail(EMAIL)
.then((user) => {
console.log(user)
})
testrail
.getTest(TEST_ID)
.then((test) => {
console.log(test)
})
testrail.addAttachmentToRun('123', '/path/to/file')
// This will upload an myAssets.zip containing all files and sub directories provided.
// Use a colon if you need to provide a new directory name
testrail
.addAttachmentsToRun(
'123',
[
'path/to/some/asset/dir',
'path/to/another/dir:newDirectoryName/InArchive'
],
'myAssets'
)
All the helper functions can be found under src within index.js
Available Commands
ATTACHMENTS
addAttachmentToCase(caseId: string, attachment: string): Promise<AxiosResponse>
addAttachmentToPlan(planId: string, attachment: string): Promise<AxiosResponse>
addAttachmentToPlanEntry(planId: string, entryId: string, attachment: string): Promise<AxiosResponse>
addAttachmentToResult(resultId: string, attachment: string): Promise<AxiosResponse>
addAttachmentToRun(runId: string, attachment: string): Promise<AxiosResponse>
addAttachmentsToRun(runId: string, attachments: string[], assetsArchiveName: null | string = null): Promise<AxiosResponse | null>
CASES
getCase(case_id)
getCases(project_id, suite_id, section_id)
addCase(section_id, title, type_id, project_id, estimate, milestone_id, refs)
updateCase(case_id, title, type_id, project_id, estimate, milestone_id,refs)
deleteCase(case_id)
Case FIELDS
getCaseFields()
Case TYPES
getCaseTypes()
Configurations
getConfigs(project_id)
Milestones
getMilestone(milestone_id)
getMilestones(project_id)
addMilestone(project_id, name, description, due_on)
updateMilestone(milestone_id, name, description, due_on, is_completed)
deleteMilestone(milestone_id)
PLANS
getPlan(plan_id)
getPlans(project_id)
addPlan(project_id, name, description, milestone_id)
addPlanEntry(plan_id, suite_id, name, assignedto_id, include_all)
updatePlan(plan_id, name, description, milestone_id)
updatePlanEntry(plan_id, entry_id, name, assignedto_id, include_all)
closePlan(plan_id)
deletePlan(plan_id)
deletePlanEntry(plan_id, entry_id)
PRIORITIES
getPriorities()
PROJECTS
getProject(project_id)
getProjects()
addProject(name, announcement, show_announcement)
updateProject(project_id, name, announcement, show_announcement, is_completed)
deleteProject(project_id)
RESULTS
getResults(test_id, limit)
getResultsForCase(run_id, case_id, limit)
addResult(test_id, status_id, comment, version, elapsed, defects, assignedto_id)
addResults(run_id, results)
addResultForCase(run_id, case_id, status_id, comment, version, elapsed, defects, assignedto_id)
addResultsForCases(run_id, results)
RESULT FIELDS
getResultFields()
RUNS
getRun(run_id)
getRuns(run_id)
addRun(projectID, suite_id, name, description, milestone_id, includeAll, caseIds, refs)
updateRun(runID, name, description, milestone_id, includeAll, caseIds, refs)
closeRun(run_id)
deleteRun(run_id)
STATUSES
getStatuses()
SECTIONS
getSection(section_id)
getSections(project_id, suite_id)
addSection(project_id, suite_id, parent_id, name)
updateSection(section_id, name)
deleteSection(section_id)
SUITES
getSuite(suite_id)
getSuites(project_id)
addSuite(project_id,name, description)
updateSuite(suite_id,name, description)
deleteSuite(suite_id)
TESTS
getTest(test_id)
getTests(run_id)
USERS
getUser(user_id)
getUserByEmail(email)
Thank you for using this module and feel free to contribute.
License
MIT