Getting Started

This tutorial is geared towards first-time GitHub user accounts; getting them up to speed and providing reference samples:

• Implementing and running a Manual test
• Include automated fixturing with a Manual test
• Publishing Automated test results

The tutorial requires using both your GitHub and Testspace accounts.

Personal Account

The tutorial requires using both GitHub and Testspace. The tutorial samples assumes the use of your personal GitHub account and a corresponding Testspace organization. If you do not have accounts use the following sites:

• https://github.com to sign up for a GitHub account
• https://github.com/marketplace/testspace-com to sign up and install the Testspace App using your GitHub credentials, on your personal GitHub account

Samples

This tutorial contains several examples for how to use Testspace. A repo with files is required for each of these examples, which can either be created by following the instructions in the examples or by forking these public repository samples. If you are using a non-personal GitHub account see the shared account section first before starting on the tutorials listed below.

• Manual Hello World
• Manual Hello w/ Automation
• Publish using CI

See other language specific samples for publishing test results.

Fork any of the repositories if you prefer to make a copy of the content vs adding the steps manually. Several of the samples leverage GitHub Actions for automation and will require you to enable workflows if they are forked.

Enable Workflows

When a repository is forked, the automation has to be manually enabled.

GitHub Workflows are required to be enabled manually when a repo is forked

Consider enabling Issues via the repository settings. Issues can be generated by Testspace when a Manual test case fails.

Shared Account

Testspace can be installed on a GitHub organization using the GitHub Marketplace. A new Testspace organization will also be created, matching the name of your GitHub organization.

Use the GitHub Marketplace to install Testspace on a GitHub team organization.

Few important notes:

• To use the GitHub Marketplace you must be an owner of the GitHub organization.
• Once installed it is required to enable the Organization under the Testsapce Services tab.

Invite Others

When using a GitHub Organization account and a corresponding Testspace organization, it is easy to invite other GitHub members.

• GitHub member will require a Testspace account. Have the member Sign up here and install Testspace using their GitHub credentials.
• At the Testspace Organization level select the Users tab.
• Click the Invite Users button at the upper right of the page.
• In the dialog that's shown select the GitHub icon.
• A list of all GitHub members that have Testspace accounts will be listed.
• Under Project Access, check the box next to the names of Projects for which these users are to have access.
• Click the ''SUBMIT'' button at the bottom of the dialog.

For more Testspace account admin information click here.