massive / build-bundle
Massive Art Build Bundle
Installs: 1 089 069
Dependents: 8
Suggesters: 0
Security: 0
Stars: 44
Watchers: 11
Forks: 10
Open Issues: 3
Requires
- php: >=7.2.0
- symfony/config: ^4.3 || ^5.0 || ^6.0 || ^7.0
- symfony/console: ^4.3 || ^5.0 || ^6.0 || ^7.0
- symfony/dependency-injection: ^4.3 || ^5.0 || ^6.0 || ^7.0
- symfony/framework-bundle: ^4.3 || ^5.0 || ^6.0 || ^7.0
Requires (Dev)
- matthiasnoback/symfony-dependency-injection-test: ^4.0 || ^5.0
- phpspec/prophecy: ^1.14
- phpunit/phpunit: ^8.5
README
The Massive Build Bundle provides a massive:build
command which runs build
targets.
Targets are classes which execute arbitary code, and are registred in the dependency injection container via. tags. Targets can depend on other targets.
Virtual targets can be created in you applications configuration file. These virtual targets simply declare depenencies, enabling you to configure custom build processes.
The aim of this bundle is to provide an extensible, decoupled, way of building software project environments, especially in a development context.
If you often find youself executing several Symfony commands consecutively to establish your environment, then this bundle is for you.
This tool is not mean to replace Make or Ant or Phing. The bundle should only be used to execute build steps which are contained in the client application.
Defining targets
You can define new build targets in you applications configuration file:
massive_build:
targets:
main:
dependencies:
target_one: ~
target_two: ~
target_three: ~
quick:
dependencies:
target_one: ~
The above will allow you to execute:
$ php app/console massive:build main
and:
$ php app/console massive:build quick
Creating build classes
You create builder classes in your application / bundles. Each build class should have a specific responsiblity.
A minimal example:
<?php namespace My\Web\Application; use Massive\Bundle\BuildBundle\Build\BuilderInterface; class MyBuilder implements BuilderInterface { protected $context; public function getName() { return 'mybuildername'; } public function getDependencies() { return array(); } public function build() { $application = $this->context->getApplication(); $input = $this->context->getInput(); $output = $this->context->getOutput(); $output->writeln('Hello World!'); } public function setContext(BuilderContext $context) { $this->context = $context; } }
- getName: Return a name for the builder.
- getDependencies: Return the names of any builders that this builder depends on.
- build: Execute all logic in this method
- setContext: Called automatically by the master build command, contains
the
Input
,Output
andApplication
.
Registring the builder class
You can register the builder class in the dependency injection container and# then tag it with
<service id="sulu.core.build.builder.database" class="My\Web\Application\Builder\FooBuilder"> <tag name="massive_build.builder" /> </service>
Adding global options and customization
You can make options available to your commands (e.g. to specify that they
should destroy
the database, or that the name of user "x" should be set to
"y").
By taking this approach you are free to customize the build
command in
anyway that you like.
To so this you need to extend the massive BuildCommand
and configuring the
MassiveBuild bundle to use your extended class.
<?php namespace Sulu\Bundle\CoreBundle\Command; use Massive\Bundle\BuildBundle\Command\BuildCommand; use Symfony\Component\Console\Input\InputArgument; use Symfony\Component\Console\Input\InputOption; class SuluBuildCommand extends BuildCommand { public function configure() { parent::configure(); // change the name of the command from "massive:build" $this->setName('myapp:build'); // add an option $this->addOption('destroy', null, InputOption::VALUE_NONE, 'Destroy existing data'); } }
Launching the build
You can launch all the builders with the following command:
$ php app/console massive:build
Launch a specific target:
$ php app/console massive:build mytarget
If you want to see which targets are available, use the --nobuild option:
$ php app/console massive:build --nobuild Build Targets ============= +---+----------+--------------------+ | # | Builder | Deps | +---+----------+--------------------+ | 0 | database | | | 1 | phpcr | database | | 2 | fixtures | database | | 3 | user | database, fixtures | +---+----------+--------------------+
By default if you specify a specific target, the build system will build any dependencies
it has, to disable this use the --nodeps
option.
$ php app/console massive:build --nodeps