Quick Start

This guide will get you up and running with AutoCore in minutes.

Basic Usage

AutoCore supports three import styles:

Style 1: Import everything (recommended)

Use functions directly without any prefix:

from autocore import *

click(driver, 'id', 'login-button')
write(driver, 'id', 'username', 'myuser')
press(driver, 'enter')

Style 2: Import as module

Use functions with autocore. prefix:

import autocore

autocore.click(driver, 'id', 'login-button')
autocore.write(driver, 'id', 'username', 'myuser')
autocore.press(driver, 'enter')

Style 3: Import specific functions

Use only what you need:

from autocore import browser, click, write, press

click(driver, 'id', 'login-button')
write(driver, 'id', 'username', 'myuser')
press(driver, 'enter')

Browser Automation

from autocore import *

# Open browser and navigate to a URL
dr = browser('https://example.com')

# Click a button
click(dr, 'id', 'login-button')

# Type in a field
write(dr, 'id', 'username', 'myuser')

# Press enter
press(dr, 'enter')

# Close browser
dr.quit()

Reading Screen Text

from autocore import *

# Read entire screen using OCR
text = read()

# Check if something is visible
if 'error' in text:
    say("Error detected on screen")

Downloading Files

from autocore import *

dr = browser('https://example.com')

# Click download button
click(dr, 'id', 'download-button')

# Wait for download to complete (300 seconds)
filename = wait_download(300)
print(f"Downloaded: {filename}")

dr.quit()

Logging

from autocore import *

# Setup logging — terminal turns green on success, red on crash
log_setup("my_script")

dr = browser('https://example.com')
click(dr, 'text', 'Submit')
dr.quit()

# All output is automatically saved to logs/ folder