🍃 mongoexport

Export data from MongoDB collections with advanced features like pagination, configurable delays, and automatic retry logic.

Features

• Paginated Export: Efficiently export large collections using configurable batch sizes
• Retry Logic: Automatic retry mechanism with configurable attempts and delays
• Configurable Delays: Add delays between batches to avoid server overload
• JSON Export: Export data to JSON format using BSON serialization
• CLI Tool: Easy-to-use command-line interface
• Robust Error Handling: Comprehensive logging and error management

Installation

From PyPI

pip install mongoexport

From Source

git clone https://github.com/otsobide/mongoexport.git
cd mongoexport
pip install -e .

Usage

Command Line

mongoexport \
  --uri mongodb://localhost:27017 \
  --db mydb \
  --collection mycollection \
  --batch-size 1000 \
  --delay 0.5 \
  --retries 3 \
  --retry-delay 2.0 \
  --output export.json

Option Reference

Python Module

from mongoexport import export_data
import argparse

# Create arguments namespace
args = argparse.Namespace(
    uri="mongodb://localhost:27017",
    db="mydb",
    collection="mycollection",
    batch_size=1000,
    delay=0.5,
    retries=3,
    retry_delay=2.0,
    output="export.json"
)

# Export data
export_data(args)

Requirements

• Python >= 3.8
• pymongo >= 3.12.0

Development

Setup Development Environment

git clone https://github.com/otsobide/mongoexport.git
cd mongoexport
pip install -e ".[dev]"

Running Tests

pytest

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Issues

If you encounter any issues, please report them on GitHub Issues.

Changelog

Version 0.1.4 (2026-08-24)

• Update project URLs to the otsobide GitHub account
• Fix the LICENSE link in this README
• Sync __version__ with the packaged version
• No functional changes to the export logic

Version 0.1.0 (2026-03-18)

• Initial release
• Basic export functionality with pagination
• Retry logic with configurable delays
• CLI interface