AutoCore

Automate Core Actions

A Python library that combines GUI automation, headless browser control and common actions into a single library.

With a single import, we get everything we need to automate repetitive tasks on Windows and Linux, no juggling multiple libraries or complex setup.

Security & Privacy

AutoCore runs entirely on your local machine. No data is sent to any external server at any point.

This makes it suitable for:

• On-premise deployments with strict data security policies.
• Automation involving sensitive or confidential data.
• Compliance-sensitive industries like finance, healthcare and legal.

Platform Support

• Supported: Windows, Linux
• Not Supported: macOS

Installation

This has been fully tested on Python 3.12, using other versions may lead to compatibility issues with dependencies.

pip install autocore

Linux Dependencies

After installing, run the following based on your distro:

# Ubuntu/Debian
sudo apt-get install wmctrl xdotool python3-tk xclip xdg-utils espeak-ng alsa-utils

# RHEL/CentOS/Fedora
sudo yum install wmctrl xdotool python3-tkinter xclip xdg-utils espeak-ng alsa-utils

Chrome Installation

AutoCore uses Chrome for browser automation. Install it before using browser().

Windows:

winget install Google.Chrome

Linux (Ubuntu/Debian/Mint):

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt-get install -f -y

Linux (RHEL/CentOS/Fedora):

wget https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm
sudo rpm -i google-chrome-stable_current_x86_64.rpm

Usage

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')

Functions

File Formats Supported by read()

Quick Example

from autocore import *
log_setup("demo")

# Open login page in visible browser
dr = browser('https://practice.expandtesting.com/login')

# Open login page in headless browser
# dr = browser('https://practice.expandtesting.com/login', True)

# Scroll to the login form
find_browser(dr, 'secure area')
scroll(dr, 1)

# Login with test credentials
write(dr, 'id', 'username', 'practice')
write(dr, 'id', 'password', 'SuperSecretPassword!')
wait(2)
click(dr, 'id', 'submit-login')
wait(3)
# doing logout
click(dr, 'text', 'Logout')
wait(2)
print("Logout done.")
# showing blank page before moving to next website
dr.get("about:blank")
#====================================================
# Navigate to secure file download page
dr.get('https://practice.expandtesting.com/download')

# Scroll to bottom to make the link visible
scroll(dr, 'bottom')

# Click to download the test file
click(dr, 'text', 'some-file.json')

# Wait for download to finish with timeout of 2 mins
file_location = wait_download(120)

# Announce completion time with voice
say(f"File downloaded at {hour()} hours and {minute()} minutes")

# Closing the browser
dr.quit()
print("Content of downloaded file is : ", read(file_location))
print('bye bye')