testjken66 / clicknium-docs

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

Clicknium-docs

Clicknium is a new 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
OS	Windows 7 SP1 or above

Code Editor

• Visual Studio Code

Getting Started

Get a sample script showing automation of 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).
   

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.

   

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 address bar and enable Clicknium Recorder extension as below:

Setup Sample Project

• Click Clicknium: Sample in Welcome Page. Or invoke the Command Palette by pressing Ctrl+Shift+P and input Clicknium: Sample.
• Choose a path to locate 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 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 question.