Skip to main content

No project description provided

Project description

robotframework-browser

All Contributors

Version Actions Status License


:construction_worker: :construction: Work in Progress :construction: :performing_arts:

Robot Framework Browser library powered by Playwright. Moving browser automation to year 2020 (or 2021)!

Aiming for :rocket: speed, :white_check_mark: reliability and :microscope: visibility.

Supporting testing and automation with Robot Framework and Python.

Official post about this venture.

See keyword documentation.

Installation instructions

  1. Install node.js e.g. from https://nodejs.org/en/download/
  2. Install robotframework-browser from the commandline: pip install robotframework-browser
  3. Install the node dependencies needed to run Playwright from the commandline: rfbrowser init

Development

Development environment

Install Python, nodejs and yarn. Make sure you have make available.

Setup development environment with make dev-env. This creates a Python virtualenv in .venv directory, and install both Python and nodejs dependencies.

To update the dependencies use either make dev-env to update all or alternatively make .venv or make node-deps to update only Python or nodejs dependencies, respectively.

Make sure to run source .venv/bin/activate to activate the correct virtualenv

Development in Windows

Install Chocolatey and then install development tools with choco install sed make.

After that, the development workflow should work as described in the previous chapter. The only difference is that the virtualenv needs to be activated by running .venv\Scripts\activate in the command prompt.

Testing

There are both unit tests written with pytest and acceptance test written with Robot Framework. These can be run manually with make utest and make atest. To rerun failed tests you can use make test-failed The tests are also executed in a prepush hook.

Running tests in docker container

Docker container builds a clean install package. This can be used to check that a builded package works correctly in a clean environment without development dependencies.

Note atest test app start in __init__.robot requires a small change as the path is /atest/demoapp/server.py and not atest/demoapp/server.py in this case.

  1. Build the container make docker
  2. Run tests mounted from host machine make docker-test.
  3. See results in atest/output

Releasing

  1. Ensure generated code and types are up to date with make build
  2. Ensure tests and linting pass on CI
  3. Check that you have permissions to release on Github and PyPi
  4. Use make release to create and release artifacts and upload to PyPi
  5. Create Github release

Code style

Python code style is enforced with flake8 and black. These are executed in a precommit hook, but can also be invoked manually with make lint-python.

JS / TS code style is enforced with eslint. Lints are run in precommit hooks, but can be run manually with make lint-node.

Architecture

Python Library <--> gRPC <---> TypeScript and Playwright

Contributors

This project is community driven and becomes a reality only through the work of all the people who contribute. Supported by Robocorp through Robot Framework Foundation.


Mikko Korpela

💻

Tatu Aalto

💻

Antti Karjalainen

🔍

Ismo Aro

🔍

Janne Härkönen

💻

Kerkko Pelttari

💻

Robocorp

💵

René

🤔 ⚠️

Bryan Oakley

🤔

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robotframework-browser-0.3.0.tar.gz (28.0 kB view details)

Uploaded Source

Built Distribution

robotframework_browser-0.3.0-py3-none-any.whl (37.5 kB view details)

Uploaded Python 3

File details

Details for the file robotframework-browser-0.3.0.tar.gz.

File metadata

  • Download URL: robotframework-browser-0.3.0.tar.gz
  • Upload date:
  • Size: 28.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3

File hashes

Hashes for robotframework-browser-0.3.0.tar.gz
Algorithm Hash digest
SHA256 83121c96dfe79af9f8229a21d7f16dc1ed3be4930e56d53c6f5a83ca99942a06
MD5 a48bb46d0a85e7bebea95b0535b04489
BLAKE2b-256 68d7b27aacba8f20647704ca30ee3008f773c7712fb7a8aae5d9ae1794cbc785

See more details on using hashes here.

Provenance

File details

Details for the file robotframework_browser-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: robotframework_browser-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 37.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3

File hashes

Hashes for robotframework_browser-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 07828dcc0084f921f23e7a31517dd8cb82d085f785ca90b88ecab7c321ae5662
MD5 ce17806abdb921f44657524bcb8b3566
BLAKE2b-256 64295d078de19ad497d6055ec9b30338cebef6da3e54439f8ebf6e3c71894555

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page