Browser Automation Library

A modular, Rust-based browser automation library leveraging the Fantoccini WebDriver client. This library provides an extensible framework for automating browser actions, interacting with web elements, and executing JavaScript.

Features

• Session Management: Start, navigate, and close browser sessions.
• Element Interaction: Click, type text, retrieve attributes, and manipulate DOM elements.
• Utility Functions:
  • Retry logic with exponential backoff.
  • Random delays to simulate human-like interaction.
  • Screenshot capturing.
  • JavaScript execution.
• Modular Design: Easily extend functionality by adding new modules.

Requirements

• Rust (Edition 2021 or later)
• Chromedriver (included in the repository for Windows)
• WebDriver server running locally (http://localhost:9515)

Installation

Add this library as a dependency in your Cargo.toml:

[dependencies]
browser_automation = "0.1.6"

Getting Started

Example: Automate Login on LinkedIn

use browser_automation::session::session::BrowserSession;

#[tokio::main]
async fn main() {
    let mut session = BrowserSession::new("https://www.linkedin.com/login").await.unwrap();

    let username_field = session.find_element("input#username").await.unwrap();
    username_field.type_text("your_email@example.com").await.unwrap();

    let password_field = session.find_element("input#password").await.unwrap();
    password_field.type_text("your_password").await.unwrap();

    let sign_in_button = session.find_element("button.btn__primary--large").await.unwrap();
    sign_in_button.click().await.unwrap();

    session.close().await.unwrap();
}

Directory Structure

• src/lib.rs: Entry point, exposes modules.
• src/elements/: Functions to interact with DOM elements.
• src/session/: Browser session management.
• src/utils/: Utility functions for retries, delays, screenshots, etc.
• chromedriver-win64/: Pre-configured Chromedriver binary.

Dependencies

• Fantoccini for WebDriver-based browser control.
• Tokio for async programming.
• Serde for JSON serialization/deserialization.
• Rand for random delays.

Contributing

Contributions are welcome! Please create issues or submit pull requests to the GitHub repository.

License

This project is licensed under the MIT License.