Here are the steps needed to set up a development and testing environment.
WARNING
This app use git flow for branching strategy and release management.
Please, change code and submit all pull requests into branch develop
Creating a development environmentThe development environment is created in a venv. The environment creation requires the make program to be installed.
To install make under Debian/Ubuntu:
$ sudo apt-get install build-essential
Under Mac OS/X, make is available as part of XCode.
At this point, from the root of this branch, run the command:
This command will create a .venv directory in the branch root, ignored by DVCSes, containing the development virtual environment with all the dependencies.
To install xvfb (for integration tests) under Debian/Ubuntu:
$ sudo apt-get install xvfb
If you are on CentOS and using yum, it’s:
$ yum install xorg-X11-server-Xvfb
Run the tests:
The command above also runs all tests except the available integration. They use Selenium and require Firefox to be installed. To include executing integration tests, define the environment variable USE_SELENIUM, e.g.:
$ make test USE_SELENIUM=1
Integration tests are excluded by default when using Python 3. The test suite requires Python >= 3.8.x.
Run the tests and lint/pep8 checks:
Again, to exclude integration tests:
$ make check USE_SELENIUM=1Debugging
Run the Django shell (Python interpreter):
Run the Django development server for manual testing:
After executing the command above, it is possible to navigate the testing project going to <http://localhost:8000>.
See all the available make targets, including info on how to create a Python 3 development environment:
Thanks for contributing, and have fun!
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4