20210112

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,20 @@
+## Expected Behavior
+
+
+## Actual Behavior
+
+
+## Steps to Reproduce the Problem
+
+  1.
+  2.
+  3.
+
+## Short Example of Code to Demonstrate the Problem
+
+
+## Specifications
+
+  - Pywinauto version:
+  - Python version and bitness:
+  - Platform and OS:

.github/workflows/atspi_test.yml

@@ -0,0 +1,97 @@
+name: atspi CI
+on:
+  push:
+    branches: [ "atspi" ]
+  pull_request:
+    branches: [ "atspi" ]
+jobs:
+  Linux:
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        os : [ubuntu-18.04, ubuntu-20.04]
+        python: [ '2.7', '3.7', '3.8', '3.9', '3.10', '3.11' ]
+        exclude:
+          - os: ubuntu-20.04
+            python: '2.7'
+          - os: ubuntu-20.04
+            python: '3.7'
+          - os: ubuntu-20.04
+            python: '3.8'
+          - os: ubuntu-18.04
+            python: '3.9'
+          - os: ubuntu-18.04
+            python: '3.10'
+          - os: ubuntu-18.04
+            python: '3.11'
+    env:
+      DISPLAY: ':0'
+    steps:
+    - name: get repo
+      uses: actions/checkout@v1
+    - name: Set up Python
+      uses: actions/setup-python@v1
+      with:
+        python-version: ${{ matrix.python }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        sudo apt update -y
+        sudo apt upgrade
+        sudo apt install -y --no-install-recommends python-setuptools tk-dev python-tk
+        sudo apt install -y --no-install-recommends python3 python3-pip python3-setuptools
+        sudo apt install -y --no-install-recommends python-xlib
+        sudo apt install -y --no-install-recommends xsel
+        sudo apt install -y libjavascriptcoregtk-4.0-18
+        pip install coverage codecov
+        pip install python-xlib --upgrade
+        pip install mock --upgrade
+        python -m pip install pytest
+        sudo apt install -y build-essential libssl-dev
+        sudo apt install -y qt5-default
+        sudo apt install -y libxkbcommon-x11-0
+        sudo apt install -y python3-gi gobject-introspection gir1.2-gtk-3.0
+        sudo apt install -y at-spi2-core
+        sudo apt install -y python3-pyatspi
+        sudo apt install -y xvfb x11-utils libxkbcommon-x11-0 \
+            libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 \
+            libxcb-render-util0 libxcb-xinerama0 libxcb-xfixes0 xdotool
+        #pip3 install scikit-build # required for cmake>=3.23.0
+        pip3 install cmake==3.22.6
+
+    - name: Install test apps
+      run: |
+        git init apps
+        cd apps
+        git remote add -f origin https://github.com/pywinauto/PywinautoTestapps/
+        git config core.sparseCheckout true
+        echo "MouseTester/source" >> .git/info/sparse-checkout
+        echo "SendKeysTester/source" >> .git/info/sparse-checkout
+        git pull origin master
+        cd MouseTester/source
+        qmake
+        make
+        chmod a+x mousebuttons
+        cp mousebuttons ../
+        cd ../..
+        cd SendKeysTester/source
+        qmake
+        make
+        chmod a+x send_keys_test_app
+        cp send_keys_test_app ../
+        export XDG_RUNTIME_DIR=/tmp/runtime-runner
+    - name: Remote display start
+      run: |
+        sudo /usr/bin/Xvfb $DISPLAY -screen 0 1280x1024x24 &
+        sleep 5
+        set +eE
+        sudo apt install -y gdm3
+        sudo service gdm start
+        sleep 5
+    - name: Run tests
+      run: |
+        coverage run -m pytest pywinauto/unittests/test_atspi_element_info.py pywinauto/unittests/test_atspi_wrapper.py pywinauto/unittests/test_atspi_controls.py pywinauto/unittests/test_clipboard_linux.py pywinauto/unittests/test_keyboard.py pywinauto/unittests/test_application_linux.py
+    - name: Upload Coverage to Codecov
+      uses: codecov/codecov-action@v3

.github/workflows/codeql.yml

@@ -0,0 +1,41 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "atspi", "0_7_x", "macos", "master" ]
+  pull_request:
+    branches: [ "atspi" ]
+  schedule:
+    - cron: "30 14 * * 3"
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ python ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v2
+        with:
+          languages: ${{ matrix.language }}
+          queries: +security-and-quality
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v2
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v2
+        with:
+          category: "/language:${{ matrix.language }}"

.travis.yml

@@ -1,36 +1,37 @@
-sudo: required
-dist: trusty
+dist: xenial
 language: cpp
 notifications:
   email: false
-
+services:
+  xvfb
 
 language: python
 
 python:
-  #- "2.6"
   - "2.7"
-  - "3.3"
   - "3.4"
-  - "3.5"
   - "3.6"
+  - "3.7"
+  - "3.8"
 os:
   - linux
 before_install:
-  - sudo add-apt-repository -y ppa:beineri/opt-qt58-trusty
+  - sudo add-apt-repository -y ppa:beineri/opt-qt58-xenial
 
 install:
   - pip install python-xlib codecov coverage
+  # All this dependencies only to build tests application. No real dependency of this packages
   - sudo apt-get update
-  - sudo apt-get install -qq qt58base; 
+  - sudo apt-get -y install at-spi2-core
+  - sudo apt-get install -qq qt58base;
   - sudo apt-get -y install qt58declarative qt58tools
   - sudo apt-get install xsel
+  - sudo apt-get install libgtk-3-dev libgtk2.0-dev
+  - sudo apt-get install -y python3-gi
+  - sudo apt-get install --reinstall libgl1-mesa-dev
   - source /opt/qt58/bin/qt58-env.sh;
 
 before_script:
-  - "export DISPLAY=:99.0"
-  - "sh -e /etc/init.d/xvfb start"
-  - sleep 3 # give xvfb some time to start
   - xauth generate :99.0 . trusted
   # Clone test apps
   - git init apps
@@ -53,11 +54,16 @@ before_script:
   - chmod a+x send_keys_test_app
   - cp send_keys_test_app ../
   - cd $TRAVIS_BUILD_DIR
+  - chmod a+x $TRAVIS_BUILD_DIR/apps/Gtk_samples/gtk_example.py
 
 script:
   - coverage run -a --include=pywinauto/mouse.py pywinauto/unittests/test_mouse.py
   - coverage run -a --include=pywinauto/linux/keyboard.py pywinauto/unittests/test_keyboard.py
   - coverage run -a --include=pywinauto/linux/clipboard.py pywinauto/unittests/test_clipboard_linux.py
+  - coverage run -a --include=pywinauto/linux/application.py pywinauto/unittests/test_application_linux.py
+  - coverage run -a --source=pywinauto/linux,pywinauto/controls pywinauto/unittests/test_atspi_element_info.py
+  - coverage run -a --source=pywinauto/linux,pywinauto/controls pywinauto/unittests/test_atspi_wrapper.py
+  - coverage run -a --source=pywinauto/linux,pywinauto/controls pywinauto/unittests/test_atspi_controls.py
 
 after_success:
-  - codecov
+  - codecov

README.md

@@ -77,7 +77,7 @@ Properties.wait_not('visible') # make sure the dialog is closed
 
 ### Dependencies (if install manually)
 * Windows:
-  - [pyWin32](https://sourceforge.net/projects/pywin32/files/pywin32/)
+  - [pyWin32](https://github.com/mhammond/pywin32/)
   - [comtypes](https://github.com/enthought/comtypes)
   - [six](https://pypi.python.org/pypi/six)
 * Linux:

Readme.txt

@@ -1,6 +1,6 @@
 pywinauto
-(c) Mark Mc Mahon 2006-2015
-Released under the LGPL v2.1 or later
+(c) Mark Mc Mahon 2006-2010, Intel Corporation 2015-2016, Open Source community 2016-2019
+Released under BSD 3-clause license
 
 
 What is it
@@ -14,14 +14,15 @@ Manual Installation
 ------------
 Install the following Python packages
 (Required) pyWin32      http://sourceforge.net/projects/pywin32/files/pywin32/
+(Required) comtypes     https://github.com/enthought/comtypes
 (Optional) PIL          http://www.pythonware.com/products/pil/index.htm
 Unzip the pywinauto zip file to a folder.
 Run "python setup.py install"
 
 To check you have it installed correctly
 run in Python REPL:
->>> from pywinauto.application import Application
->>> app = Application.start("notepad.exe")
+>>> from pywinauto import Application
+>>> app = Application(backend="uia").start("notepad.exe")
 >>> app.UntitledNotepad.type_keys("%FX")
 
 Installation in silent mode (Python 2.7, 3.3+)
@@ -37,7 +38,7 @@ It explains the core concept, how to choose appropriate backend, spy tools and m
 We also have several examples installed along with the pywinauto demonstrating the work with
 Notepad, MSPaint, WireShark, explorer.exe and etc.
 https://github.com/pywinauto/pywinauto/tree/master/examples
-Notice though these examples designed to work only on a system with English localization.
+All the examples designed to work only on a system with English as OS interface language.
 
 
 How does it work
@@ -82,25 +83,20 @@ wait for the transition to a new state like so ::
 
 
 Several similar tools for comparison
----------------------------------
-* Python tools
-
-  - PyAutoGui
-  - AXUI
-  - winGuiAuto
-
-* Other scripting language tools
-
-  - Perl Win32::GuiTest
-  - Ruby Win32-Autogui
+------------------------------------
+See rating of competitors in the open source field (updated every month):
+https://github.com/pywinauto/pywinauto/wiki/UI-Automation-tools-ratings
 
 * Other free tools
 
-  - AutoIt
   - See a collection at: https://github.com/atinfo/awesome-test-automation
 
 * Commercial tools
 
+  - TestComplete
+  - Squish
+  - HP UFT (former QTP)
+  - LeanFT
   - WinRunner
   - SilkTest
   - Many Others