php-fantasy-football-quotations-parser

Allows to parse files that are provided by main sport newspapers with quotations of players after each soccer match of the Serie A championship.

View project on GitHub

Build Status Codacy Badge Codacy Badge Dependency Status Latest Stable Version License

Fantasy Football Quotations Parser

Provides a way to parse files that are provided by main sport newspapers with players quotations after each soccer match of the Serie A championship.

Supported Newspapers

Currently the “Gazzetta dello Sport” is the only supported newspaper.

NOTE: To add another newspaper into the supported list, please provide us new kinds of files that need to be parsed in order to update the php package.

To do that please file a new issue.

Installation

You can install the library and its dependencies using composer running:

$ composer require astronati/fantasy-football-quotations-parser

Usage

The library allows to return a model per each quotation (player, vote, etc…).

Example

The following snippet is extracted from the example/sample.php file and shows how parsing an excel file of the season 2017/2018

// Obtain a QuotationsParser
$quotationsParser = QuotationsParserFactory::create(QuotationsParserFactory::FORMAT_GAZZETTA_SINCE_2017);

// Get the quotations, ready to be used
$quotations = $quotationsParser->getQuotations('example/files/2017_quotazioni_gazzetta_02.xls');
Supported Formats

Take a look at the Gazzetta folder to know which formats are supported

Quotation(s)

A Quotation instance allows to map a single row and to return information as follows:

$quotations[0]->isWithoutVote();

Development

The environment requires phpunit, that has been already included in the dev-dependencies of the composer.json.

Dependencies

To install all modules you just need to run following command:

$ composer install

Testing

Tests files are created in dedicates folders that replicate the src structure as follows:

.
+-- src
|   +-- [folder-name]
|   |   +-- [file-name].php
|   ...
+-- tests
|   +-- [folder-name]
|   |   +-- [file-name]Test.php

Execute following command to run the tests suite:

$ composer test

Run what follows to see the code coverage:

$ composer coverage

License

This package is released under the MIT license.