Metadata-Version: 2.4
Name: r7_surcom_sdk
Version: 0.16.19
Summary: Python SDK used to interact and develop with Rapid7 Surface Command
Author-email: Rapid7 <integrationalliance@rapid7.com>
License-Expression: MIT
Keywords: rapid7,Rapid7,r7_surcom_sdk,r7-surcom-sdk,SurfaceCommand,Surface,Command,sdk
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.11
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: jinja2~=3.1
Requires-Dist: PyYAML~=6.0
Requires-Dist: packaging~=25.0
Requires-Dist: argcomplete~=3.6
Requires-Dist: genson~=1.3
Requires-Dist: duckdb~=1.4
Requires-Dist: uv~=0.11.6
Requires-Dist: requests==2.33.0
Requires-Dist: urllib3==2.6.3
Provides-Extra: debug
Requires-Dist: debugpy~=1.8; extra == "debug"
Provides-Extra: developer
Requires-Dist: pytest; extra == "developer"
Requires-Dist: tox; extra == "developer"
Requires-Dist: pre-commit; extra == "developer"
Requires-Dist: pip-tools; extra == "developer"
Dynamic: license-file

# Surface Command SDK

The `surcom-sdk` helps you build data connectors for the Rapid7 Surface Command platform.

Source code for all connectors is available in our [GitHub repository](https://github.com/rapid7/r7-surcom-connectors).

## Getting Started

1. Install the SDK:

   ```bash
   pip install r7-surcom-sdk
   ```

2. [Configure the SDK](https://docs.rapid7.com/surface-command/build-custom-connectors/#install-and-configure-the-sdk) with your API key

3. [Build your first connector](https://docs.rapid7.com/surface-command/build-custom-connectors/#build-an-example-connector) by following our tutorial

4. [Contribute](https://github.com/rapid7/r7-surcom-connectors?tab=contributing-ov-file) to our open source connectors or share your own connector with the community! 

## Documentation

- [Troubleshoot connector issues](https://docs.rapid7.com/surface-command/build-custom-connectors/#troubleshoot-your-connector)
- [Understand the Attack Surface Management type system](https://docs.rapid7.com/surface-command/asm-type-system)
