Skip to content

A next-generation GUI automation framework for Web and Desktop Application Testing and Automation.

License

Notifications You must be signed in to change notification settings

clicknium/clicknium-docs

Repository files navigation

PyPI version GitHub issues PyPI - Python Version Twitter URL Slack Status Discord

Clicknium-docs

Clicknium is a next-generation GUI automation framework for various types of applications. It offers a simple and streamlined developer experience with high-level APIs for automating GUI applications and intelligent plug-ins. It gives you a fresh approach to creating your automation universe. Browser automation, web and desktop application testing, and site scraping bots are also supported.

Requirements

Main version
Python 3.7, 3.8, 3.9, 3.10, 3.11
OS Windows 11, 10 recommended, Windows 7 SP1 or above

Note: Windows 10 is the minimum supported Windows OS for DPI awareness.

Code Editor

  • Visual Studio Code

Getting Started

Get a sample script showing the automation of the web page and notepad.

Installation​

Set Up Clicknium Visual Studio Code Extension

  1. Install the Extension (or search Clicknium in Visual Studio Code Extension marketplace).
    VSCExtensions

  2. Click CLICKNIUM EXPLORER in Visual Studio Code Activity Bar

  3. Follow the welcome page:

    • Check the Python environment.
    • Install Clicknium Python module, as well as pip install clicknium
    • Select and install the browser extensions, at least including Edge. Enable the extension after the installation.
    • Sign in to start for free.

    welcomepage

To Reopen Welcome Page: open the Command Palette: Ctrl+Shift+P, input Clicknium:Welcome

To Enable Edge Extension: Open Edge browser, type edge://extensions/ into the address bar and enable Clicknium Recorder extension as below:

enable edge extension

Setup Sample Project

  • Click Clicknium: Sample on Welcome Page. Or invoke the Command Palette by pressing Ctrl+Shift+P and inputting Clicknium: Sample`.
  • Choose a path to locate the sample project.

The sample.py contains two automation samples, one is Edge web automation, and the other is notepad automation.

import subprocess
from time import sleep
from clicknium import clicknium as cc, locator, ui

def main():
    # sample code to demo web automation and desktop application
    tab = cc.edge.open("https://www.bing.com/")
    tab.find_element(
        locator.new_store.sample.bing.search_sb_form_q).set_text('clicknium')
    tab.find_element(locator.new_store.sample.bing.svg).click()
    sleep(3)
    tab.close()

    process = subprocess.Popen("notepad")
    ui(locator.new_store.sample.notepad.document_15).set_text("clicknium")
    sleep(3)

if __name__ == "__main__":
    main()

Run the Sample

In Visual Studio Code, open sample.py and press Ctrl+F5 to run the script. It will do:

  • Open a search engine page
  • Input a keyword and click the search button
  • Open a notepad
  • Input text to notepad

Next

Learn how to start an automation project from zero.

Contact

Welcome to create a Github Issue or join Clicknium Slack if you have any questions.