darkilliant/import

import

ImportBundle

Qualité

, _(*1)

, _(*2)

, _(*3)

Contribution

Lancer les tests

make test-unit

Analyser le coding style

make test-cs

Comment contribuer ?

Comment contribuer ?, _(*4)

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:, _(*5)

$ 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., _(*6)

Etape 2: Activer le Bundle

Puis, activer le bundle en l'ajoutant dans la liste du fichier app/AppKernel.php, _(*7)

<?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, _(*8)

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, _(*9)

Roadmap

• 0.3
• 0.4

Usage

Règles,, _(*10)

• 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, - Lisez ceci avant tout - Example, pas à pas de création d'un import. - Liste des transformers disponible - Liste des micro-tâches disponible - Comment utiliser des options dynamique ? - Affiche une barre de progression - Liste des filtres disponible - Comment lancer un traitement ? - Comment lister les traitements disponible ? - Comment trouver les goulots d'étranglement ? - Comment limiter le temps d'éxécution d'un tâche itérable ? - Comment écouter tout le cycle de vie d'un traitement ?, _(*11)