Kadet\Highlighter\Language\Language

Complexity

Total Complexity

5

Size/Duplication

Total Lines	67
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	1

Test Coverage

Coverage

100%

Importance

Changes	37
Bugs	5	Features	0

10 Methods

Rating	Name	Duplication	Size	Complexity
	getIdentifier()	0	1	?
	getEnds()	0	1	?
	getEmbedded()	0	1	?
	embed()	0	1	?
A	byName()	0	4	1
A	byMime()	0	4	1
A	byFilename()	0	4	1
	parse()	0	1	?
	tokenize()	0	1	?
A	getFQN()	0	5	2

<?php
/**
 * Highlighter
 *
 * Copyright (C) 2016, Some right reserved.
 *
 * @author Kacper "Kadet" Donat <kacper@kadet.net>
 *
 * Contact with author:
 * Xmpp: me@kadet.net
 * E-mail: contact@kadet.net
 *
 * From Kadet with love.
 */
namespace Kadet\Highlighter\Language;

use Kadet\Highlighter\KeyLighter;
use Kadet\Highlighter\Parser\Rule;
use Kadet\Highlighter\Parser\TokenIterator;
use Kadet\Highlighter\Parser\Tokens;


/**
 * Class Language
 *
 * @package Kadet\Highlighter\Language
 */
abstract class Language
{
    const EMBEDDED_BY_PARENT = 2;
    const EMBEDDED           = true;
    const NOT_EMBEDDED       = false;

    /**
     * Parses source and removes wrong tokens.
     *
     * @param TokenIterator|string $tokens
     *
     * @param array                $additional
     * @param bool                 $embedded
     *
     * @return Tokens
     */
    public abstract function parse($tokens = null, $additional = [], $embedded = false);

    public abstract function tokenize($source, $additional = [], $offset = 0, $embedded = false);

    /**
     * Unique language identifier, for example 'php'
     *
     * @return string
     */
    public abstract function getIdentifier();

    /**
     * Language range Rule(s)
     *
     * @param $embedded
     *
     * @return Rule|\Kadet\Highlighter\Parser\Rule[]
     */
    public abstract function getEnds($embedded = false);

    /**
     * @return Language[]
     */
    public abstract function getEmbedded();

    /**
     * @param Language $lang
     */
    public abstract function embed(Language $lang);

    public static function byName($name, $params = [])
    {
        return KeyLighter::get()->languageByName($name, $params);
    }

    public static function byMime($mime, $params = [])
    {
        return KeyLighter::get()->languageByMime($mime, $params);
    }

    public static function byFilename($filename, $params = [])
    {
        return KeyLighter::get()->languageByExt($filename, $params);
    }

    public final function getFQN()
    {
        $embedded = $this->getEmbedded();
        return get_class($this).(!empty($embedded) ? ' + '.implode(', ', array_map('get_class', $embedded)) : '');
    }
}