summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authoremkael <emkael@tlen.pl>2015-08-31 00:00:00 +0200
committeremkael <emkael@tlen.pl>2015-08-31 00:00:00 +0200
commita69ea09c197a38f878b8af1540e02dfcbd202451 (patch)
treef77861aa4386c432fd6a6d13f7ac1e6633449e2b /README.md
parentcb5d9a600c62c378d9acdd90d1045478ef99edbe (diff)
* reading directly from BWS, via pypyodbc
Diffstat (limited to 'README.md')
-rw-r--r--README.md41
1 files changed, 15 insertions, 26 deletions
diff --git a/README.md b/README.md
index f981038..f84e6e6 100644
--- a/README.md
+++ b/README.md
@@ -16,9 +16,7 @@ Wymagania systemowe
* BeautifulSoup4
* lxml (jako parser dla BS4)
* argparse
-
-Opcjonalnie, wrapper Basha konwertujący dane z BWS do CSV, używa `mdb-export`
-z pakietu `mdbtools`.
+* pypyodbc
Instalacja
----------
@@ -42,37 +40,18 @@ Użycie
Skrypt [`bidding_data.py`](bidding_data.py) operuje na następujących
danych wejściowych:
* plikach HTML wygenerowanych po zakończeniu turnieju stron statycznych
-* plikach CSV z danymi o licytacji i ustawieniu par, wyeksportowanymi z pliku
-BWS
-
-Aby uzyskać pliki CSV niezbędne do działania narzędzia, należy zapisać całą
-zawartość tabel `BiddingData` oraz `RoundData` do osobnych plików CSV.
-
-W środowiskach linuksowych dokonuje tego narzędzie `mdb-export` z pakietu
-`mdb-tools`:
-```
-mdb-export PLIK.bws BiddingData > DANE_LICYTACJI.csv
-mdb-export PLIK.bws RoundData > DANE_USTAWIENIA.csv
-```
+* pliku BWS sesji
-Po wygenerowaniu w/w plików CSV, [`bidding_data.py`](bidding_data.py)
-przyjmuje następujące parametry:
+Skrypt przyjmuje parametry w sposób następujący:
```
-python bidding_data.py DANE_LICYTACJI.csv DANE_USTAWIENIA.csv KATALOG_ROBOCZY_Z_PREFIKSEM_TURNIEJU [mapowanie numerów rozdań]
+python bidding_data.py DANE_SESJI.bws KATALOG_ROBOCZY_Z_PREFIKSEM_TURNIEJU [mapowanie numerów rozdań]
```
-`DANE_LICYTACJI.csv` i `DANE_USTAWIENIA.csv` to pliki z danymi wyeskportowanymi
-z BWS.
+`DANE_SESJI.bws` to plik BWS z zebranymi danymi sesji.
`KATALOG_ROBOCZY_Z_PREFIKSEM_TURNIEJU` to ściezka to katalogu WWW z doklejonym
Parowym prefiksem turnieju (czyli np. `..\www\moj_turniej`).
-Udostępniany ze skryptem wrapper [`bidding_data.sh`](bidding_data.sh)
-obsługuje eksport z BWS poprzez `mdb-export`, wystarczy więc:
-```
-./bidding_data.sh PLIK.bws KATALOG_ROBOCZY_Z_PREFIKSEM_TURNIEJU [mapowanie numerów rozdań]
-```
-
Narzędzie obsługuje niestandardowe zakresy numeracji rozdań w turnieju.
Domyślnie, mapowanie numeru rozdań z Par na numer rozdania w BWS
@@ -92,6 +71,16 @@ w ramach mapowania)
Na przykład, podanie parametrów `1 8 23` sprawi, że protokoły od `*001.html`
do `*008.html` zostaną uzupełnione o licytację z rozdań 23-30.
+Kompatybilność
+--------------
+
+Narzędzie łączy się przez ODBC do bazy MSAccess, 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](tree/csv).
+
Lista przyszłych usprawnień
---------------------------