mechanix 0.1.0a1

The official Python library for the mechanix API

Mechanix Python API

The Mechanix Python library provides convenient access to the Mechanix REST API from any Python 3.8+ application. The library includes type definitions for all request params and response fields, and offers both synchronous and asynchronous clients.

Documentation

• General Documentation
• REST API Reference
• Python SDK API

Installation

pip install --pre mechanix

Usage

from mechanix import Mechanix

client = Mechanix()

response = client.tools.search(
    query="Common organelles within a human eukaryote",
    x_api_key="x-api-key",
)
print(response.data)

Async usage

Simply import AsyncMechanix instead of Mechanix and use await with each API call:

import asyncio
from mechanix import AsyncMechanix

client = AsyncMechanix()


async def main() -> None:
    response = await client.tools.search(
        query="Common organelles within a human eukaryote",
        x_api_key="x-api-key",
    )
    print(response.data)


asyncio.run(main())

Functionality between the synchronous and asynchronous clients is otherwise identical.

Handling errors

When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of mechanix.APIConnectionError is raised.

When the API returns a non-success status code (that is, 4xx or 5xx response), a subclass of mechanix.APIStatusError is raised, containing status_code and response properties.

All errors inherit from mechanix.APIError.

import mechanix
from mechanix import Mechanix

client = Mechanix()

try:
    client.tools.search(
        query="Common organelles within a human eukaryote",
        x_api_key="x-api-key",
    )
except mechanix.APIConnectionError as e:
    print("The server could not be reached")
    print(e.__cause__)  # an underlying Exception, likely raised within httpx.
except mechanix.RateLimitError as e:
    print("A 429 status code was received; we should back off a bit.")
except mechanix.APIStatusError as e:
    print("Another non-200-range status code was received")
    print(e.status_code)
    print(e.response)

Error codes are as followed:

Status Code	Error Type
400	BadRequestError
401	AuthenticationError
403	PermissionDeniedError
404	NotFoundError
422	UnprocessableEntityError
429	RateLimitError
>=500	InternalServerError
N/A	APIConnectionError

Credits

This API library is generated with Stainless.