Project for university Advanced Programming course.
Checkers (draughts) in russian variant - web application build on architecture containing:
- C++, boost.python - app's logic, game mechanics,
- Django (Python) - server controller,
- AngularJS + HTML5 - client controller and interface.
Authors: Adam Napieralski, Patrycja Cieplicka.
View in: [Polish](README.pl.md)
Packages and technologies used:
- g++
- scons
- boost (Boost.Python, Boost.Test)
- python3 / python2
- nodejs >=v10.15
- django >=v1.11
- angularjs >=v1.7
- chessboardjs v1.0.0
To install all of needed packages, use bash script:
./install.sh
Default version of python for which some packages are installed is 3.x, however, you can change it to python2 with e.g.:
./install.sh python=2.6
- Install Microsoft Visual Studio.
- Install preferred Python (e.g. Python3.6) in the default path (C:\Python36), add it to the PATH.
- Install pip / pip3 - download get-pip.py then run
python get-pip.py. pip install --egg sconspip install -r pip_requirements.txt- Download and install boost in C:\Boost.
- Install nodejs.
- In
client/install js node modules withnpm install.
To build and compile application, use:
scons
The default python version is 3.6. To build with one of other supported versions [2.6, 2.7, 3.6, 3.7, 3.8], set argument:
scons python=2.7
After once defined, it will be stored and used in further scons run, so there will be no need to define it again.
To run unit tests (together with building), use:
scons --test
To run django server on predefined address (127.0.0.1:8000), use:
scons --run
or manually run: python ./build_web/manage.py runserver [ip]:[port] or python3 ./build_web/manage.py runserver [ip]:[port]
Open your browser and go to defined address, like: http://127.0.0.1:8000/. You will be redirected to /entry page of the game, where you can type your nickname and select your color of pieces. After submitting it with button click, you go to /play page with the game itself.