brahmastra 0.1.0

Certainly! Here is the complete README.md markup with the enhanced description and additional usage examples:

# Brahmastra

The Brahmastra is an undetected WebDriver, inspired by the legendary weapon of unparalleled power and destruction. Just like its mythical namesake, this tool is designed to be a formidable asset in your automation arsenal. It allows you to navigate any website or webpage effortlessly and invisibly, bypassing anti-bot measures with ease. With Brahmastra, automating your web tasks becomes seamless and worry-free, making it an indispensable tool for developers and automation enthusiasts alike.

## Why Brahmastra?

This package is a statement to all anti-bot measures: we acknowledge your existence, but we are unstoppable. Let's join hands to create the most powerful automation WebDriver, like the Brahmastra, and give back to the community.

## Installation

You can install Brahmastra using pip:

```bash
pip install brahmastra

Usage

Basic Usage

Here's an example of how to use Brahmastra to visit a webpage and print the page title:

from brahmastra import Brahmastra

# Initialize Brahmastra
browser = Brahmastra()
brahmastra = browser.initialize_brahmastra()

# Use Brahmastra to visit a webpage
browser.example_use("https://example.com")

# Quit Brahmastra
browser.quit_brahmastra()

Using Optional binary_path and user_data_dir Arguments

You can also specify the path to the browser binary and the user data directory if needed:

from brahmastra import Brahmastra

binary_path = "/path/to/chrome"
user_data_dir = "/path/to/user/data"

# Initialize Brahmastra with custom binary and user data directory
browser = Brahmastra(binary_path=binary_path, user_data_dir=user_data_dir)
brahmastra = browser.initialize_brahmastra()

# Use Brahmastra to visit a webpage
browser.example_use("https://example.com")

# Quit Brahmastra
browser.quit_brahmastra()

Features

• Undetected WebDriver: Bypass anti-bot measures effortlessly.
• Customizable: Specify custom browser binaries and user data directories.
• Random User Agents: Use random user agents to avoid detection.
• Easy to Use: Simple API to initialize, navigate, and quit the browser.

Contributing

We welcome contributions to make Brahmastra even more powerful. Feel free to fork the repository, make changes, and submit a pull request. Let's each other to create the most powerful automation WebDriver like Brahmastra and give it to the community.

License

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

This `README.md` file provides a comprehensive description of the Brahmastra package, including installation instructions, usage examples, features, a call for contributions, and licensing information.