update README.md to current state

* add term `supported` to install-python step (give versions)
* add config-creation to usage
* update run-command
* update test-command
* remove version from pip in test-requirement-installation-step
* update cmd-arg help-output
* move configuration-docs into section-sub-headers and tables
* update example to fit new names
This commit is contained in:
Thor77 2016-05-10 23:05:12 +02:00
parent cbb44fcb85
commit 8f95645e14
1 changed files with 17 additions and 17 deletions

View File

@ -2,21 +2,21 @@
A simple Teamspeak stat-generator - based on server-logs A simple Teamspeak stat-generator - based on server-logs
# Installation # Installation
- Install [Python](https://python.org) - Install a supported [Python](https://python.org)-version (`2.7`, `3.x`)
- Clone this repo `git clone https://github.com/Thor77/TeamspeakStats` - Clone this repo `git clone https://github.com/Thor77/TeamspeakStats`
- Install requirements `pip3 install -r requirements.txt` - Install requirements `pip3 install -r requirements.txt`
# Usage # Usage
Run `tsstats.py` and point your web-server to the generated .html-file, now you will see some stats for your Teamspeak-Server parsed from the logs. - Create a config (see [Configuration](https://github.com/Thor77/TeamspeakStats#configuration))
- Run the module `python -m tsstats`
# Tests # Tests
- Install testing-requirements `pip3 install -r testing_requirements.txt` - Install testing-requirements `pip install -r testing_requirements.txt`
- Run `nosetests` - Run `py.test tsstats/`
# CMD-Arguments # CMD-Arguments
``` ```
usage: tsstats.py [-h] [--config CONFIG] [--idmap IDMAP] [--debug] usage: python -m tsstats [-h] [--config CONFIG] [--idmap IDMAP] [--debug]
[--debugfile]
A simple Teamspeak stats-generator - based on server-logs A simple Teamspeak stats-generator - based on server-logs
@ -25,27 +25,27 @@ optional arguments:
--config CONFIG path to config --config CONFIG path to config
--idmap IDMAP path to id_map --idmap IDMAP path to id_map
--debug debug mode --debug debug mode
--debugfile write debug-log to file
``` ```
# Configuration # Configuration
###Configname #### [General]
`config.ini` | Key | Description |
#### Keys |-----|-------------|
`[General]` | log | Path to TS3Server-logfile(s) (supports [globbing](https://docs.python.org/3/library/glob.html)) |
- logpath `Path to TS3Server-logfile` (supports [globbing](https://docs.python.org/3/library/glob.html)) | output | Path to the location, where the generator will put the generated `.html`-file |
- outputfile `Path to the location, where the generator will put the generated .html-file`
`[HTML]` #### [HTML]
- title `HTML-Title` | Key | Description |
|-----|-------------|
| title | HTML-Title of the generated `.html`-file
## Example ## Example
``` ```
[General] [General]
logfile = /usr/local/bin/teamspeak-server/logs/ts3server*_1.log log = /usr/local/bin/teamspeak-server/logs/ts3server*_1.log
outputfile = /var/www/html/stats.html output = /var/www/html/stats.html
``` ```
# ID-Mapping # ID-Mapping