Metadata-Version: 2.1
Name: atuin-graph
Version: 1.0.1
Summary: activity graph for atuin
Project-URL: Homepage, https://github.com/tieum/atuin-graph
Project-URL: Bug Tracker, https://github.com/tieum/atuin-graph/issues
Author-email: matthieu@bluegreen.sh
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: blinker~=1.6.2
Requires-Dist: calplot~=0.1.7.5
Requires-Dist: click~=8.1.3
Requires-Dist: contourpy~=1.0.7
Requires-Dist: cycler~=0.11.0
Requires-Dist: flask~=2.3.2
Requires-Dist: fonttools~=4.39.3
Requires-Dist: greenlet~=2.0.2
Requires-Dist: itsdangerous~=2.1.2
Requires-Dist: jinja2~=3.1.2
Requires-Dist: kiwisolver~=1.4.4
Requires-Dist: markupsafe~=2.1.2
Requires-Dist: matplotlib~=3.7.1
Requires-Dist: numpy~=1.24.3
Requires-Dist: packaging~=23.1
Requires-Dist: pandas~=2.0.1
Requires-Dist: pillow~=9.5.0
Requires-Dist: psycopg2-binary~=2.9.6
Requires-Dist: pyparsing~=3.0.9
Requires-Dist: python-dateutil~=2.8.2
Requires-Dist: pytz~=2023.3
Requires-Dist: six~=1.16.0
Requires-Dist: sqlalchemy~=2.0.12
Requires-Dist: typing-extensions~=4.5.0
Requires-Dist: tzdata~=2023.3
Requires-Dist: werkzeug~=2.3.4
Description-Content-Type: text/markdown

# atuin-graph
activity graph for [atuin](https://atuin.sh) self hosted sync server

<img src="https://github.com/tieum/atuin-graph/raw/main/img/shell.history.gif">

It connects to the PostgreSQL atuin database, using by default the `db_uri` setting from atuin `server.toml` config file

Two ways to run it are available, whether in command line or as a flask web application

Required Python version: >= 3.11 (uses the [tomllib parser](https://docs.python.org/3/library/tomllib.html))

## installation

```bash
pip install atuin-graph
```

## cli / standalone
***- `atuin-graph`***: takes a username as input and creates a `user.png` file

The `-until` parameters allows to query up to a max date, this is useful to create one png per day and create a gif with `imagemagick` for example (`convert -delay 10 -loop 1 *.png atuin.gif`)

```bash
usage: atuin-graph [-h] --user USER [--until UNTIL]

                      [--atuin_server_config ATUIN_SERVER_CONFIG]
```
##  web app
This package also ships a `Flask`app which dynamically serves a png for a given user and optional date
```bash
https://my-atuin-server/graph/username[/yyyy-mm-dd]
```

one way to run it:

```bash
GUNICORN_CMD_ARGS="--bind=127.0.0.1:8889" SCRIPT_NAME=/graph gunicorn atuin_graph.web:app
```

and on nginx side

	location /graph {
	
                proxy_bind              $server_addr;
                proxy_pass              http://127.0.0.1:8889;
        }


