GobTools

Library to control and interact with the Goblin ecosystem.

What is GobTools?

GobTools streamlines access to GoblinWeaver.
By simply passing information as arguments to Python functions, requests are sent effortlessly, and responses are returned as dictionaries.

Please refer to the official repository for more details about GoblinWeaver.

Installation

• pip

Run the following command:

pip install git+https://github.com/Hietan/gobtools.git

• Rye

Run the following command in a rye project:

rye add gobtools --git https://github.com/Hietan/gobtools.git

Usage

1. Import

Import the necessary module for creating a controller instance:

from gobtools.weaver.controller import WeaverController

2. Instance Creation

Create an instance of the controller by specifying the URL of the GoblinWeaver API server.

controller = WeaverController("<your-api-server-url>")

3. Get Data

Get all releases of an artifact from org.apache.logging.log4j:log4j-core with added values (CVE, FRESHNESS).
The function get_artifact_releases sends POST requests to <your-api-server-url>/artifact/releases.
You can receive the results as dictionary.

releases = controller.get_artifact_releases(
    "org.apache.logging.log4j", 
    "log4j-core", 
    ["CVE", "FRESHNESS"]
)

Other REST API endpoints can also be accessed through GobTools function.
For detailed API documentation, please refer to <your-api-server-url>/swagger-ui/index.html

4. Print Result

By using json_format, you can format and display the results.

from gobtools.utils.json import json_format

print(json_format(releases))