securitydev 1.0.0

security.dev Python SDK

security.dev Python Client (securitydev)

A modern Python client for the security.dev API, built using httpx and pydantic. Supports both synchronous (default) and asynchronous usage.

Features

• Synchronous (SecurityClient) and Asynchronous (AsyncSecurityClient) interfaces.
• API endpoints grouped under namespaces (e.g., client.ip_intel).
• Modern implementation using httpx.
• Data validation using pydantic with safe nested attribute access.
• Simple and intuitive interface.
• Type-hinted for a better developer experience.
• Clean error handling for API responses.

Installation

Install using pip (or any other manager):

pip install securitydev

Requirements

• Python 3.8+
• A security.dev API key, available from security.dev.

Quick Examples

Synchronous Usage

import os
from securitydev import SecurityClient

key = os.getenv("SECURITYDEV_KEY")

with SecurityClient(key=key) as client:
    reputation = client.ip_intel.reputation("8.8.8.8")
    print(f"8.8.8.8 - Is Abuser: {reputation.is_abuser}")

You don't necessarily need to use the context manager.

import os
from securitydev import SecurityClient

key = os.getenv("SECURITYDEV_KEY")

client = SecurityClient(key=key)
ip = "1.1.1.1"
rep = client.ip_intel.reputation(ip)
if rep.is_tor_exit:
    print(f"{ip} is a Tor exit.")

Asynchronous Usage

import os
import asyncio
from securitydev import AsyncSecurityClient

async def main():
    async with AsyncSecurityClient(key=os.getenv("SECURITYDEV_KEY")) as client:
        geoip = await client.ip_intel.geolocate("1.1.1.1")
        print(f"1.1.1.1 - Country: {geoip.country.name}")

asyncio.run(main())