Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/okfde/froide
Freedom Of Information Portal
https://github.com/okfde/froide
fragdenstaat
Last synced: 3 months ago
JSON representation
Freedom Of Information Portal
- Host: GitHub
- URL: https://github.com/okfde/froide
- Owner: okfde
- License: mit
- Created: 2011-05-04T12:20:51.000Z (about 13 years ago)
- Default Branch: main
- Last Pushed: 2024-03-28T15:57:54.000Z (3 months ago)
- Last Synced: 2024-03-28T17:05:30.524Z (3 months ago)
- Topics: fragdenstaat
- Language: Python
- Homepage:
- Size: 29.3 MB
- Stars: 340
- Watchers: 33
- Forks: 85
- Open Issues: 108
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Security: SECURITY.md
Lists
- my-awesome-stars - okfde/froide - Freedom Of Information Portal (Python)
- awesome-stars - okfde/froide - Freedom Of Information Portal (Python)
- awesome-stars - froide
- awesome-starred - okfde/froide - Freedom Of Information Portal (others)
README
# Froide
[](https://github.com/okfde/froide/actions?query=workflow%3A%22Froide+CI%22)
Froide is a Freedom Of Information Portal using Django 3.2 on Python 3.8+.
It is used by the German and the Austrian FOI site, but it is fully
internationalized and written in English.
## Development on Froide
After clone, create a Python 3.8+ virtual environment and install dependencies:
```
python3 -m venv froide-env
source froide-env/bin/activate
# Install dev dependencies
pip install -r requirements-test.txt
# Install git pre-commit hook
pre-commit install
```
### Start services
You can run your own Postgres+PostGIS database and Elasticsearch service or run them with Docker.
You need [docker](https://www.docker.com/community-edition) and [docker-compose](https://docs.docker.com/compose/). Make sure Docker is running and use the following command:
```
docker-compose up
```
This will start Postgres and Elasticsearch and listen on port 5432 and 9200 respectively. You can adjust the port mapping in the `docker-compose.yml`.
### Setup database and search index, start server
If you need to adjust settings, you can copy the `froide/local_settings.py.example` to `froide/local_settings.py` and edit it. More steps:
```
# To initialise the database:
python manage.py migrate --skip-checks
# Create a superuser
python manage.py createsuperuser
# Create and populate search index
python manage.py search_index --create
python manage.py search_index --populate
# Run the Django development server
python manage.py runserver
```
### Run tests
Make sure the services are running.
```
# Run all tests
make test
# Run only unit/integration tests
make testci
# Run only end-to-end tests
make testui
```
### Development tooling
For Python code, we use flake8 following black code style. JavaScript, Vue and SCSS files are formatted and linted with ESLint and Prettier.
Make sure to have pre-commit hooks registered (`pre-commit install`). For VSCode, the [Python](https://code.visualstudio.com/docs/python/linting), [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) and [Vetur](https://marketplace.visualstudio.com/items?itemName=octref.vetur) extensions are helpful, with these workspace settings recommended:
```json
{
"eslint.format.enable": true,
"eslint.packageManager": "yarn",
"vetur.format.defaultFormatter.css": "prettier",
"vetur.format.defaultFormatter.html": "prettier",
"vetur.format.defaultFormatter.js": "prettier-eslint"
}
```
### Upgrade dependencies
```
# with pip-tools
pip-compile -U requirements.in
pip-compile -U requirements-test.in
```
## Docs
[Read the documentation](http://froide.readthedocs.org/en/latest/) including a [Getting Started Guide](http://froide.readthedocs.org/en/latest/gettingstarted/).
Froide is supported by the [Open Knowledge Foundation Germany](http://www.okfn.de/) and [Open Knowledge Foundation International](http://okfn.org/).
## License
Froide is licensed under the MIT License.