# # Development

Before you get busy coding a new feature, create an issue and discuss the details in the issue tracker.

## # Environment set-up

This guide assumes you have a GitHub account, as well as Python 3 , virtualenv and Git installed. The guide is written for Bash, for Windows you can use for example Bash bundled with Git.

- Fork pywebview
- Clone your forked repository

    git clone https://github.com/<username>/pywebview
    cd pywebview

- Create a virtual environment

    virtualenv -p python3 venv
    source venv/bin/activate
    pip install -e .
    pip install pytest

- Hello world

    python examples/simple_browser.py

## # Development work-flow

- Create and checkout a new branch

    git checkout -b new-branch master

- Make your changes

- Run tests

    pytest tests

- Commit and push your work

    git add .
    git commit -m "Your commit message goes here"
    git push -u origin new-branch

- Create a pull request

## # Testing

pywebview uses pytest for testing.

To run all the tests in the project root directory

     pytest tests

To run a specific test

    pytest tests/test_simple_browser.py

Tests cover only trivial mistakes, syntax errors, exceptions and such. In other words there is no functional testing.

## # Learning

### # Windows

- Windows Forms documentation
- Windows Forms API

### # macOS

- pyobjc . pyobjc intro .
- AppKit
- WebKit

### # Linux

- PyGObject API reference

### # Qt

- Qt for Python Documentation
- Qt5 documentation
- PySide2 QtWidgets

Help us improve this page!