FAQ

How do I report an issue?

We track issues in Github at https://github.com/Stoobly/stoobly-agent/issues. Please provide as much information as possible and we will take a look 😄

Where do I find the latest releases?

pip releases can be found on PyPI.

Docker image releases can be found on Docker Hub.

To currently see the agent code changes, see the Github Releases and their changelogs.

To learn how the contributors publish releases, see our Developer Guide on Releases.

Is this a test framework?

While Stoobly provides similar functionality in respect to running and provide output for tests, our motive is more to provide a centralized storage for HTTP(s) requests from which you can:

• Search requests

• Build requests into scenarios

• Generate endpoint contracts

• Mock requests

• Test request and scenarios

At our core we are essentially a hash map where the key is the request components such as:

• URL, port number, path, headers, query parameters, body

And the value is the recorded request's response components:

• headers, body, status code

In regards to mocking and testing, we provide the ability to dramatically reduce the need to write and maintain request and response components in test code. Here is how we tackle the core challenges with testing:

1. Generation:

   • Record requests and scenarios
2. Correctness:

   • Replay recorded requests and compare response against recorded response

3. Maintenance:

   • Replay requests to update responses

   • Contract testing to ensure validity of requests and responses