master | develop |
---|---|
This is the source code for the FA Forever Lobby.
Pre-requisites are:
-
Python 3.4+
-
PyQt5 >=5.8
-
Requirements as in the requirements file.
pip install -r requirements.txt
By contributing, you agree to license your work to the FAForever project in such a way that it can forever be distributed under the conditions of the GPL v3.0 license.
Downlord's FAF Client Contribution Guidelines
- Quality has highest priority
- Write readable code
- Use comments only when absolutely necessary to explain complex algorithms or inherently unintuitive reasons for how or why your code functions
- Use the logger
- Open an issue for every improvement or problem you want to work on
- Open a PR that references the issue, name of the feature branch for the PR should start with issue number
- Use reasonably structured commits in your PR, for example like this:
- Cosmetic changes necessary to prepare your work
- Infrastructure / low level changes necessary for your high-level feature/fix
- Implementation of your feature/fix
- Additional work, such as localizations
- Use "Closes #xxx" in commit messages
- Changelog messages of the form
* Fix the foo #issue (@myname #pr)
are appreciated when done in a final rebase after PR is marked "ready", but otherwise tend to cause annoying merge conflicts - PRs without test coverage for all logic will not be accepted
Small fixes by contributors who "own" (have recently made commits on) the part of the project they are making changes on may be fast-tracked, but when in doubt open at least a PR with a descriptive title and description.
https://github.com/FAForever/client/wiki/Windows-Dev-Py36
This guide is about runnning the client from source repository. For a ready-made Arch-Linux package follow the instructions in the wiki.
Clone this repository locally:
git clone https://github.com/FAForever/client.git faf-client
Create a python3(!) virtualenv for installing its dependencies:
virtualenv ./faf-client-venv --system-site-packages
./faf-client-venv/bin/pip install -r ./faf-client/requirements.txt
Note that many distributions have separate names for Python 2 and Python 3 virtualenv, such as "virtualenv" and "virtualenv3" - ensure you're using the Python 3 specific version on your distribution!
Now download the faf-uid
executable:
wget https://github.com/FAForever/uid/releases/download/v4.0.4/faf-uid -O ./faf-client/lib/faf-uid
chmod +x ./faf-client/lib/faf-uid
Note that the faf-uid
smurf protection executable needs to run xrandr
, lspci
, lsblk
and uname
to gather unique system information. Additionally the lsblk
command must support the "--json" flag, which was added in util-linux-2.27.
Run the client:
cd ./faf-client && PATH=$PATH:./lib ../faf-client-venv/bin/python src/__main__.py
For more information see the wiki.
Before running unit tests, set PYTEST_QT_API as follows:
export PYTEST_QT_API='pyqt5'
Run the lobby from the main directory using:
python3 src
Run the unit test suite using:
python3 runtests.py
GPLv3. See the license file.