sakuli

Proudly we can announce our v1.0 release!

Through hard working days (and nights) from @ConSol/sakuli developer and our valued supporters we now able to announce the v1.0 release! Thanks for your contribution and fantastic feedback! Really looking forward what happens next. If you have some proposal for new features or found some bugs, don`t hesitate to submit a GitHub Issue. Thank's for that in advance!

Your Sakuli developer team :-)

Latest changelog:

• First step tutorial and https documentation. Fixes #161, fixes #53 partially.
• fix #32 highlight function on linux does not work (in underlying SikuliX library)
• close #102 add method dragAndDropTo to the Region object
• Changed order of properties.
• Improve example_xfce:
  • Replaced calculator screenshot by a small one.
  • add mouse move action to example_xfce
• close #139 remove PDF als download content type, to enable to use the browser PDF viewer
• close #139 add start chrome + firefox maximised (firefox have to hold the file localstore.rdf in his profile folder)
• close #168 add reboot hint if user install the package Windows environement changes
• update the installer translation to the recommend one from https://github.com/izpack/izpack/tree/master/izpack-core/src/main/resources/com/izforge/izpack/bin/langpacks/installer
• fix maven snapshot repository path of the labs.consol.de maven-repository

The changelog of earlier releases you will find at the changelog.md

Last version before 1.0, with a new fowarder icinga2 and new go-lang based binary starter:

• Move to a new binary starter for Windows and Linux (sakuli.exe / sakuli), #150:

  • Change syntax from the new starter to:

  Usage: sakuli[.exe] COMMAND ARGUMENT [OPTIONS]
  
       sakuli -help
       sakuli -version
       sakuli run  [OPTIONS]
       sakuli encrypt  [OPTIONS]
  
  Commands:
       run     
       encrypt     
  
  Options:
       -loop             Loop this suite, wait n seconds between
                                  executions, 0 means no loops (default: 0)
       -javaHome          Java bin dir (overrides PATH)
       -javaOption   JVM option parameter, e.g. '-agentlib:...'
       -preHook      A program which will be executed before a
                                  suite run (can be added multiple times)
       -postHook     A program which will be executed after a
                                  suite run (can be added multiple times)
       -D         JVM option to set a property at runtime,
                                  overrides file based properties
       -browser          Browser for the test execution
                                  (default: Firefox)
       -interface      Network interface card name, used by
                                  command 'encrypt' as salt
       -sahiHome          Sahi installation folder
       -version                   Version info
       -help                      This help text
  

  • modify VNC dokumentation to flag -preHook and postHook
  • change documentation and docker scripts to new starter syntax sakuli run TEST_SUITE [OPTION]
  • add binaries sakuli and sakuli.exe from repo https://github.com/ConSol/sakuli-go-wrapper
  • remove sakuli.sh/sakuli.bat
• Add new forwarder module Icinga2, see #145:
  • Rest client to send the results to Icinga2 API
  • new property sakuli.forwarder.gearman.nagios.template.suite.summary.maxLength to cut to long output due to error messages
  • introduce sakuli.forwarder.icinga2 properties // consolidate sakuli.forwarder.database properties
• Separate examples for Window 7 and Windows 8
• close #118 improved output of nagios messages
• close #151 add a bunch of Windows registry settings to the installer, to improve the test stability. Disables graphical effects, screen saver and error reporting.
• fix #135 Environment similarity:
  • Extract constant Environment#DEFAULT_SIMILARITY to sakuli-default.properties as sakuli.environment.similarity.default:
  • Set default similarity to 0.99
• close #163: add clean up method, which release all modifier keys before a test case will startet and at the teardown phase
• fix #162: release keys didn't work correctly => update to sikulix version 1.1.998 and add function "run as admin" to dev suites
• add an Around Aspect to net.sf.sahi.util.Utils.getCommandTokens to fix parsing errors during calling native commands, see http://community.sahipro.com/forums/discussion/8552/sahi-os-5-0-and-chrome-user-data-dir-containing-spaces-not-working
• Documentation how to solve increasing sahi profile folders. Closes #164.
• reduce wait times for example test suites
• fix firefox_portable executable path in browser.xml: replace it with $userDir relativ path
• consolidate forwarder properties: adjust jdbc.* properties to sakuli.forwarder.database.* properties
• improve logging of database receiver
• fix #153 sakuli.log.maxAge error, is smaller then 1
• check_sakuli.php: added wrapper for function declarations to fix errors in PNP basket (cannot redefine...)
• cl: update installer with special cl installer preselected options
• close #155: add environment variables to --version output
• fix for #158: linux installer correct firefox var to MOZ_DISABLE_OOP_PLUGINS
• Added ff_purge_profile.bat to helper scripts (delete sqlite file before each run)
• close #155: add -version parameter to Sakuli starter (sakuli / sakuli.exe)
• close #153 log data rotation: * add a property sakuli.log.maxAge in days (default 14 days) * deletes all files that are older than the defined days in the folder sakuli.log.folder

Version 0.9.2

• add setting some firefox variables (MOZ_OOP_DISABLE_PLUGINS, MOZ_DISABLE_AUTO_SAFE_MODE, MOZ_DISABLE_SAFE_MODE_KEY) for UI testing to the installer, see #158.
• Executable JAR installer sakuli-vX.X.X-installer.jar, downloadable via , see #24.
  • The installer contains a complete Sakuli setup and the following options:
  • 1) will set/update the environment variable __SAKULI_HOME__ to this version.
  • 2) will set/update the environment to a recommend UI testing configuration. In examples disables the Firefox safe.
  • 3) will install one example test suite per OS which will help you to test and understand Sakuli.
  • 4) will install Firefox Portable, which can be used exclusively for Sakuli Tests.
  • 5) will install QRes, a open source screen mode changer (Windows only)
  • modify docker images to new headless linux installer
  • custom sahi browser_types.xml for firefox, firefox_portable, chrome
• Property sikuli.typeDelay now also set the RobotDesktop.stdAutoDelay to make the delay more effective, default is 0.0, #154.
• issue #149 add Application.kill() to force closeting an app without "save prompts"
• issue #94: disable highlighting in case of an exception
• docker container: modify test suite permissions after test run in sakuli_startup.sh
• Improve typing handling #154:
  • typing all special characters via unicode keyboard shortcuts
  • keyboard mapping only contains alphanumeric characters, so region.type now will work with all local keyboards, because of typing special characters via UFT-8
  • Mac's currently not supports directly typing UFT-8 keys, by default  see https://en.wikipedia.org/wiki/Unicode_input#In_Mac_OS . Unicode typing will only be used if correct keyboard is activated.
• improve takeScreenshot: now also can handle with absolute paths
• rename Region.takeScreenShot to Region.takeScreenshot
• fix #107: Fix Sikuli LinuxUtil Implementation of:
  • Focus application
  • Closing application
  • Make output and control of native commands more flexible
• include Sahi base installation to java DSL, #24
• modify properties, so that all default values are included
  • add check that testsuite.id will be defined at least
  • allow to write test without explicit image folder path, to enable java tests
• added docker-container sakuli-omd-labs-ubuntu for a Sakuli preconfigered OMD
• sakuli.bat: added exitcode, fixes bug #128 (Errors with paths containing spaces)
• fix #142: remove some not valid windows escape chars like ' or " to prevent a InvalidPathException in SakuliStarter arguments
• docker-containers.md: Added hint for boot2docker users.
• check_sakuli.php: fixed #132 (suite runtime)
• close #103: make docker-container able to override the running testsuite in docker run CMD arguments
  • make the sakuli.sh command line parameters usable in docker run CMD arguments, like for example docker run consol/sakuli-centos-xfce '--run $SAKULI_TEST_SUITE --browser chrome'
• Added documentation how to configure HTTPS in Sahi. #53
• Rename README.md to index.md in case of https://readthedocs.org/projects/sakuli/
• headless-linux.md: Added crontab documentation.