Metadata-Version: 2.1
Name: robotframework-mongodb
Version: 0.2.0
Summary: MongoDB test library for Robot Framework.
Home-page: https://github.com/MobyNl/robotframework-mongodblibrary
License: MIT
Keywords: robotframework,mongodb,testing,library
Author: MobyNl
Author-email: markmoberts@gmail.com
Requires-Python: >=3.12,<3.14
Classifier: Framework :: Robot Framework
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Provides-Extra: aws
Requires-Dist: pymongo (>=4.13.2,<5.0.0)
Requires-Dist: pymongo-auth-aws (>=1.3.0,<2.0.0) ; extra == "aws"
Requires-Dist: robotframework (>=7.3.2,<8.0.0)
Requires-Dist: robotframework-assertion-engine (>=3.0.3,<4.0.0)
Requires-Dist: robotframework-pythonlibcore (>=4.4.1,<5.0.0)
Requires-Dist: robotframework-robocop (>=6.5.1,<7.0.0)
Requires-Dist: robotstatuschecker (>=4.1.1,<5.0.0)
Project-URL: Repository, https://github.com/MobyNl/robotframework-mongodblibrary
Description-Content-Type: text/markdown

# Robot Framework MongoDBLibrary

MongoDBLibrary is a test library for [Robot Framework](https://robotframework.org/) that provides keywords for interacting with MongoDB databases.

## Features
- Connect to MongoDB instances
- Perform CRUD operations
- Support for authentication and connection pooling
- Designed for use in Robot Framework test suites

## Installation

```bash
pip install robotframework-mongodb
```

Or with Poetry:

```bash
poetry add robotframework-mongodb
```

## Usage Example

```robotframework
*** Settings ***
Library    MongoDBLibrary

*** Test Cases ***
Connect To MongoDB
    Connect To Database    mongodb://localhost:27017    mydb
    # ... your test steps ...
```

## Using with AWS (DocumentDB/IAM Authentication)

To connect to AWS DocumentDB or use AWS IAM authentication, install the library with the `aws` extra:

```bash
pip install "robotframework-mongodb[aws]"
```

Or with Poetry:

```bash
poetry add robotframework-mongodb --extras aws
```

This will install the required dependency `pymongo-auth-aws`.

When connecting, use the appropriate MongoDB URI and ensure your environment is configured with AWS credentials (e.g., via environment variables, AWS CLI, or EC2 instance roles).

Example:

```robotframework
*** Settings ***
Library    MongoDBLibrary

*** Test Cases ***
Connect To AWS DocumentDB
    Connect To Database    mongodb://<cluster-endpoint>:27017    mydb
    # ... your test steps ...
```

## License
MIT

