Code::icon() - Code Metrics - Inspection of "Merge branch 'release/5.0.0-beta.3' into v5" - nystudio107/craft-code-field - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — v5 ( 2ad962...88ce87 )

by Andrew
created 2024-02-09 19:27 UTC
Code::icon() A

↳ Parent: Code
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
eloc	1
nc	1
nop	0
dl	0
loc	3
c	1
b	0
f	0
cc	1
rs	10
<?php
/**
 * Code Field plugin for Craft CMS
 *
 * Provides a Code Field that has a full-featured code editor with syntax highlighting & autocomplete
 *
 * @link      https://nystudio107.com

 * @copyright Copyright (c) 2022 nystudio107

 */


namespace nystudio107\codefield\fields;

use Craft;
use craft\base\ElementInterface;
filter:
    dependency_paths: ["lib/*"]
use craft\base\Field;
use craft\base\PreviewableFieldInterface;
use craft\helpers\Html;
use craft\helpers\Json;
use craft\validators\ArrayValidator;
use GraphQL\Type\Definition\Type;
use nystudio107\codefield\gql\types\generators\CodeDataGenerator;
use nystudio107\codefield\models\CodeData;
use nystudio107\codefield\validators\JsonValidator;
use yii\db\Schema;
use function is_array;
use function is_string;

/**

 * @author    nystudio107

 * @package   CodeField

 * @since     4.0.0

 */

class Code extends Field implements PreviewableFieldInterface
{
    // Constants
    // =========================================================================

    /**
     * Properties that are no longer used, but may still be passed into the $config
     * via __construct() that we should remove to avoid throwing an exception
     */
    protected const DEPRECATED_PROPERTIES = [
        'columnType'
    ];

    // Public Properties
    // =========================================================================

    /**

     * @var string The theme to use for the Code Editor field.
     */
    public string $theme = 'auto';

    /**

     * @var string The language to use for the Code Editor field.
     */
    public string $language = 'javascript';

    /**

     * @var bool Whether the Code Editor field display as a single line
     */
    public bool $singleLineEditor = false;

    /**

     * @var int The font size to use for the Code Editor field
     */
    public int $fontSize = 14;

    /**

     * @var bool Whether line numbers should be displayed in the Code Editor field
     */
    public bool $lineNumbers = false;

    /**

     * @var bool Whether code folding should be used in the Code Editor field
     */
    public bool $codeFolding = false;

    /**

     * @var string The text that will be shown if the code field is empty.
     */
    public string $placeholder = '';

    /**

     * @var bool Whether the language selector dropdown menu should be displayed.
     */
    public bool $showLanguageDropdown = true;

    /**

     * @var string The default value the Code Field will be populated with
     */
    public string $defaultValue = '';

    /**

     * @var array The languages that should be listed in the language selector dropdown menu.
     */
    public array $availableLanguages = [
        'css',
        'graphql',
        'html',
        'javascript',
        'json',
        'markdown',
        'mysql',
        'php',
        'shell',
        'twig',
        'typescript',
        'yaml',
    ];

    /**

     * @var string JSON blob of Monaco [EditorOptions](https://microsoft.github.io/monaco-editor/api/interfaces/monaco.editor.IEditorOptions.html) that will override the default settings
     */
    public string $monacoEditorOptions = '';

    // Static Methods
    // =========================================================================

    /**

     * @inheritdoc
     */
    public function __construct(array $config = [])
    {
        // Unset any deprecated properties
        foreach (self::DEPRECATED_PROPERTIES as $deprecatedProperty) {
            unset($config[$deprecatedProperty]);
        }
        parent::__construct($config);
    }

    /**

     * @inheritdoc
     */

    public static function dbType(): array|string|null
    {
        return Schema::TYPE_TEXT;
    }

    /**

     * @inheritdoc
     */

    public static function icon(): string
    {
        return 'code';
    }

    /**

     * @inheritdoc
     */

    public static function displayName(): string
    {
        return Craft::t('codefield', 'Code');
    }

    // Public Methods
    // =========================================================================

    /**

     * @inheritdoc
     */

    public function normalizeValue(mixed $value, ?ElementInterface $element = null): mixed
    {
        if ($value instanceof CodeData) {
            return $value;
        }
        // Default config
        $config = [
            'value' => $this->defaultValue,
            'language' => $this->language,
        ];
        // Handle incoming values potentially being JSON or an array
        if (!empty($value)) {
            // Handle JSON-encoded values coming in
            if (is_string($value)) {
                $jsonValue = Json::decodeIfJson($value);
                // If this is still a string (meaning it's not valid JSON), treat it as the value
                if (is_string($jsonValue)) {
                    $config['value'] = $jsonValue;
                }
                if (is_array($jsonValue)) {
                    // Check to make sure the array returned is an encoded `CodeData` config, with exactly
                    // the same expected key/value pairs
                    if (!array_diff_key($config, $jsonValue) && !array_diff_key($jsonValue, $config)) {
                        $value = $jsonValue;
                    } else {
                        // Otherwise treat it as JSON data
                        $value = [
                            'value' => $value,
                            'language' => 'json',
                        ];
                    }
                }
            }
            if (is_array($value)) {
                $config = array_merge($config, array_filter($value));
            }
        }
        // Create and validate the model
        $codeData = new CodeData($config);
        if (!$codeData->validate()) {
            Craft::error(
                Craft::t('codefield', 'CodeData failed validation: ')
                . print_r($codeData->getErrors(), true),
                . /** @scrutinizer ignore-type */ print_r($codeData->getErrors(), true),
                __METHOD__
            );
        }

        return $codeData;
    }

    /**

     * @inheritdoc
     */

    public function getSettingsHtml(): ?string
    {
        $monacoLanguages = require(__DIR__ . '/MonacoLanguages.php');

        $schemaFilePath = Craft::getAlias('@nystudio107/codefield/resources/IEditorOptionsSchema.json');
        $optionsSchema = @file_get_contents($schemaFilePath) ?: '';
        $optionsSchema = @file_get_contents(/** @scrutinizer ignore-type */ $schemaFilePath) ?: '';
        // Render the settings template
        return Craft::$app->getView()->renderTemplate(
            'codefield/_components/fields/Code_settings',
            [
                'field' => $this,
                'monacoLanguages' => $monacoLanguages,
                'optionsSchema' => $optionsSchema,
            ]
        );
    }

    /**

     * @inheritdoc
     */

    public function getInputHtml($value, ElementInterface $element = null): string
    {
        $twigVariables = $this->getFieldRenderVariables($value, $element, true);
        $twigVariables = $this->getFieldRenderVariables($value, /** @scrutinizer ignore-type */ $element, true);
        // Render the input template
        return Craft::$app->getView()->renderTemplate(
            'codefield/_components/fields/Code_input',
            $twigVariables
        );
    }

    /**

     * @inheritdoc
     */

    public function getStaticHtml(mixed $value, ElementInterface $element): string
    {
        $twigVariables = $this->getFieldRenderVariables($value, $element, false);
        // Render the input template
        return Craft::$app->getView()->renderTemplate(
            'codefield/_components/fields/Code_input',
            $twigVariables
        );
    }

    /**

     * @inheritdoc
     */

    public function getContentGqlType(): Type|array
    {
        $typeArray = CodeDataGenerator::generateTypes($this);

        return [
            'name' => $this->handle,
            'description' => 'Code Editor field',
            'type' => array_shift($typeArray),
        ];
    }

    /**

     * @inheritdoc
     */

    public function rules(): array
    {
        $rules = parent::rules();
        return array_merge($rules, [

            ['theme', 'in', 'range' => ['auto', 'vs', 'vs-dark', 'hc-black']],
            ['theme', 'default', 'value' => 'auto'],
            ['language', 'string'],
            ['language', 'default', 'value' => 'javascript'],
            [['singleLineEditor', 'showLanguageDropdown', 'lineNumbers', 'codeFolding'], 'boolean'],
            ['placeholder', 'string'],
            ['placeholder', 'default', 'value' => ''],
            ['fontSize', 'integer'],
            ['fontSize', 'default', 'value' => 14],
            ['availableLanguages', ArrayValidator::class],
            ['monacoEditorOptions', JsonValidator::class],
        ]);
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
    }

    // Protected Methods
    // =========================================================================

    /**
     * Return the Twig variables for rendering the field
     *
     * @param $value

     * @param ElementInterface $element

     * @param bool $enabled Whether the field is enabled or not

     * @return array[]

     */
    protected function getFieldRenderVariables($value, ElementInterface $element, bool $enabled): array
    {
        // Get our id and namespace
        $id = Html::id($this->handle);
        $namespacedId = Craft::$app->getView()->namespaceInputId($id);

        // Extract just the languages that have been selected for display
        $displayLanguages = [];
        if ($this->showLanguageDropdown) {
            $monacoLanguages = require(__DIR__ . '/MonacoLanguages.php');

            $decomposedLanguages = array_column($monacoLanguages, 'label', 'value');
            $displayLanguages = array_intersect_key($decomposedLanguages, array_flip($this->availableLanguages));
            // Handle "all" checkbox
            if ($this->availableLanguages[0] === '*') {
                $displayLanguages = $decomposedLanguages;
            }
            $displayLanguages = array_map(static function($k, $v) {

                return ['value' => $k, 'label' => $v];
            }, array_keys($displayLanguages), array_values($displayLanguages));
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
        }
        $monacoOptionsOverride = Json::decodeIfJson($this->monacoEditorOptions);
        if ($monacoOptionsOverride === null || is_string($monacoOptionsOverride)) {
            $monacoOptionsOverride = [];
        }
        // Disable the Monaco editor
        if (!$enabled) {
            $monacoOptionsOverride['domReadOnly'] = true;
            $monacoOptionsOverride['readOnly'] = true;
        }
        return [

            'name' => $this->handle,
            'value' => $value,
            'field' => $this,
            'orientation' => $this->getOrientation($element),
            'id' => $id,
            'namespacedId' => $namespacedId,
            'displayLanguages' => $displayLanguages,
            'monacoOptionsOverride' => $monacoOptionsOverride,
        ];
    }
}

nystudio107 / craft-code-field

Push — v5 ( 2ad962...88ce87 )

Code::icon() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
