/**
     * Interpolates the values in the given map using the provided callback function.
     * This method defaults to setting empty strings for unresolved placeholders.
     *
     * @param properties The map containing key-value pairs to be interpolated.
     * @param callback The function to resolve variable values not found in the map.
     */

     * Extracts text data from the given input stream.
     *
     * @param in the input stream to extract text from
     * @param params a map of parameters to be used during extraction
     * @return an ExtractData object containing the extracted text
     */
    ExtractData getText(InputStream in, Map<String, String> params);

    /**
     * Returns the weight of the extractor.
     * The default implementation returns a weight of 1.
     *

It will have a property `scopes` with a list containing all the scopes required by itself and all the dependencies that use this as a sub-dependency. That means, all the "dependants"... this might sound confusing, it is explained again later below.

The `security_scopes` object (of class `SecurityScopes`) also provides a `scope_str` attribute with a single string, containing those scopes separated by spaces (we are going to use it).

     *
     * @return a byte array containing the data.
     */
    byte[] getData();

    /**
     * Retrieves the data as a String.
     *
     * @return the data in String format.
     */
    String getDataAsString();

    /**
     * Sets the data for this AccessResultData instance.
     *
     * @param data the byte array containing the data to be set
     */
    void setData(byte[] data);

    @Nonnull
    Toolchain createToolchain(@Nonnull ToolchainModel model) throws ToolchainFactoryException;

    /**
     * Creates a default toolchain instance using system defaults.
     *
     * @return Optional containing the default toolchain if available
     * @throws ToolchainFactoryException if default toolchain creation fails
     */
    @Nonnull
    Optional<Toolchain> createDefaultToolchain() throws ToolchainFactoryException;

     * @param tokenPattern The regex pattern to extract the token.
     * @param responseParams The list to store response parameters.
     * @param entity The HTTP entity containing the token page content.
     */
    protected void parseTokenPage(final String tokenPattern, final List<Pair<String, String>> responseParams, final HttpEntity entity) {
        try {

     *
     * @param responseBody the byte array containing the response body
     */
    public void setResponseBody(final byte[] responseBody) {
        responseBodyBytes = responseBody;
    }

    /**
     * Sets the response body from a file.
     *
     * @param responseBody the file containing the response body

@Experimental
public interface Parser {
    /**
     * Parses the given ParserRequest to create an {@link InvokerRequest}.
     * This method does interpret tool arguments.
     *
     * @param parserRequest the request containing all necessary information for parsing
     * @return the parsed invoker request. Caller must start by checking {@link InvokerRequest#parsingFailed()} as

    /**
     * Creates a {@link org.apache.maven.api.Project} from a POM file.
     *
     * @param request {@link ProjectBuilderRequest}
     * @return the {@link ProjectBuilderResult} containing the built project and possible errors
     * @throws ProjectBuilderException if the project cannot be created
     * @throws IllegalArgumentException if an argument is {@code null} or invalid
     */
    @Nonnull

In your client you will get a JSON response like:

```JSON
{
  "model_name": "alexnet",
  "message": "Deep Learning FTW!"
}
```

## Path parameters containing paths { #path-parameters-containing-paths }

Let's say you have a *path operation* with a path `/files/{file_path}`.

But you need `file_path` itself to contain a *path*, like `home/johndoe/myfile.txt`.