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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
JFR Pary - dane licytacji
=========================
Narzędzie dodające do strony wyników z JFR Pary dane licytacji, zbierane w pliku
BWS "pierniczkami" nowego typu.
Przykładowe efekty działania:
[rozdania szkoleniowe z BOOM 2015](http://www.pzbs.pl/wyniki/boom/2015/boom_wirtualne_me.html),
[Kadra U-20 z butlerem ligowym](http://emkael.info/brydz/wyniki/2015/u20_szczyrk/ligowe.html).
Wymagania systemowe
-------------------
* system operacyjny MS Windows (testowane na Win7 i Win8.1)
* sterownik ODBC dla plików MS Access (zwykle obecny domyślnie z Windows,
weryfikowalny w Panelu Sterowania -> Narzędziach Administracyjnych ->
Żródła danych ODBC)
Instalacja
----------
Ściągnij paczkę z programem, dostępną [na stronie autora](//emkael.github.io/pary-bidding-data)
i rozpakuj ją do wybranego przez siebie katalogu roboczego programu.
Uwaga: paczki z sufiksem `-gui` zawierają wersję aplikacji z okienkowym
interfejsem graficznym.
W katalogu WWW Par skonfiguruj zasoby niezbędne do prezentacji danych
licytacji:
* skopiuj [`css/bidding.css`](res/css/bidding.css) do katalogu WWW (plik
dołączany jest automatycznie do stron z wynikami)
* skopiuj [`javas/bidding.js`](res/javas/bidding.js) do podkatalogu javas
katalogu WWW (plik dołączany jest automatycznie do stron z wynikami)
* skopiuj [`images/link.png`](res/images/link.png) do podkatalogu images
katalogu WWW
Wersja okienkowa potrafi również przesyłać w/w pliki Gońcem. Pliki nie są
kopiowane do katalogu Par, ale mogą zostać prze-FTP-owane na żądanie.
Już, gotowe.
Kompilacja i praca z kodem narzędzia
------------------------------------
Patrz: [`BUILD.md`](BUILD.md)
Użycie (wersja linii poleceń)
-----------------------------
Program składa się ze skompilowanego skryptu języka Python, dostępnego
w katalogu [`src`](src) tego repozytorium.
Skrypt [`bidding_data.py`](src/bidding_data.py) operuje na następujących
danych wejściowych:
* plikach HTML wygenerowanych po zakończeniu turnieju stron statycznych
* pliku BWS sesji
Program przyjmuje parametry w sposób następujący:
```
bidding_data.exe DANE_SESJI.bws PLIK_TURNIEJU.html
```
`DANE_SESJI.bws` to plik BWS z zebranymi danymi sesji.
`PLIK_TURNIEJU.html` to ściezka do pliku turnieju w katalogu WWW
([ŚCIEŻKA]\PREFIX.html).
Narzędzie obsługuje niestandardowe zakresy numeracji rozdań w turnieju.
Mapowanie numeru rozdań z Par na numer rozdania w BWS (numer fizycznego
pudełka) odbywa się automatycznie (na podstawie danych z BWS).
Opcjonalne argumenty linii poleceń
----------------------------------
```
bidding_data.py [-h] [-V] [-q | -v] [-l POZIOM_LOGÓW] [-f PLIK_LOGÓW]
[-s [ADRES_GOŃCA]]
DANE_SESJI.bws PLIK_TURNIEJU.html
```
Opis argumentów:
* `-h`, `--help`: wyświetla opis argumentów
* `-V`, `--version`: wyświetla numer wersji programu
* `-q`, `--quiet`: ucisza ostrzeżenia na standardowym wyjściu błędu
* `-v`, `--verbose`: wypisuje szczegółowe komunikaty na wyjściu błędu
* `-l LOGÓW`, `--log-level POZIOM`: ustawia szczegółowość logowania
(`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`)
* `-f PLIK`, `--log-file PLIK`: ścieżka pliku logów
* `-s [GONIEC]`, `--send-files [GONIEC]`: włącza transmisję Gońcem
(domyślny adres: `localhost:8090`)
* `-fs`, `--force-resend`: wymusza przesłanie wszystkich edytowanych plików,
nie tylko tych zmienionych
* `-sn`, `--section-number`: numer (nie litera!) sektora w BWS, do którego
ograniczamy czytanie danych
* `-mr`, `--max-round`: numer ostatniej rundy, z której czytamy dane
Użycie (wersja z interfejsem okienkowym)
----------------------------------------
Się klika, się wybiera i się robi.
Kompatybilność
--------------
Narzędzie łączy się przez ODBC do bazy MS Access, więc działa jedynie
pod Windowsem.
Wersja operująca na wyeksportowanych plikach CSV (np. przez `mdb-export`),
kompatybilna z pozostałymi systemami operacyjnymi i niewymagająca ODBC,
dostępna jest w gałęzi [csv](//github.com/emkael/jfrpary-bidding-data/tree/csv).
Do wersji z gałęzi CSV nie ma interfejsu graficznego. Wersja z gałęzi CSV
została porzucona w wersji ok. 1.0, z czystego lenistwa.
Lista przyszłych usprawnień
---------------------------
Patrz: [`TODO.md`](TODO.md)
Autor
-----
Michał Klichowicz (mkl)
Licencja
--------
Patrz: [`LICENSE.md`](LICENSE.md)
|
