Skip to content

Commit

Permalink
Improved documentation.
Browse files Browse the repository at this point in the history
  • Loading branch information
cedricbonhomme committed Nov 5, 2024
1 parent 99fd55b commit 487ff14
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 5 deletions.
13 changes: 9 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,23 @@ A client to gather vulnerability-related information from the Fediverse.

### Installation

[pipx](https://github.com/pypa/pipx) is an easy way to install and run Python applications in isolated environments.
It's easy to [install](https://github.com/pypa/pipx?tab=readme-ov-file#on-linux).

```bash
$ pipx install FediVuln
$ export FEDIVULN_CONFIG=~/.FediVuln/conf.py
```

Set the configuration variables in ``conf.cfg`` as appropriate for your environment.
An [example is provided](fedivuln/conf.cfg-sample).
The configuration for FediVuln should be defined in a Python file (e.g., ``~/.FediVuln/conf.py``).
You must then set an environment variable (``FEDIVULN_CONFIG``) with the full path to this file.

You can have a look at [this example](https://github.com/CIRCL/FediVuln/blob/main/fedivuln/conf_sample.py) of configuration.


### Register your application

```bash
$ poetry shell
$ FediVuln-Register
```

Expand All @@ -37,7 +41,6 @@ You only have to execute it once.


```bash
$ poetry shell
$ FediVuln-Stream --user --sighting
```

Expand All @@ -48,6 +51,8 @@ Using the ``--sighting`` argument, detected vulnerability IDs will be recorded i

### Publishing

WIP.

```bash
$ python publish.py
```
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[tool.poetry]
name = "FediVuln"
version = "0.1.0"
version = "0.1.1"
description = "A client to gather vulnerability-related information from the Fediverse."
authors = ["Cédric Bonhomme <[email protected]>"]
license = "GPL-3.0-or-later"
Expand Down

0 comments on commit 487ff14

Please sign in to comment.