Installation

pip install i8t

Usage

i8t can be used in a few ways:

1. Instrument all inbound web requests (currently only Flask is supported):

   import flask
   import requests
   from i8t.instrument.flask_introspect import FlaskIntrospect
   
   app = flask.Flask(__name__)
   
   app.route("/test", methods=["POST"])
   def test_route():
       return "Test Response", 200
   
   introspect_client = IntrospectClient(
       session=requests.Session(),
       api_url="https://api.demin.dev/i8t/checkpoints/unique-tenant-id",
       name="app",
   )
   flask_introspect = FlaskIntrospect(introspect_client)
   flask_introspect.register(app)

2. Instrument all outbound HTTP requests (currently only requests is supported):

   import requests
   from i8t.instrument.requests_introspect import RequestsIntrospect
   
   introspect_client = IntrospectClient(
       session=requests.Session(),
       api_url="https://api.demin.dev/i8t/checkpoints/unique-tenant-id",
       name="app",
   )
   requests_introspect = RequestsIntrospect(introspect_client)
   requests_introspect.register()

3. Decorate any function to send its inputs and outputs:

   from i8t.client import IntrospectClient, IntrospectDecorator, introspect
   
   @introspect
   def test_func(first, second):
       return first + second
   
   introspect_client = IntrospectClient(
       session=requests.Session(),
       api_url="https://api.demin.dev/i8t/checkpoints/unique-tenant-id",
       name="app",
   )
   decorator = IntrospectDecorator(introspect_client)
   decorator.register()

Once initialized, the inputs and outputs of the instrumented calls are sent to the i8t server, where they can be later fetched at the same URL.

The fetched call checkpoints can be used to set up canned tests.