Skip to content

v4.0.0

Choose a tag to compare

View all tags
@vulnersCom vulnersCom released this 24 Jul 15:52
· 15 commits to master since this release
v4.0.0
3194e38

The first release of the modernized v4 SDK — a ground-up rewrite that keeps 100% backward compatibility with the v3 API.

Install

pip install -U vulners

Requires Python 3.10+.

Added

  • New sync and async clients, Vulners and AsyncVulners, with resource
    namespaces (search, documents, audit, archive, misc, report, stix,
    subscriptions, subscriptions_email, webhooks, vscanner), importable as
    from vulners import Vulners, AsyncVulners.
  • Typed response models (bulletin family hierarchy), SearchPage pagination
    with auto-iteration bounded by the 10 000-document search window, and lazy
    streaming of the gzip/zip-compressed JSON-array archive downloads.
  • A structured exception hierarchy (VulnersError → APIError → …) and
    with_raw_response / with_streaming_response accessors.
  • audit.smart() — the Smart Audit endpoint (POST /api/v4/audit/smart).
  • Subscription and webhook methods accept an optional api_key argument naming
    the owner of the subscription, defaulting to the client's own key so existing
    calls stay byte-identical on the wire.
  • HTTP/2 on by default (h2 is a core dependency); a new http2 argument
    lets you force HTTP/1.1 for huge single-stream archive downloads.
  • Faster, more modern transport by default, no build step — response
    compression (brotli + zstandard), ISA-L-accelerated gzip (isal),
    multi-member gzip/zip streaming (stream-unzip), all core with prebuilt wheels
    for CPython 3.10–3.14. The http2 / stream-zip extras are removed (now core);
    mcp and otel remain.
  • Proxy configuration via the proxy= argument (a URL or httpx.Proxy), plus
    automatic support for the HTTPS_PROXY / HTTP_PROXY / ALL_PROXY environment
    variables (honouring NO_PROXY) when trust_env is set.
  • A built-in Model Context Protocol server
    (vulners-mcp, vulners[mcp] extra) exposing search/lookup/audit tools to AI agents.
  • License change to MIT for 4.0.0.

Compatibility

  • The entire v3 API (VulnersApi, VScannerApi, vulners.base.*,
    vulners.vulners.*, all import paths) is preserved unchanged. Existing code
    keeps working; new code should prefer the v4 clients.

Docs: https://vulnersCom.github.io/api/ · PyPI: https://pypi.org/project/vulners/4.0.0/ · Full changelog: CHANGELOG.md

Assets 2
Loading