Skip to content

Commit

Permalink
docs: Lint README.md & CONTRIBUTING.md (Exodus-Privacy#119)
Browse files Browse the repository at this point in the history
  • Loading branch information
pnu-s authored May 9, 2021
1 parent 7cb62f8 commit 365b6ad
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 16 deletions.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ You need to make sure your changes do not break the existing tests.

You can execute the tests with the following command:

```
```sh
source venv/bin/activate
cd etip
python manage.py test --settings=etip.settings.dev
Expand Down
41 changes: 26 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
# ETIP - εxodus tracker investigation platform

[![Build Status](https://travis-ci.org/Exodus-Privacy/etip.svg?branch=master)](https://travis-ci.org/Exodus-Privacy/etip) [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/Exodus-Privacy/etip.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Exodus-Privacy/etip/context:python)

ETIP is meant to ease investigations on tracker detection. For the moment, it offers few features:

* track all modifications on trackers
* detect rules collisions for both network and code signature

Expand All @@ -10,8 +12,9 @@ ETIP is meant to ease investigations on tracker detection. For the moment, it of
If you wish to help us identify new trackers, you can **request an ETIP account** by sending a username and an email address to [email protected]

You can also take a look at to the following repositories:
- https://github.com/YalePrivacyLab/tracker-profiles
- https://github.com/jawz101/potentialTrackers

* <https://github.com/YalePrivacyLab/tracker-profiles>
* <https://github.com/jawz101/potentialTrackers>

## Contributing to ETIP development

Expand All @@ -23,25 +26,27 @@ An API is available to help administrate the ETIP database.

### Authenticate

```
```sh
POST /api/get-auth-token/
```

Example:
```

```sh
curl -X POST http://localhost:8000/api/get-auth-token/ --data "username=admin&password=testtest"
```

You need to include your token as an `Authorization` header in all subsequent requests.

### Get trackers

```
```sh
GET /api/trackers/
```

Example:
```

```sh
curl -X GET http://localhost:8000/api/trackers/ -H 'Authorization: Token <your-token>'
```

Expand All @@ -50,24 +55,28 @@ curl -X GET http://localhost:8000/api/trackers/ -H 'Authorization: Token <your-t
### Installation

Clone the project
```

```sh
git clone https://github.com/Exodus-Privacy/etip.git
```

Create the Python virtual env
```

```sh
cd etip
virtualenv venv -p python3
source venv/bin/activate
```

Install dependencies
```

```sh
pip install -r requirements.txt
```

Create the database
```

```sh
export DJANGO_SETTINGS_MODULE=etip.settings.dev
cd etip/
python manage.py migrate
Expand All @@ -80,20 +89,21 @@ python manage.py import_categories
```

Create admin user
```

```sh
python manage.py createsuperuser
```

### Run the tests

```
```sh
export DJANGO_SETTINGS_MODULE=etip.settings.dev
python manage.py test
```

### Start the server

```
```sh
export DJANGO_SETTINGS_MODULE=etip.settings.dev
python manage.py runserver
```
Expand All @@ -105,10 +115,11 @@ Some admin commands are available to help administrate the ETIP database.
#### Compare with Exodus

This command retrieves trackers data from an εxodus instance and looks for differences with trackers in the local database.
```

```sh
python manage.py compare_with_exodus
```

Note: for now, it only compares with local trackers having the flag `is_in_exodus`.

The default εxodus instance queried is the public one available at https://reports.exodus-privacy.eu.org (see `--exodus-hostname` parameter).
The default εxodus instance queried is the public one available at <https://reports.exodus-privacy.eu.org> (see `--exodus-hostname` parameter).

0 comments on commit 365b6ad

Please sign in to comment.