aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/docs/track_status.md
blob: 8fe07469b4612a764c29d70660029d6a19336c19 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
track_status.py
===============

Track when people go online/offline.

Usage
-----

Run from the top-level directory using `python -m`:

    > python -m bin.track_status -h
    usage: track_status.py [-h] [-t SECONDS] [-l PATH] [-f {csv,log,null}]
                           [-o PATH]
                           UID [UID ...]
    ...

For example (using made up user IDs/"screen names"),

    > python -m bin.track_status john.doe jane.smith
    [2016-06-18 01:43:34] John Doe is ONLINE.
    [2016-06-18 01:43:34] John Doe was last seen at 2016-06-18 01:33:58+03:00 using the official iPhone app.
    [2016-06-18 01:43:34] Jane Smith is OFFLINE.
    [2016-06-18 01:43:34] Jane Smith was last seen at 2016-06-18 01:15:47+03:00 using the web version (or an unrecognized app).
    [2016-06-18 01:59:09] Jane Smith went ONLINE.
    [2016-06-18 01:59:09] Jane Smith was last seen at 2016-06-18 01:59:07+03:00 using the official Android app.
    [2016-06-18 02:10:00] John Doe went OFFLINE.
    [2016-06-18 02:10:00] John Doe was last seen at 2016-06-18 01:54:58+03:00 using the official iPhone app.
    ...

By default, the script produces a human-readable log.
Use the `--log` parameter to write the log to a file.
If you want to record when people go online/offline for further analysis using
[online_sessions.py], specify the path to a database using the `--output`
parameter.
Be careful: if the file already exists, it will be overwritten!

[online_sessions.py]: online_sessions.md

See also
--------

* [License]

[License]: ../README.md#license