Merge branch 'task/docs' into develop

This commit is contained in:
Jeroen De Meerleer 2019-06-03 12:30:31 +02:00
commit 74237ace5c
Signed by: JeroenED
GPG Key ID: 28CCCB8F62BFADD6
3 changed files with 3 additions and 71 deletions

View File

@ -1,13 +1,14 @@
# Lib Pairtwo
# libpairtwo
Copyright 2018- (c) Jeroen De Meerleer <schaak@jeroened.be>
This library reads sws-files that are saved using PairTwo developed by the Belgian Chess Federation (KBSB-FRBE).
This library reads out pairing files that are saved using common pairing applications
## Special thanks
* Daniel Halleux (Webmaster KBSB)
* Bernard Malfliet (Original developer Pairtwo)
* Sylvin De Vet (Arbiter at VSF championship 2019 who helped me explaining several tiebreaks and other arbiter related stuff)
## Licence

0
doc/.gitkeep Normal file
View File

View File

@ -1,69 +0,0 @@
# Getting started
## Installing Libpairtwo
You can easily start using libpairtwo by installing it via composer
```bash
$ composer install JeroenED/libpairtwo
```
In you initialization code add the vendor/autoload.php
```php
require_once("vendor/autoload.php");
```
## Reading out a sws-file
Reading out a sws-file is very simple. Just call the Sws::ReadSws() method.
```php
$sws = JeroenED\Libpairtwo\Sws::ReadSws("Clubcompetition.sws");
```
This will return a usable object for reaching out for results, rankings, etc.
## Getting methods of the class
I didn't want to add the generated phpdoc in this library simply because it is generated.
The command to generate it yourself is just `$ phpdoc`. This will generate the docs in the doc/api folder.
## Examples
### Getting results of a tournament
```php
<?php
require_once("vendor/autoload.php");
use JeroenED\Libpairtwo\Sws;
$sws = Sws::ReadSws("Clubcompetition.sws");
$tournament = $sws->getTournament();
$calendar = $tournament->getRounds();
$roundNo = 1;
foreach ($calendar as $round) {
echo "Ronde: " . $roundNo . ' (' . $round->getDate()->format('Y/m/d') . PHP_EOL . ')'; $roundNo++;
foreach($round->getGames() as $game) {
if (!is_null($game->getResult())) {
echo (is_null($game->getWhite())) ? "bye" : $game->getWhite()->getPlayer()->getName();
echo " " . $game->getResult()->getValue() . " ";
echo (is_null($game->getBlack())) ? "bye" : $game->getBlack()->getPlayer()->getName();
echo PHP_EOL;
}
}
echo PHP_EOL;
```
### Getting rankings of the tournament
```php
<?php
require_once("vendor/autoload.php");
use JeroenED\Libpairtwo\Sws;
$sws = Sws::ReadSws("Clubcompetition.sws");
$tournament = $sws->getTournament();
$rankings = $tournament->getRanking();
$rankingNo = 1;
foreach ($rankings as $ranking) {
echo $rankingNo . '. ' . $ranking->getTitle()->getKey() . ' ' . $ranking->getName() . '(' . $ranking->getPoints() . '/' . $tournament->getNoOfRounds() . ')' . PHP_EOL;
}
echo PHP_EOL;
```