diff --git a/README.md b/README.md index 34b1ee5..f98287b 100644 --- a/README.md +++ b/README.md @@ -1,115 +1,13 @@ -# Codex +# IndifferentKetchup Codex -### About +A generic PHP log parsing and analysis framework. Provides interfaces and base implementations for reading log files, detecting log types, parsing entries into structured form, analysing them for problems and information, and printing results. -Codex (*lat. roughly for "log"*) is a PHP library to read, parse, print and analyse log files to find problems and suggest possible -solutions. It was created mainly for Minecraft server logs but could be used for any other logs as well. This library provides a set -up for a structured log parsing implementation and provides some useful basic implementation, mainly based on RegEx. Every part -of this library can or even must be extended/overwritten while still following the interfaces, which ensure interoperability between -the different parts of this library. - -### Installation +## Installation ``` -composer require aternos/codex +composer require indifferentketchup/codex ``` -## Usage +## Source -This is a short introduction to the idea of Codex, for some more examples check the [test](test) folder -and/or read the [code](src). - -### Logfile - -A [`LogFile`](src/Log/File/LogFile.php) object implementing the [`LogFileInterface`](src/Log/File/LogFileInterface.php) object is required -to start reading a log. There are currently three different log file classes in this library. - -```php -setLogFile($logFile); -``` - -### Detection - -If the log type (specifically the class name of the log type) is unknown you can use the [`Detective`](src/Detective/Detective.php) class -to automatically detect the log type. The `Detective` class gets a list of possible log class names and executes -their given [Detectors](src/Detective/DetectorInterface.php). - -```php -addPossibleLogClass(\Aternos\Codex\Log\Log::class); -$log = $detective->detect(); -``` - -The `detect()` function always returns a log object, if necessary it defaults to [`Log`](src/Log/Log.php). - -### Parsing - -Parsing reads the entire log and creates the [`Entry`](src/Log/EntryInterface.php) and [`Line`](src/Log/LineInterface.php) objects which -are parts of a [`Log`](src/Log/LogInterface.php) object. Different log types can use different parsers by overwriting the -`LogInterface::getDefaultParser()` function or by passing a parser object to the parse function. - -```php -parse(); -``` - -### Analysing - -An analysis is performed by an [`Analyser`](src/Analyser/AnalyserInterface.php) on an [`AnalysableLog`](src/Log/AnalysableLogInterface.php) and returns -an [`Analysis`](src/Analysis/AnalysisInterface.php) object containing various [`Insight`](src/Analysis/InsightInterface.php) objects, e.g. a [`Problem`](src/Analysis/ProblemInterface.php) -or an [`Information`](src/Analysis/InformationInterface.php) object. Different log types can use different analysers by overwriting -the `AnalysableLogInterface::getDefaultAnalyser()` function or by passing an analyser object to the analyse function. - -```php -analyse(); -``` - -### Printing - -The entire [`Log`](src/Log/LogInterface.php) or just an [`Entry`](src/Log/EntryInterface.php) can be printed through a [`Printer`](src/Printer/PrinterInterface.php). The basic -[`DefaultPrinter`](src/Printer/DefaultPrinter.php) only prints the plain content line by line. The [`ModifiableDefaultPrinter`](src/Printer/ModifiableDefaultPrinter.php) -allows [`Modification`](src/Printer/ModificationInterface.php), e.g. to highlight certain characters/words. - -```php -setLog($log); -$printer->print(); - -$printer = new \Aternos\Codex\Printer\DefaultPrinter(); -$printer->setEntry($entry); -$printer->print(); - -$printer = new \Aternos\Codex\Printer\ModifiableDefaultPrinter(); -$printer->setLog($log); -$modification = new \Aternos\Codex\Printer\PatternModification(); -$modification->setPattern('/foo/'); -$modification->setReplacement('bar'); -$printer->addModification($modification); -$printer->print(); -``` +