You may of course run this as any django application. However we've included some docker based tools and a demo project to make things easier.
Running development environment with Docker ComposeThis will get you a quick way to run report builder in a demo project - ideal for hacking on.
docker-compose build
docker-compose run --rm web python manage.py migrate
.docker-compose run --rm web ./manage.py createsuperuser
- use any credentials you likedocker-compose up
- the django-admin for the sample back end should now be available at localhost:8000/admin.localhost:8000/admin
- necessary to use the report builder frontend!cd js; yarn install
yarn start
- once this finishes building the frontend should be available on localhost:4200Pull requests should include a unit test on any added behavior. If it fixes a bug, it needs a failing test to show what it fixed. Documentation should also be updated, if needed.
To test changes to the report-builder backend run docker-compose run --rm web python manage.py test
.
Then to make sure your codes conforms to pep8:
docker-compose run --rm web flake8
To run tests with multiple Django versions run docker-compose run --rm web tox
Please check django versions before submitting merge requests.
To run the angular tests simply cd into the js directory and run yarn test
.
Python code should follow pep8 standards. JS code uses prettier for code formatting - we suggest installing a plugin to integrate it with your favorite editor.
Making pull requestsAfter you have a pull request that passes on Travis, and you have added any needed test cases, please squash your commits. If it makes more sense to break it up into smaller commits, you can do that as well. Just try to think what would be most helpful, when someone looks back in the git history to see why this file was changed.
Thanks :)
FrontendThe frontend is a angular app. We use ngrx (redux) for state management and angular-cli for scaffolding and tests.
How to publish./build_js.sh
will compile the webpack bundle and move it to the django static folderpython3 setup.py sdist bdist_wheel upload
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