README

Qualité

Contribution

Lancer les tests

make test-unit

Analyser le coding style

make test-cs

Comment contribuer ?

Prérequis

Symfony >= 3.4.0, < 4.0.0
PHP >= 7.0.0

Installation

Etape 1: Télécharger le bundle

Ouvirr le terminal, entrer dans le répertoire du projet et éxécuter ces commandes pour télécharger la dernière version stable de ce bundle:

$ composer require darkilliant/import

Cette comamnde requis d'avoir le composer d'installer globalement, ceci est expliquer dans le chapitre d'installation de la documentation du composer.

Etape 2: Activer le Bundle

Puis, activer le bundle en l'ajoutant dans la liste du fichier app/AppKernel.php

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Darkilliant\ProcessBundle\DarkilliantProcessBundle(),
            new Darkilliant\ImportBundle\DarkilliantImportBundle(),
            new Darkilliant\MqProcessBundle\DarkilliantMqProcessBundle(), // Ony when use message queueing for scale
        );

        // ...
    }

    // ...
}

Releasing

Version semver (majeure.mineur.bugfix)
De nouvelles fonctionalitées tous les 3 mois (0.1, 0.2, 0.3, 0.4, 1.1, 1.2, 1.3, ...)
Une version majeure tous les ans (même quand il n'y à pas changement majeur mais permettant de supprimer le BC)
Nous assurons la compatibilité descendante
Pas plus de deux version en cours maintenu pour les fix (version stable et version en cours de dev)

BC Break

Considèrer comme du cassage de compatiblité,

Changement de signature de méthode public, sauf si mis en @internal au niveau de la méthode ou de la classe
Suppression de méthode public, sauf si mis en @internal au niveau de la méthode ou de la classe
Suppression de propriété public
Suppression d'option dans un transformer ou une step
Ajout d'option sans default dans un transformer ou une step
Changement du comportement d'un transformer ou d'une step avec une même configuration

Qu'est-ce qu'on protège globalement par le contrat de retro-compatiblité ?

Le comportements des step, transformer ne doit pas changé avec une même configuration
Le fonctionnement du StepRunner avec une même configuration
Les méthodes publlques du ProcessState
Les méthodes publiques des steps et du step runner

Roadmap

Version	Date de publication	Date de fin de maintenance	BC ?
0.2	Juin 2018	Juillet 2018	NON
0.3	Juillet 2018	Octobre 2018	NON
0.4	Octobre 2018	Janvier 2019	NON
1.1	Janvier 2019	Avril 2019	OUI
1.2	Avril 2019	Juillet 2019	NON
1.3	Juillet 2019	Octobre 2019	NON
1.4	Octobre 2019	Janvier 2020	NON
2.1	Janvier 2020	Avril 2020	OUI

Usage

Règles,

Vous utilisez donc vous contribuer à la documentation et aux bugfix. raller c'est bien mais agir c'est mieu.
Toujours travailler sur une version stable, une version en cours de développement n'est pas conseillé.

Cookbook,

darkilliant / import

Maintainers

Details