• Add support for php-parser 5, Drops support for php parser 4.

Thanks to @jasonvarga ✨

Please see #77 for details.

This feature provides a BuilderFactory instance when passing a closure to insertStmt.

PHPFile::make()->class(\App\Dummy::class)
  ->astQuery()
  ->class()
  ->insertStmt(function(BuilderFactory $builder) {
	  return $builder->property('someProperty')->getNode();
  })
  ->commit()
  ->end()
  ->preview();

When astQuery()->insertStmt(.....) had no matches to operate on, it added the node to the end of the file. This was fixed by adding a guard clause.

• Improve pretty printing when creating new classes
• Adds missing types
• Remove unused dev dependency
• new ASTQueryBuilder withEach method
• No more magic for phpparser classmap, use explicit methods instead
• Fix an issue where weak comparison caused flakiness

• Use dependency injection for maker
• Fix most phpstan level 0 errors

Makers

PHPFile::make() now return a Maker instance. Makers allows creating files from a template, for instance:

PHPFile::make()->file('scripts.php')
PHPFile::make()->class(\App\Car::class)

We can implement a custom maker and attaching it to the property "maker" on the File instance.

Internal changes

File methods no longer rely on obscure __call magic, instead minimal stubs are implemented to explicitly forward calls to the corresponding endpoint class.

Avoid Str macros which may cause segmentation fault in statamic/cms

Fixes bug when creating classes.

Now we can create classes like so:

namespace App;

PHPFile::make()->class(Models\Car::class);
PHPFile::make()->class(\App\Models\Car::class);
PHPFile::make()->class('App\Models\Car');
PHPFile::make()->class('\App\Models\Car');
PHPFile::make()->class('app/Models/Car.php');

all of these will write two app/Models/Car.php.

Welcome to v1.0.0 :green_heart:

AstQueryBuilder

• Adds ability to enter Node class and properties in one go:

$astQuery->classMethod('name->name')

• Adds HigherOrderWhere which is a short syntax for where callbacks:

$this->file->astQuery()
    ->class()
    ->property()
    ->where->propertyProperty('name->name')->is($key)->get()
    ->replace(function() {
        ...
    };

• Auto resolving where clauses allows for leaving a where clause without get(). Results are evaluated to see if they have results (considered thruty) or empty (falsy).
• Adds Dumpable proxies on astQueryBuilder for ->dd->something() and ->dump->another
• Adds missing PhpParser types in class map
• Remove option to use _-postfixed node types in class map
• Adds an opt-in visualizer/debug tool, see: https://github.com/ajthinking/archetype/pull/45
• Numerous bugfixes

Endpoints

• Improved ClassConst

Misc

• fromString can allow pseudo php

PHPFile::addMissingTags()->fromString('$hey = 1337')

• Allow reading files outside of the input root using an absolute path
• Add Tappable and Dumpable traits

Discontinued features :warning: :skull:

In order to tighten this package up and consolidate around primary features, we will drop the following incomplete/broken functionality:

• Schema
• Project
• Generators
• Trait endpoint (planned to be revived in a better form)

Furthermore,

• Remove aliases for PHPFile and LaravelFile to enforce explicit facade usage
• Remove doctrine/dbal dependency

Internal changes

• All tests are moved to pest :rocket:
• Introduce TestablePHPFile facade.
• Introduce TestableAstQueryBuilder facade.

Missing and broken

• The docs are still not near as good as they should be.
• Some formatting bugs persist. It is most likely related to format preserving pretty printing. See incomplete test

Whats new?

• Adds remove() ability for class constants.

Discontinued features

In order to tighten this package up and consolidate around primary features, we will drop the following:

• Schema
• Project
• Generators

Most of these feature were incomplete or otherwise broken. A side effect of this is we will no longer be depending on doctrine/dbal.

Tests

All tests are moved to pest and many uses an internal TestablePHPFile facade.

Better array formatting 🎉 🎉 🎉 Works for newly created, loaded or modified code.

class Finally
{
    protected $empty = [];
    
    protected $one = [
        'one',
    ];
    
    protected $moreThanOne = [
        'one',
        'two',
    ];
}

Thanks for spotting this @jackmcdade

Fixes an issue with doctrine/dbal

:bug: Fix bug in notInOperator by @ordago 🔒 Allow doctrine/dbal ^2.10 by @WorldSeso7 :white_check_mark: Bump dependecies, typos and test updates

Include nikic/php-parser as a dependency, don't assume it is included elsewhere.

Rename mismatching class name/file name. Fixes #15

Support for class constant

$file->classConstant('HOME')

Thanks to @seryak

v0.2.1 :rocket:

• Tests on Laravel 8
• Format preserving code manipulation
• Ignores abstract models

Don't use facade aliases which might be unavailable.

Fix class resolving when using archetype schema in remote context

Archetype v0.1.0 :rocket:

• Happy to announce a core set of features including some experiments 🔥
• This package does not yet strictly follow semver 😬
• Need feedback 🙏

In the astQuery(), you can now access general classes/objects/structures with ->methodCall() or similar. To enter a property, simply use ->stmts without ()