README

Welcome to The Troll Inception (TTI) project, it is not a framework, but a solution behind a framework.

The Troll Inception is an objective reality php "solution" NOT A FRAMEWORK, based over the CSS (Code Similar Situations) principle, and a personal notion of object, all thought by Edouard Kombo. Because you don't have to learn a framework, but only good development practices, TTI is not a framework, but a concentration of good practices made extremely intuitive and playful!

The initiative behind TTI was to rethink the notion of object based from the CABIN principle (http://le-code-vulgarise.blogspot.fr/2014/01/principe-cabin-pour-la-construction-d.html). We truly believe a true object is only an interface, implemented by an abstracted shape you can concretely use. That's all! That means, a concrete class that doesn't have a contract with an abstract class and an interface, can't be considered as real object, but rather as a trait, or "lost son", or anything else, but not as object.

Based from this notion, we developed two powerfull collection of generic classes that is a standard base for true objects, and, that can be used in any of your projects to fully respect SOLID and GRASP principles.

"InterfaceFactory" and "AbstractFactory" collection of classes, are the heart of The Troll Inception solution. AbstractFactory is a collection of abstracted classes that have very single responsibilities implemented by specifics and generic interfaces grouped in the InterfaceFactory.

Together, they offer powerfull possibilities and constraints for better closed development practices in your applications development.

Coupled with the CSS principle (http://le-code-vulgarise.blogspot.fr/2014/01/what-is-css-principle.html) and the Objective Reality (http://le-code-vulgarise.blogspot.fr/2014/01/what-is-objective-reality-design-pattern.html), TTI offers you a new generation of framework that can involve agile development.

What is Objective Reality design pattern?

Objective Reality is the fact of coding real and funny situations, in an objective and professional goal. It is a design pattern based over the CSS (Code Similar Situations) principle, that has also been thought by Edouard Kombo.

With Objective Reality design pattern, you begin playing with fun rules. You play to win somthing, earn a reward. This reward can litteraly improve agile development by estimating more easily the technical debt, your project will create.

More explanations and examples here: http://le-code-vulgarise.blogspot.fr/2014/01/what-is-objective-reality-design-pattern.html

What is CSS Principle?

It is extremely important not to confuse the CSS (Cascading Style Sheet) language, with CSS (Code Similar Situations) principle. The theory is, if we can connect the code and the developer by its creativity, then we will no more learn, we will start playing with the code forever.

WHY DO CSS PRINCIPLE USEFUL? Because it is hard in very short development process to understand how to apply all necessary design patterns. Because it is hard to fully capture in seconds, a complex code from someone else, or even from ourself, some weeks or months later. Because too much complex code doesn't connect you with your passion, and makes you code bad. Because it is hard for beginners and more experienced developers to intuitively appropriate themselves an architecture. Because it is funnier to code something you can play with, and that will be easier for others, to intuitively understand and play with it too.

WHAT DO CSS PRINCIPLE RECOMMEND? It recommends to URA (Understand, retain, apply) something, by inspiring yourself from a similar situation we've already seen or lived in real life (story telling, concrete experience, game, cartoon, movie...).

HOW DO CSS PRINCIPLE SOLVE THOSE PROBLEMS? Instead of simply coding instructions and objects, when you play with them, then you emotionnaly connect with your application and your job gets funnier, more pleasant and intuitively accessible by other developpers.

More explanations here: http://le-code-vulgarise.blogspot.fr/2014/01/what-is-css-principle.html.

The Troll Inception STORY (CSS and Objective Reality implementation)

You play Roar, a troll cave, lost in the Breeze forest by his stupidity. To survive, he has to conquer and dominate this forest. Roar has several tools at its disposal, like a torch, a map, an eagle that will guide him to the best routes he can teleport to, via the magical portal, an ancestral passort, and an architect that help him build each territory it conquers. The goal is to reach all routes and respond to affirm your territory. When Roar responds, he may beat the asian spirit of the forest, "Foucking Law". Foucking Law has one powerful wild beast, CodeCeption, which will test Roar as many times possible, like a ghost. Everytime Roar responds successfully to Foucking Law, he wins 5 Chicken points.

These points will help you estimate more precisely the technical debt a project will introduce.

How do this concretely apply? You start to play with objective reality in the heart of your application, just by renaming variables as living objects or characters of the story telling. This way, all the application you are designing, is easily printable in your subconscious mind. You are playing with it, and it is now easier for other developers to play with it too.

ILN file extension

ILN is the acronym of "Intuitive Language Notation" and, is a language used for object configuration. It is similar as YAML but less advanced.

More explanations here: http://le-code-vulgarise.blogspot.fr/2014/01/iln-intuitive-language-notation.html.

Installing the Troll Inception

When it comes to installing the Troll Inception, you have the following options.

Use Composer (recommended)

As The Troll Inception uses [Composer][2] to manage its dependencies, the recommended way to create a new project is to use it.

If you don't have Composer yet, download it following the instructions on http://getcomposer.org/ or just run the following command:

curl -s http://getcomposer.org/installer | php

Then, use the create-project command to generate a new TTI application:

php composer.phar create-project edouardkombo/the-troll-inception=dev-master path/to/install

Composer will install TTI and all its dependencies under the path/to/install directory.

Download an Archive File

To quickly test TTI, you can also download an [archive][3] and unpack it somewhere under your web server root directory.

The archive comes without vendors. To download them, first download composer (see above) and run the following command:

php composer.phar install

Browsing the Demo Application

Congratulations! You're now ready to use The Troll Inception.

To see a real-live TTI page in action, access the following page:

http://localhost

Getting started with TTI

This distribution is meant to be the starting point for your TTI applications, but it also contains some sample code that you can learn from and play with.

We will provide soon a nice and complete documentation. But you can already play with it and reads the api.

To access to the api, simply go to:

http://www.breezeframework/tti/sandbox

What's inside?

The Troll Inception is configured with the following defaults:

Aura Router;
Interface Factory;
Abstract factory;
Parser Strategy for ILN (Intuitive Language Notation) files.
Http Strategy;
Dependency Strategy;
Event Strategy;
Cache and Db Utils;

The Troll Inception also includes some useful dependencies to help you code better:

CodeCeption as unit testing framework;
PhpMd;
Php-CodeSniffer;
Php-loc;
Twig;
Php_error

All libraries and bundles included in the Troll Inception are released under the MIT or BSD license.

Enjoy!

edouardkombo / the-troll-inception

Maintainers

Details

README

Use Composer (recommended)

Download an Archive File

What's inside?