Skip to content

Commit

Permalink
Merge pull request #1573 from apiaryio/611-docs-api-project-name
Browse files Browse the repository at this point in the history
Uses "API Project Name" term over "API Project Subdomain"
  • Loading branch information
honzajavorek committed Oct 22, 2019
2 parents 47f4826 + 950783d commit 5c9f0e7
Show file tree
Hide file tree
Showing 5 changed files with 11 additions and 11 deletions.
6 changes: 3 additions & 3 deletions docs/how-to-guides.rst
Original file line number Diff line number Diff line change
Expand Up @@ -685,7 +685,7 @@ Command-line output of complex HTTP responses and expectations can be hard to re
::

$ dredd apiary.apib http://127.0.0.1 --reporter=apiary
warn: Apiary API Key or API Project Subdomain were not provided. Configure Dredd to be able to save test reports alongside your Apiary API project: https://dredd.org/en/latest/how-to-guides/#using-apiary-reporter-and-apiary-tests
warn: Apiary API Key or API Project Name were not provided. Configure Dredd to be able to save test reports alongside your Apiary API project: https://dredd.org/en/latest/how-to-guides/#using-apiary-reporter-and-apiary-tests
pass: DELETE /honey duration: 884ms
complete: 1 passing, 0 failing, 0 errors, 0 skipped, 1 total
complete: Tests took 1631ms
Expand All @@ -712,12 +712,12 @@ As you can see, the parameters go like this:

::

$ dredd -j apiaryApiKey:<Apiary API Key> -j apiaryApiName:<API Project Subdomain>
$ dredd -j apiaryApiKey:<Apiary API Key> -j apiaryApiName:<API Project Name>

In addition to using parameters and ``dredd.yml``, you can also use environment variables:

- ``APIARY_API_KEY=<Apiary API Key>`` - Alternative way to pass credentials to Apiary Reporter.
- ``APIARY_API_NAME=<API Project Subdomain>`` - Alternative way to pass credentials to Apiary Reporter.
- ``APIARY_API_NAME=<API Project Name>`` - Alternative way to pass credentials to Apiary Reporter.

When sending test reports to Apiary, Dredd inspects the environment where it was executed and sends some information about it alongside test results. Those are used mainly for detection whether the environment is Continuous Integration and also, they help you to identify individual test reports on the *Tests* page. You can use the following variables to tell Dredd what to send:

Expand Down
8 changes: 4 additions & 4 deletions packages/dredd/ApiaryReportingApi.apib
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ with [Gavel](https://github.com/apiaryio/gavel.js).
### Test Runs [/apis/{apiProject}/tests/runs]

+ Parameters
+ apiProject: exampleapi (required) - API project subdomain
+ apiProject: exampleapi (required) - API Project Name

#### Create a Test Run [POST]

Expand Down Expand Up @@ -47,7 +47,7 @@ with [Gavel](https://github.com/apiaryio/gavel.js).
### Test Run [/apis/{apiProject}/tests/run/{id}]

+ Parameters
+ apiProject: exampleapi (required) - API project subdomain
+ apiProject: exampleapi (required) - API Project Name
+ id: 507f1f77bcf86cd799439011 (required) - unique ID of the test report

#### Retrieve a Test Run [GET]
Expand Down Expand Up @@ -87,7 +87,7 @@ with [Gavel](https://github.com/apiaryio/gavel.js).
### Test Steps [/apis/{apiProject}/tests/steps{?testRunId}]

+ Parameters
+ apiProject: exampleapi (required) - API project subdomain
+ apiProject: exampleapi (required) - API Project Name
+ testRunId: 507f1f77bcf86cd799439011 (required) - filter by test report ID

#### Create a Test Step [POST]
Expand Down Expand Up @@ -118,7 +118,7 @@ with [Gavel](https://github.com/apiaryio/gavel.js).
#### Retreive a Test Step [GET]

+ Parameters
+ apiProject: exampleapi (required) - API project subdomain
+ apiProject: exampleapi (required) - API Project Name
+ id: 508c7f79bcf86cd7994f6c0e (required) - Unique identifier of test step in Apiary

+ Request (application/json)
Expand Down
2 changes: 1 addition & 1 deletion packages/dredd/lib/reporters/ApiaryReporter.js
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ function ApiaryReporter(emitter, stats, config, runner) {

if (!this.configuration.apiToken && !this.configuration.apiSuite) {
logger.warn(`
Apiary API Key or API Project Subdomain were not provided.
Apiary API Key or API Project Name were not provided.
Configure Dredd to be able to save test reports alongside your Apiary API project:
https://dredd.org/en/latest/how-to-guides/#using-apiary-reporter-and-apiary-tests
`);
Expand Down
4 changes: 2 additions & 2 deletions packages/dredd/test/integration/apiary-reporter-test.js
Original file line number Diff line number Diff line change
Expand Up @@ -140,7 +140,7 @@ describe('Apiary reporter', () => {
it('should not print warning about missing Apiary API settings', () =>
assert.notInclude(
output,
'Apiary API Key or API Project Subdomain were not provided.',
'Apiary API Key or API Project Name were not provided.',
));

it('should contain Authentication header thanks to apiaryApiKey and apiaryApiName configuration', () => {
Expand Down Expand Up @@ -300,7 +300,7 @@ describe('Apiary reporter', () => {
it('should print warning about missing Apiary API settings', () =>
assert.include(
output,
'Apiary API Key or API Project Subdomain were not provided.',
'Apiary API Key or API Project Name were not provided.',
));

it('should print link to documentation', () =>
Expand Down
2 changes: 1 addition & 1 deletion packages/dredd/test/integration/cli/reporters-cli-test.js
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ describe('CLI - Reporters', () => {
it('should print warning about missing Apiary API settings', () =>
assert.include(
cliInfo.stdout,
'Apiary API Key or API Project Subdomain were not provided.'
'Apiary API Key or API Project Name were not provided.'
))
it('should exit with status 0', () => assert.equal(cliInfo.exitStatus, 0))
it('should perform 3 requests to Apiary', () => {
Expand Down

0 comments on commit 5c9f0e7

Please sign in to comment.