gnugat/redaktilo

Find, insert, replace and remove lines with an Editor-like object

Maintainers

Details

github.com/gnugat/redaktilo

Source

Issues

Installs: 218 585

Dependents: 6

Suggesters: 0

Security: 0

Stars: 81

Watchers: 7

Forks: 11

Open Issues: 5

2.0.1 2024-08-12 20:19 UTC

Requires

Requires (Dev)

MIT 9071445f87cd5d258a9c86b52e93ca9e3af29cde

fileeditorinserteditreplacefindremovelines

This package is auto-updated.

Last update: 2024-12-12 21:03:17 UTC

README

Redaktilo allows you to find, insert, replace and remove lines using an editor-like object.

Because your code too needs an editor to manipulate files.

Getting started

Use Composer to install Redaktilo in your projects:

$ composer require "gnugat/redaktilo:^2.0"

Redaktilo provides an Editor class which can be instanciated using EditorFactory:

<?php
require_once __DIR__.'/vendor/autoload.php';

use Gnugat\Redaktilo\EditorFactory;

$editor = EditorFactory::createEditor();

Real life example

For our example, we will create a KernelManipulator similar to the one we can find in SensioGeneratorBundle.

It takes a bundle's fully qualified classname and inserts it in the AppKernel file:

<?php

namespace Sensio\Bundle\GeneratorBundle\Manipulator;

use Gnugat\Redaktilo\Editor;

class KernelManipulator extends Manipulator
{
    protected $editor;
    protected $appKernelFilename;

    public function __construct(Editor $editor, $appKernelFilename)
    {
        $this->editor = $editor;
        $this->appKernelFilename = $appKernelFilename;
    }

    public function addBundle($bundle)
    {
        $appKernel = $this->editor->open($this->appKernelFilename);
        $newBundle = "            new $bundle(),";
        if ($this->editor->hasBelow($appKernel, $newBundle)) {
            $message = sprintf('Bundle "%s" is already defined in "AppKernel::registerBundles()".', $bundle);

            throw new \RuntimeException($message);
        }
        $this->editor->jumpBelow($appKernel, '        );');
        $this->editor->insertAbove($appKernel, $newBundle);
        $this->editor->save($appKernel);

        return true;
    }
}

As you can see it's easier to read and to understand than the original PHP token parsing.

Further documentation

You can see the current and past versions using one of the following:

You can find more documentation at the following links:

Next readings: