Skip to content
This repository has been archived by the owner on Feb 26, 2024. It is now read-only.
/ ausraster Public archive

Taking the (╯°□°)╯︵ ┻━┻ out of working with documents

License

Notifications You must be signed in to change notification settings

hellofresh/ausraster

Repository files navigation

Ausraster

Working with spreadsheets can make you (╯°□°)╯︵ ┻━┻. Ausraster puts a stop to that frustration, by providing a unified, sane interface over various document libraries.

┳━┳ ノ( ゜-゜ノ)

Features and Roadmap

  • Excel adapter (provided by PHPExcel)
  • Fully PSR-2 compliant
  • Composer / PSR-4 compliant
  • Test coverage
  • Cell formatting
  • CSV adapter
  • Other adapters to come! Need an adapter? Feel free to contribute!

Usage

Installation

$ composer require hellofresh/ausraster

Bring Your Own Adapter

By itself, Ausraster doesn't do much, as it needs another library to act as an interface to. For example, we can make use of Ausraster's Spreadsheet interfaces if we include PHPExcel:

$ composer require phpoffice/phpexcel

No matter what spreadsheet adapter you use, Ausraster is designed to have the same simple, friendly interface.

require_once 'vendor/autoload.php';

use HelloFresh\Ausraster\Spreadsheet\Coordinate;
use HelloFresh\Ausraster\Spreadsheet\PhpExcel\Document;

$document = new Document;

$worksheet = $document->createWorksheet();

$coordinate = new Coordinate('A', 1);
$cell = $worksheet->getCellAt($coordinate);
$cell->fill('Ausraster rules!');

$document->save('example.xlsx');

To see more, check out the examples folder.

Contributing

Thinking of adding an adapter or fixing a bug? Thanks! Please see CONTRIBUTING.md before doing so to familiarise yourself with the review process, code of conduct, etc.

License

MIT License