Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/bazzline/php_component_locator_generator

free as in freedom free software php locator generator component to easy up locator generation
https://github.com/bazzline/php_component_locator_generator

bazzline builder free-as-in-freedom generator lgplv3 locator php php56 php7

Last synced: 6 months ago
JSON representation

free as in freedom free software php locator generator component to easy up locator generation

Awesome Lists containing this project

README 

          
# Locator Generator



This free as in freedom component easy up locator generation based on configuration files.

Out of the box, it creates locator from an array configuration file and from propel1 schema.xml files.



It is using the [php code generator component](https://github.com/bazzline/php_component_code_generator) as a robust base for code generation.



The build status of the current master branch is tracked by Travis CI:

[![Build Status](https://travis-ci.org/bazzline/php_component_locator_generator.png?branch=master)](http://travis-ci.org/bazzline/php_component_locator_generator)

[![Latest stable](https://img.shields.io/packagist/v/net_bazzline/php_component_locator_generator.svg)](https://packagist.org/packages/net_bazzline/php_component_locator_generator)



The scrutinizer status are:

[![code quality](https://scrutinizer-ci.com/g/bazzline/php_component_locator_generator/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/bazzline/php_component_locator_generator/) | [![build status](https://scrutinizer-ci.com/g/bazzline/php_component_locator_generator/badges/build.png?b=master)](https://scrutinizer-ci.com/g/bazzline/php_component_locator_generator/)



The versioneye status is:

[![dependencies](https://www.versioneye.com/user/projects/53e48c23e0a229172f000146/badge.svg?style=flat)](https://www.versioneye.com/user/projects/53e48c23e0a229172f000146)



Downloads:

[![Downloads this Month](https://img.shields.io/packagist/dm/net_bazzline/php_component_locator_generator.svg)](https://packagist.org/packages/net_bazzline/php_component_locator_generator)



It is also available at [openhub.net](http://www.openhub.net/p/718779).



# Why



* don't like "serviceLocator->get('foo')" (inexplicit API) calls

* like the configurable approach of some service locators out there

* inspired by a [php usergroup](http://artodeto.bazzline.net/archives/525-Social-Human-Architecture-for-Beginners-and-the-Flip-Side-of-Dependency-Injection-PHPUGHH.html) presentation called "[the flipside of dependency injection](http://thephp.cc/dates/2014/phpughh/the-flip-side-of-dependency-injection)" i'Ve seen "i'm not alone"

* generated code is easy debug- and understandable (no magic inside)



# How



* a task specific configuration assembler creates a unified configuration object

* unified configuration object is injected into the locator generator

* the locator generator creates needed files

* a file exists strategy can take care how to deal with existing files



# Install



## By Hand



    mkdir -p vendor/net_bazzline/php_component_locator_generator

    cd vendor/net_bazzline/php_component_locator_generator

    git clone https://github.com/bazzline/php_component_locator_generator



## With [Packagist](https://packagist.org/packages/net_bazzline/php_component_locator_generator)



    composer require net_bazzline/php_component_locator_generator:dev-master



# Example



## Array Configuration File



Take a Look to [configuration file](https://github.com/bazzline/php_component_locator_generator/blob/master/example/ArrayConfiguration/configuration.php).



### How To Create



```shell

cd 

./execute_example ArrayConfiguration

ls data/

vim data/FromArrayConfigurationFileLocator.php

```



### Generated Code



```php

fetchFromFactoryInstancePool('\Application\Factory\ExampleUniqueFactorizedInstanceFactory')->create();

    }



    /**

     * @return \Application\Model\ExampleSharedInvokableInstance

     */

    public function getExampleSharedInvokableInstance()

    {

        return $this->fetchFromSharedInstancePool('\Application\Model\ExampleSharedInvokableInstance');

    }



    /**

     * @return \Application\Factory\ExampleSharedFactorizedInstanceFactory

     */

    public function getExampleSharedFactorizedInstance()

    {

        $className = '\Application\Factory\ExampleSharedFactorizedInstanceFactory';



        if ($this->isNotInSharedInstancePool($className)) {

            $factoryClassName = '\Application\Factory\ExampleSharedFactorizedInstanceFactory';

            $factory = $this->fetchFromFactoryInstancePool($factoryClassName);



            $this->addToSharedInstancePool($className, $factory->create());

        }



        return $this->fetchFromSharedInstancePool($className);

    }

    //... code for internal methods

}

```



The Locator is taking care of the instance pooling.



# Behaviour



* creates a FactoryInterface file

* creates a InvalidArgumentException if a namespace is given



# Terms



* Assembler

    * implements the [AssemblerInterface](https://github.com/bazzline/php_component_locator_generator/blob/master/source/Configuration/Assembler/AssemblerInterface.php)

    * implements the way the [Configuration](https://github.com/bazzline/php_component_locator_generator/blob/master/source/Configuration.php) is filled with data

* MethodBodyBuilder

    * implements the [MethodBodyBuilderInterface](https://github.com/bazzline/php_component_locator_generator/blob/master/source/MethodBodyBuilder/MethodBodyBuilderInterface.php)

    * provides a way to extend a instance creation method body

    * provides a way to extend the method documentation

* FileExistsStrategy

    * implements the [FileExistsStrategyInterface](https://github.com/bazzline/php_component_locator_generator/blob/master/source/FileExistsStrategy/FileExistsStrategyInterface.php)

    * provides a way to deal with the fact a generated file exists already



# Benefits



* on way of calling the locator generator "php bin/generate_locator "

* assembler, method builder and file exists strategy are configuration based runtime variables

* highly configurable

    * each configuration file needs to be a simple php array

    * mandatory array keys are

        * assembler

        * file_exists_strategy

    * optional array key is

        * boostrap_file

    * rest of configuration is based on the given assembler

* shipped with two [assembler](https://github.com/bazzline/php_component_locator_generator/blob/master/source/Configuration/Assembler) implementations

    * FromArrayAssembler

        * mandatory array keys

            * class_name 

            * file_path 

        * optional array keys

            * extends  (can be empty)

            * implements  (can be empty)

            * instances  (can be empty)

                * alias 

                * is_factory 

                * is_shared 

                * method_body_builder 

            * method_prefix 

            * namespace  (can be empty)

            * uses  (can be empty)

                * alias 

    * FromPropelSchemaXmlAssembler

        * mandatory array keys

            * class_name 

            * file_path 

        * optional array keys

            * extends  (can be empty)

            * implements  (can be empty)

            * method_prefix

            * namespace  (can be empty)

            * path_to_schema_xml 

            * uses  (can be empty)

    * implement the [AssemblerInterface](https://github.com/bazzline/php_component_locator_generator/blob/master/source/Configuration/Assembler/AssemblerInterface.php) to write your own assembler

* shipped with two file exists strategies

    * DeleteStrategy

    * SuffixWithCurrentTimestampStrategy

    * implement the [FileExistsStrategyInterface](https://github.com/bazzline/php_component_locator_generator/blob/master/source/FileExistsStrategy/FileExistsStrategyInterface.php) to write your own strategy

* shipped with five [method body builder](https://github.com/bazzline/php_component_locator_generator/blob/master/source/MethodBodyBuilder) implementations

    * FetchFromFactoryInstancePoolBuilder used internally by the generated locator

    * FetchFromSharedInstancePoolBuilder used internally by the generated locator

    * FetchFromSharedInstancePoolOrCreateByFactoryBuilder used internally by the generated locator

    * NewInstanceBuilder used internally by the generated locator

    * PropelQueryCreateBuilder as an example to use your own method body builder

    * [ValidatedInstanceCreationBuilder](https://github.com/bazzline/php_component_locator_generator/blob/master/example/ArrayConfiguration/ValidatedInstanceCreationBuilder.php) as an additional example how to use the power of the method body builder support to generate own instance creation code

    * implement the [MethodBodyBuilderInterface](https://github.com/bazzline/php_component_locator_generator/blob/master/source/MethodBodyBuilder/MethodBodyBuilderInterface.php) to write your own method body builder

* uses separate [component](https://github.com/stevleibelt/php_component_code_generator) for php code generation



# API



The API is available at [www.bazzline.net](http://bazzline.net/46d8f78c8f722a707d9bdafb4ec708ca2d74d121/index.html), thanks to [apigen](https://github.com/apigen/apigen) and the [api document builder](https://github.com/bazzline/api_document_builder).



# History



* [upcomming](https://github.com/bazzline/php_component_locator_generator/tree/master)

    * @todo

        * added unit test for

            * Command

            * Configuration/Validator/*

            * Generator

            * Process/*

        * add "default" section in the configuration for "is_shared" and "is_factory" (and maybe more)

        * add "verify" method to configuration that throws an error if not all mandatory parameters are set

        * implement validation of used interface- or class names by adding "autoloader class path"

        * implement a flag to create a LocatorInterface out of the written Locator

        * implement "FromPath" assembler that scans the path and iterates through the path and fetches the php class or interfaces

        * split readme into multiple files

        * use "net_bazzline/php_component_cli_environment" to create "net_bazzline_generate_locator"

        * use "net_bazzline/php_component_cli_environment" to create "net_bazzline_generate_locator_configuration  "

    * added php 7 continous integration run for travis

    * moved to psr-4 autoloading

    * updated dependencies

* [2.0.9](https://github.com/bazzline/php_component_locator_generator/tree/2.0.9) - released at 22.03.2016

    * updated dependencies

* [2.0.8](https://github.com/bazzline/php_component_locator_generator/tree/2.0.8) - released at 11.12.2015

    * updated dependencies

* [2.0.7](https://github.com/bazzline/php_component_locator_generator/tree/2.0.7) - released at 01.12.2015

    * updated dependencies

* [2.0.6](https://github.com/bazzline/php_component_locator_generator/tree/2.0.6) - released at 29.11.2015

    * fixed issue [6](https://github.com/bazzline/php_component_locator_generator/issues/6)

    * fixed issue [7](https://github.com/bazzline/php_component_locator_generator/issues/7)

    * move documentation to [www.bazzline.net](http://bazzline.net/)

    * updated dependencies

* [2.0.5](https://github.com/bazzline/php_component_locator_generator/tree/2.0.5) - released at 18.11.2015

    * updated depenceny

* [2.0.4](https://github.com/bazzline/php_component_locator_generator/tree/2.0.4) - released at 19.09.2015

    * updated depenceny

* [2.0.3](https://github.com/bazzline/php_component_locator_generator/tree/2.0.3) - released at 18.09.2015

    * updated depenceny

* [2.0.2](https://github.com/bazzline/php_component_locator_generator/tree/2.0.2) - released at 28.08.2015

    * updated depenceny

* [2.0.1](https://github.com/bazzline/php_component_locator_generator/tree/2.0.1) - released at 04.07.2015

    * updated depenceny

* [2.0.0](https://github.com/bazzline/php_component_locator_generator/tree/2.0.0) - released at 03.06.2015

    * Generator.php now throws "InvalidArgumentException" instead of "RuntimeException

    * Generator now tries to create the provided directory if it does not exists

    * fixed [issue/2](https://github.com/bazzline/php_component_locator_generator/issues/2)

    * fixed [issue/4](https://github.com/bazzline/php_component_locator_generator/issues/4)

    * fixed [issue/5](https://github.com/bazzline/php_component_locator_generator/issues/5)

    * implement usage of php_component_cli_arguments

    * implement usage of php_component_command

    * renamed "bin/generalte_locator" to "bin/net_bazzline_generate_locator"

* [1.5.1](https://github.com/bazzline/php_component_locator_generator/tree/1.5.1) - released at 27.05.2015

    * fixed broken entry of "bin" in composer.json

* [1.5.0](https://github.com/bazzline/php_component_locator_generator/tree/1.5.0) - released at 27.05.2015

    * renamed "bin/generateLocator.php" to "bin/generate_locator"

    * renamed "example/[..]/run.php" to "example/[...]/run"

    * fixed [issue 3](https://github.com/bazzline/php_component_locator_generator/issues/3)

* [1.4.2](https://github.com/bazzline/php_component_locator_generator/tree/1.4.2) - released at 22.05.2015

    * updated dependencies

* [1.4.1](https://github.com/bazzline/php_component_locator_generator/tree/1.4.1) - released at 08.02.2015

    * removed dependency to apigen

* [1.4.0](https://github.com/bazzline/php_component_locator_generator/tree/1.4.0) - released at 07.02.2015

    * implemented generation of "LocatorGeneratorInterface"

    * easy up usage of examples by adding command "execute_example"

    * added example for "method_name_without_namespace"

    * updated api

    * updated dependencies

* [1.3.1](https://github.com/bazzline/php_component_locator_generator/tree/1.3.1) - released at 07.02.2015

    * easy up usage of examples (by adding a "run.php" in the directories

    * updated api

    * updated dependencies

* [1.3.0](https://github.com/bazzline/php_component_locator_generator/tree/1.3.0) - released at 22.12.2014

    * implemented "method_name_without_namespace" option in "FromPropelSchemaXmlAssembler" ("createMyTable" instead of "createMyNamespaceMyTable")

* [1.2.1](https://github.com/bazzline/php_component_locator_generator/tree/1.2.1) - released at 21.12.2014

    * updated api

    * refactored Command

    * refactored FromArrayAssembler

    * refactored FromPropelSchemaXmlAssembler

* [1.2.0](https://github.com/bazzline/php_component_locator_generator/tree/1.2.0) - released at 20.12.2014

    * fixed bug in propel name space FromPropelSchemaXmlAssembler

    * refactored FromPropelSchemaXmlAssembler

    * extended usage output

* [1.1.0](https://github.com/bazzline/php_component_locator_generator/tree/1.1.0) - released at 13.09.2014

    * enhanced Command

        * absolute configuration paths are now supported

    * fixed (stupid) broken unittest

    * fixed error in Command

        * check if "bootstrap_file" exists in configuration was not well implemented

    * updated dependencies

* [1.0.1](https://github.com/bazzline/php_component_locator_generator/tree/1.0.1) - released at 03.09.2014

    * added api

    * fixed broken links

    * adapted composer.json project name

    * moved command logic into simple Command class

    * added check in "generateLocator.php" to validate if installed as composer component or not

* [1.0.0](https://github.com/bazzline/php_component_locator_generator/tree/1.0.0) - released at 31.08.2014

    * initial project start

    * unit tests

    * examples

    * codebase itself

    * api description