Vincent Mazenod, aka mazenovi, aka voisin de gennetines » dev

PropelUtility : maintenir et exporter un schéma Propel avec MySQLWorkbench

mazenovi — Thu, 20 Oct 2011 12:33:28 +0000

J’ai toujours aimé les solutions graphiques pour le design du modèle des applications PHP que je développe. Que ce soit avec DBDesigner pour symfony 1.0, ou avec MySQLWorkbench pour symfony > 1.2 .

Etant maintenant fixé sur l’ORM Propel j’ai pris le parti de développer un outil permettant de gérer l’intégralité des paramètres du schéma Propel avec précision et de les exporter au format xml: PropelUtility

PropelUtility s’appuie sur l’outil de modélisation graphique MySQLWorkbench et lui ajoute simplement une interface de gestion et d’export de tous les paramètres propres à Propel.

PropelUtility est pérenne puisque MySQLWorkbench est maintenu par l’équipe MySQL elle même (DBDesigner est déprécié) et qu’il sera compatible Propel 2 !

J’ajoute que c’est mon premier projet Python … Alors n’hésitez pas à me conseiller si vous êtes un habitué: je ne demande qu’à améliorer PropelUtility

qu’est ce que PropelUtility ?

PropelUtility permet de concevoir et d’exporter au format xml un schéma Propel à partir d’un schéma MySQLWorkbench existant (fichier *.mwb)
PropelUtility permet de gérer tous les éléments de schéma propres à Propel non gérés par MySQLWorkbench
PropelUtility est livré sous forme d’un plugin MySQLWorkbench écrit en Python. En cela il marche sous Windows, Linux et Mac OS

Ce que PropelUtility n’est pas …

PropelUtility ne permet pas de modifier les informations du schéma modifiables avec MySQLWorkbench
PropelUtility ne prévoit aucune conversion ou sortie en YAML (vous pouvez par exemple utiliser la commande symfony propel:schema-to-yml)

PropelUtility

Installation

via la ligne de commande

git clone git://github.com/mazenovi/PropelUtility.git

ou dézippez l’archive téléchargée à partir de la page github de PropelUtility

EDIT!!

Cette partie de l’installation a été simplifiée par une version en un seul fichier

La version en plusieurs fichiers est maintenue sous le nom de PropelUtilityDev pour faciliter les contributions

Copiez ensuite la totalité du projet (i.e. propel_utility_grt.py ainsi que le dossier PropelUtility et son contenu) dans l’un des répertoires « modules » de MySQLWorkbench.

Ce peut être un répertoire de l’installation de MySQLWorkbench, c’est à dire quelque chose comme:

C:\Program Files\mysql-workbench\modules
ou /usr/lib/mysql-workbench/modules sous linux

ou mieux un répertoire de l’utilisateur, typiquement:

C:\Users\username\AppData\Roaming\MySQL\Workbench\modules
/home/username/.mysql/workbench/modules sous linux

Une fois copié …

allez dans « Scripting » -> « Install Plugin / Module … » naviguer jusqu’à l’emplacement du fichier propel_utility_grt.py ~~qui vient d’être copié~~ dézippé ou gité, sélectionnez le, puis redémarrez MySQLWorkbench.

PropelUtility ajoute deux nouvelles entrées à MySQLWorkbench dans « Plugins » -> « Catalog » :

« Propel Utility »
« Propel Erase All Data »

N.B. ce n’est pas exactement la procédure préconsiée par MySQLWorkbench pour l’installation d’un plugin. Le fait que PropelUtility soit découpé en plusieurs fichiers oblige à copier l’arborescence du projet dans le répertoire « modules » manuellement avant l’installation dans MySQLWrokbench.

utilisation

Toutes les modifications effectuées sur les informations Propel avec PropelUtility ne seront validées qu’après un clique sur le bouton OK.
En cas de clique sur CANCEL, les modifications seront perdues.
Pour enregistrer définitivement les modifications des informations Propel il ne faut pas oublier d’enregistrer le document .mwb lui même

Il y a trois types de champs:

Les champs non modifiables : ils ont un caractère informatif et peuvent être modifiés directement via MySQLWorkbench, mais pas via PropelUtility
Les champs modifiables : en cliquant une fois sur l’un de ses champs il est possible de modifier sa valeur par une saisie clavier
Les champs modifiables avec liste de choix : non seulement en cliquant une fois sur l’un de ses champs il est possible de modifier sa valeur par une saisie clavier, mais il est également possible de faire apparaitre une liste de choix en double cliquant. Il suffit alors de choisir une valeur et ensuite de cliquer sur le bouton « select this value ».

N.B. Les listes de choix ne sont pas disponibles sous linux. (l’objet mforms.TreeView permettant de gérer des tableaux ne supportent pas nativement les listes de choix et l’astuce permettant de les déclencher au double clique semblent ne fonctionner que sous Windows :/)

onglets

Database permet de gérer les attributs de la balise xml

Tables permet de gérer les attributs de la balise xml

Columns permet de gérer les attributs de la balise xml

Foreign Keys permet de gérer les attributs de la balise xml

Indices permet de gérer les attributs des balises xml et

Behaviors permet de gérer les Behaviors associés chaque table (balsie ) ainsi que leurs paramètres (balise )

Export permet d’exporter les données manipulées via les onglets sus-citées selon la logique suivante: les attributs obligatoires sont systématiquement exportés, alors que seuls les attributs optionnels possédant une valeur différente de leur valeur par défaut le sont.

personnalisation

Vous pouvez choisir les champs affichés, ou modifier l’ordre d’affichage, ou encore modifier la taille des colonnes des champs pour chaque onglet en allant modifier la liste « fields_list » de la classe associée à l’onglet (PropelTabDatabase.py pour l’onglet Database par exemple)
De la même manière il est possible d’ajouter ses propres behaviors en complétant les listes PropelBehavior.behaviors et PropelBehavior.fields['name']['items']

Propel Erase all data

Cette entrée permet de réintialiser toutes les données Propel gérées par PropelUtility et seulement celles ci (les informations géres par MySQLWOrkbench ne seront pas affectées)

TODO

ajouter une possibilité d’export individuel pour chaque indice ( ou )
ajouter le support pour la « single inheritance »
ajouter un onglet « Settings » pour chosir les colonnes à afficher dans chaque onglet
~~ajouter un onglet « Import » pour créer un schéma MySQLWorkbench (fichier *.mwb) à partir d’un schema.xml Propel existant~~ inutile avec les fonctionnalités d’importation d’un schéma de base de données à partir d’un base MySQL existante

capifony sous windows pour déploiement automatisé sous ispcp

mazenovi — Wed, 13 Apr 2011 11:35:57 +0000

En premier lieu il vous faudra disposer d’un cygwin (éventuellement portable ) sur votre machine, avec le package ruby (1.8) installé.

installer rubyGem est assez simple

télécharger le tarball RubyGems à partir Ruby Forge

wget <a href="http://rubyforge.org/projects/rubygems/">http://rubyforge.org/frs/download.php/74445/rubygems-1.6.2.tgz a>

à remplacer par le numéro de la version courant bien entendu
décompresser le tarball
tar -xvf rubygems-1.6.2.tgz
naviguer jusqu’à l’archive décompressée
cd rubygems-*
exécuter cette commande pour installer RubyGem
ruby setup.rb install
Et celle ci pour mettre à jour
gem update --system

Capifony s’installe donc maintenant simplement via la commande gem qui va gérer les dépendances et donc installer automatiquement Capistrano. Il suffit d’exécuter la commande

sudo gem install capifony

il est tant de configurer la capifonycation de notre projet, donc après avoir navigué jusqu’à la racine du projet exécuter la commande:

capifony .

qui crée un fichier Capfile à la racine du projet et un fichier deploy.rb dans le répertoire config du projet. voici le mien agrémenté de quelques commentaires

set :application, "myapp.org"
set :domain, "mygit.org"
set :deploy_to, "/var/www/virtual/myapp.org"

set :shared_children, %w(log htdocs/uploads) #par défaut ispcp alias le répertoire htdocs (et non web)
set :use_sudo, true #obligatoire pour l'hébergement ispcp car le user de déploiement n'a pas à priori les droits d'écriture sur le répertoire associé au domaine ou sous domaine
set :group_writable, false

set :git_enable_submodules, 1

set :repository, "git://git.cerdi.org/registration/health_registration.git"
set :scm, :git

role :web, domain # Your HTTP server, Apache/etc
role :app, domain # This may be the same as your `Web` server
role :db, domain, :primary => true # This is where Rails migrations will run

set :keep_releases, 3

ssh_options[:forward_agent] = true

Je précise également que l’utilisateur est authentifié par clé RSA. Ce qui m’évite de saisir

Attendu que l’utilisateur utilisé (authentifié par clé RSA) pour le déploiement n’est pas l’utilisateur qui possède les répertoires, j’ai opté pour un utilisateur sudoer, seulement l’option use_sudo n’a pas suffit et j’ai du reprendre les commandes suivantes, à la suite de deploy.rb, en partant du code trouver /usr/lib/ruby/gems/1.8/gems/capifony-0.4.3/lib/capifony.rb (première fois que je voyais du ruby -_-’).

namespace :deploy do

task :setup, :except => { :no_release => true } do
dirs = [deploy_to, releases_path, shared_path]
dirs += shared_children.map { |d| File.join(shared_path, d) }
run "#{try_sudo} mkdir -p #{dirs.join(' ')} && #{try_sudo} chmod g+w #{dirs.join(' ')}"
#add for case where deploy user is not owner
dirs = [releases_path, shared_path]
run "#{try_sudo} chown -R #{user_deploy}:#{group_deploy} #{dirs.join(' ')}"
end

task :symlink, :except => { :no_release => true } do
on_rollback do
if previous_release
run "#{try_sudo} rm -f #{current_path}; #{try_sudo} ln -s #{previous_release} #{current_path}; true"
else
logger.important "no previous release to rollback to, rollback of symlink skipped"
end
end
run "#{try_sudo} rm -f #{current_path} && #{try_sudo} ln -s #{latest_release} #{current_path}"
end

task :start do
run "[ -d #{deploy_to}/htdocs ] && #{try_sudo} rm -rf #{deploy_to}/htdocs || true"
run "[ ! -f #{deploy_to}/htdocs ] && #{try_sudo} ln -s #{current_path}/htdocs #{deploy_to}/htdocs || true"
run "[ ! -f #{deploy_to}/symfony ] && #{try_sudo} ln -s #{current_path}/symfony #{deploy_to}/symfony || true"
dirs = [releases_path, shared_path]
run "#{try_sudo} chown -R #{user_deploy}:#{group_deploy} #{dirs.join(' ')}"
run "#{try_sudo} chmod -R g+w #{dirs.join(' ')}"
run "#{try_sudo} chown -h #{user_deploy}:#{group_deploy} #{current_path} #{deploy_to}/htdocs"
end

task :share_childs do
if shared_children
shared_children.each do |link|
run "mkdir -p #{shared_path}/#{link}"
run "#{try_sudo} chmod -R g+w #{shared_path}/#{link}"
run "if [ -d #{release_path}/#{link} ] ; then rm -rf #{release_path}/#{link}; fi"
run "ln -nfs #{shared_path}/#{link} #{release_path}/#{link}"
end
end

if shared_files
shared_files.each do |link|
link_dir = File.dirname("#{shared_path}/#{link}")
run "mkdir -p #{link_dir}"
run "#{try_sudo} chmod -R g+w #{link_dir}"
run "touch #{shared_path}/#{link}"
run "ln -nfs #{shared_path}/#{link} #{release_path}/#{link}"
end
end
end
end

Si ce n’est pas déjà fait, faites gérer votre projet par git

git init

pour ne faire gérer que le nécessaire par git éditer .gitignore

web/sf*
web/uploads/*
cache/*
plugins/.*
log/*
config/databases.yml
mkmf.log
.rsync*
backups/*

pour intégrer symfony en tant que librairie externe il vous faudra supprimer le répertoire lib/vendor/symfony s’il existe ou crééer lib/vendor s’il n’existe pas

mkdir -p lib/vendor

ensuite il suffit de déclarer la librairie symfony comme un sous modules au niveau de git, et faire de même pour tous les plugins qui sont verisonnés avec git

git submodule add http://github.com/vjousse/symfony-1.4.git lib/vendor/symfony
git submodule add https://github.com/rande/swFunctionalTestGenerationPlugin.git plugins/swFunctionalTestGenerationPlugin

ce qui a pour conséquence de créer un fichier .gitmodules contenant

[submodule "lib/vendor/symfony"]
path = lib/vendor/symfony
url = http://github.com/vjousse/symfony-1.4.git
[submodule "plugins/swFunctionalTestGenerationPlugin"]
path = plugins/swFunctionalTestGenerationPlugin
url = https://github.com/rande/swFunctionalTestGenerationPlugin.git

il s’agit ensuite de committer le projet , sur un serveur distant

git add .
git commit -a -m 'commit entire project' #commit en local
git remote add origin git@git.cerdi.org:registration/health_registration.git #défini un serveur git distant
git push origin master #répercutre le modifs sur le serveur git distant

maintenant que notre projet est gité avec ces sous modules, il ne reste qu’à

lancer la commande suivante pour finir de configurer le déploiement

cap deploy:setup

lancer la commande suivante pour le premier déploiement

cap deploy:cold

lancer la commande suivante pour les suivants

cap deploy:start

forcer l’utilisation de ssl sur un sous domaine avec ispcp

mazenovi — Mon, 28 Mar 2011 12:11:56 +0000

Tout d’abord il faut activer ssl sur votre serveur et générer vos certificats ssl (à moins que vous en ayez déjà).

Le how to officiel d’ispcp How to: SSL made easy est très bien fait et vous apprendra en premier lieu comment sécuriser votre control panel.

Ayant un peu plus cherché pour mettre la même chose en place avec un sous domaine géré par ispcp, je me permets de relayer la solution (en allemand) que j’ai trouvé dans un forum.

le but est de créer un virtual host sub.domain.tld accessible en ssl (sachant que le virtual host est simplement créé avec ispcp)

il faut d’abord créer vhost en écoute sur le port 443 en éditant

sudo vi /etc/apache2/site-available/sub-ssl

et en y ajoutant

activer le virtual host

sudo a2ensite sub-ssl

et recharger la configuration d’apache

sudo /etc/init.d/apache2 reload

reste à interdire l’utilisation du http non sécurisé, ce qui revient à forcer le https via un règle de rewriting qui peut par exemple être mise dans un .htaccess à la racine du sous domaine

vi /var/www/virtual/domain.tld/sub/htdocs/.htaccess

et ajouter quelque chose du genre

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ https://sub.domain.tld/$1 [R,L]
IfModule&gt>

postgreSQL & xampp portable sous windows

mazenovi — Wed, 23 Mar 2011 18:09:41 +0000

Tout est dans le titre je crois. Je suis parti de ce billet http://notepad.patheticcockroach.com/628/adding-postgresql-portable-to-xampp-on-windows/et je vous livre ce qui a fonctionné pour moi. J’ai déjà expliqué sur ce blog comment installer une plateforme xampp portable sous windows.

Le prérequis est donc d’en avoir une fonctionnelle pour la suite

Tout d’abord il vous faudra une version portable de postrgre, que vous trouverez sur http://www.postgresql.org/download/windows. En tant qu’« Advanced user » vous téléchagerez l’ archive zip sans l’installeur (la version portable quoi). J’ai opté pour la 9.0.3-1 qui semble être la stable du moment.

Une fois l’archive décompressée, copier / coller le répertoire pgsql qu’elle contient dans Z:/MyApps/xampp/.

La première des choses à faire est ensuite de créer un cluster en tapant

Z:\MyApps\xampp\pgsql\bin\initdb.exe -D ..\data

Les fichiers de ce cluster appartiendront à l'utilisateur « mazenovi».
Le processus serveur doit également lui appartenir.

Le cluster sera initialisé avec la locale French_France.1252.
L'encodage par défaut des bases de données a été configuré en conséquence
avec WIN1252.
La configuration de la recherche plein texte a été initialisée à « french ».

correction des droits sur le répertoire existant ../data... ok
création des sous-répertoires... ok
sélection de la valeur par défaut de max_connections... 100
sélection des valeurs par défaut de shared_buffers/max_fsm_pages... 32MB/204800
création des fichiers de configuration... ok
création de la base de données template1 dans ../data/base/1... ok
initialisation de pg_authid... ok
initialisation des dépendances... ok
création des vues système... ok
chargement de la description des objets système... ok
création des conversions... ok
création des dictionnaires... ok
initialisation des droits sur les objets internes... ok
création du schéma d'informations... ok
lancement du vacuum sur la base de données template1... ok
copie de template1 vers template0... ok
copie de template1 vers postgres... ok

ATTENTION : active l'authentification « trust » pour les connexions
locales.
Vous pouvez modifier ceci en éditant pg_hba.conf ou en utilisant l'option -A
au prochain lancement d'initdb.

Succès. Vous pouvez maintenant lancer le serveur de bases de données par :

"postgres" -D "../data"
ou
"pg_ctl" -D "../data" -l journal_applicatif start

N.B. le cluster appartient à l’utilisateur système avec lequel il est créé c’est important pour la suite!

pour lancer le serveur

cd Z:\MyApps\xampp\pgsql\bin

"pg_ctl" -D "../data" -l journal_applicatif start

vous pouvez déjà jouer avec pgAdmin3 en entrant l’adresse de votre serveur (127.0.01 ou localhost) et le login mot de passe de l’utilisateur que vous avez utilisez pour créer le cluster. Mais il s’agit ici de faire fonctionner postgreSQL avec php. On va donc décommenter deux extensions dans le Z:\MyApps\xampp\php\php.ini

; php driver to use postgreSQL databases
extension=php_pgsql.dll
; abstraction layer for PDO
extension=php_pdo_pgsql.dll

Mais là vous risquez d’être victime de message d’erreur car PostgreSQl a besoin de quelques dll pour fonctionner sous windows. Afin de garder l’installation portable il faut ajouter \MyApps\xampp\pgsql\bin au path, car ce répertoire contient les dll nécessaires (et évite du coup d’avoir à les copier dans c:\windows\system32).

Afin de tester que postgreSQL fonctionne bien avec php je vous propose d’installer phpPgAdmin en le téléchargeant sur le site officiel http://phppgadmin.sourceforge.net/ puis en le décompressant dans Z:/MyApps/xampp/phpPgAdmin/

Afin de le rendre visible ajouter dans Z:\MyApps\xampp\apache\conf\extra\httpd-xampp.conf

Alias /phppgadmin "Z:/MyApps/xampp/phpPgAdmin/"

<Directory "Z:/MyApps/xampp/phpPgAdmin">
AllowOverride AuthConfig
</Directory>

et modifier

éditer également selon vos besoins le fichier de configuration de phpPgAdmin Z:\MyApps\xampp\phpPgAdmin\conf\config.inc.php

ouvrez maintenant http://localhost/phppgadmin dans votre navigateur et saisissez les login mot de passe de l’utilisateur associé au cluster

A vous postgreSQL

activer la couleur pour la commande symfony dans un bash cygwin portable

mazenovi — Fri, 18 Mar 2011 10:24:47 +0000

symfony en couleur

Les utilisateurs windows ont longtemps été privés des couleurs qu’affichent la sortie de la commande symfony. Mais depuis symfony 1.3/1.4 les choses se sont beaucoup améliorées.

C’est le jour où j’ai voulu tester les tests, que le besoin de couleur c’est vraiment fait ressentir: j’ai d’abord perdu pas mal de temps à essayer d’activer ansi.sys sur mon windows 7 …

sans succés!

La solution je l’ai trouvé chez Jonathan Nieto : Colorize your Windows console life with symfony (et aussi grâce à @couac) et elle s’appelle ANSICON il suffit donc de

télécharger le zip
dézipper
copier / coller les fichiers ansi.dll et ansicon.exe dans c:\windows \system32
taper ansicon -i dans un prompt de commande

N.B. vous devez rouvrir une autre fenêtre MS-DOS pour que la couleur soit

N.B2. si comme moi vous disposez d’un environnement de développement portable xampp ou UwAmp, cette manipulation est à faire sur chacun des postes que vous utilisez.

Ca marche aussi bien dans une bête commande MS-DOS que dans un cygwin, sans avoir à utiliser l’option –force de la commande symfony, du coup j’ai tenté

cygwin portable

J’avais déjà joué un peu à modifier le path au lancement de la console, lors de l’installation portable de Git afin de changer éventuellement d’intrerpréteur en ligne de commande PHP lors d’une même session par exemple. Mais ayant un bout de commande cwrsync par là, un bout d’install git par ailleurs, je me suis itéressé à cygwin et à son potentiel portable, afin de tout unifier.

J’ai en fait installé cygwin sur mon disque dur usb (dans z:\MyApps\cygwin), mais la démarche est la même en partant d’un cygwin portable (pas super à jour :/) comme l’explique ce post
J’ai ensuite créé un home dir dans z:\MyApps\cygwin\home\mazenovi qui me permet de rendre mes préférences (.ssh, .bashrc) portables elles aussi.
Enfin j’ai simplement modifié le batch de lancement Cygwin.bat en CygwinPortable.bat comme suit

@echo off

chdir \MyApps\Cygwin\bin
set path=%WD%\cygwin\bin;%WD%\cygwin\usr\X11R6\bin;\MyApps\xampp\php;\MyApps\xampp\mysql\bin;%path%
set SHELL=/bin/bash
set HOME=/home/mazenovi
set DISPLAY=:0
bash --login -i

L’idée est simplement d’enlever les lettres de lecteur pour avoir des path partant de la racine de la clé, et de rajouter quelques variables d’environnement (ici le path vers le php et le mysql de mon installation xampp portable). Une fois fait il suffit d’installer les commandes dont vous avez besoin (git et rsync dans mon cas) via cygwin en relançant le setup.exe (si vous êtes partis de la version portable de cycgwin n’oubliez pas de remplacer cygwinsetup.exe par un setup.exe à jour).

Pour finir j’ai ensuite créé un onglet dans console2 une petite console libre, permettant entre autre d’utiliser la font consolas et de gérer la transparence de votre ligne de commande

de quoi réconcilier les windoziens avec la ligne de commande :p

Sale Geek kro$oft!

Vous me traiterez sans doute de sale bricolo car j’utilise des installations Apache MySQL PHP windows (xampp ou UwAmp) à l’intèrieur d’un Cygwin qui est un pseudo Unix. Ce à quoi je répondrai, « c’est vrai! c’est un mélange des genres! », mais grâce à UwAmp par exemple, je peux utiliser des versions de PHP différentes simplement en ouvrant un nouvel onglet dans ma console …

Et puis j’ai déjà vu des système Unix like (à base de BSD par exemple) largement aussi fermé qu’un windows

Git portable & Console2 sous windows

mazenovi — Thu, 10 Feb 2011 18:18:43 +0000

Git est un système de gestion de versions qui s’est répandu dans le monde du développement comme une traînée de poudre il y a quelques temps; surtout depuis que plusieurs projets majeurs, dont Symfony 2 sont passés de svn à git.

Le propos de cet article est d’installer git de manière portable et intégrée à Console 2 qui est mon prompt de commande préféré, et de voir les quelques commandes de bases

Installation

msysgit propose une version portable de git. Une fois décompressée dans votre suite d’applications portables préférées, vous pouvez avoir accès à Git en ligne de commande en lançant git-cmd.bat ou mieux git-bash.cmd, qui vous donne accès à un bash UNIX minimal (c’est à dire limité à quelques commandes) dans votre windows

Il n’y a absolument rien de sorcier là dedans, mais notez tout de même que pour changer de répertoire vous ne devez utiliser que des / et non pas des \, et faire référence à la lettre du lecteur de disque comme suit

$ cd /c/Users/mazenovi/Desktop

C’est un peu comme du cygwin, mais visiblement ça n’en est pas!

Console2

Ce qui est sympa c’est d’intégrer l’environnement ligne de commande Git en tant qu’onglet de Console2.

Console2 est un prompt de commande souple, personnalisable (police, couleur, transparence, etc …) et complètement portable.

Vous pouvez ajouter des onglets prédéfinis dans « Edit » -> « Settings »

Vous devez spécifier le chemin vers le batch permettant d’accéder à git en ligne de comande (git-bash.bat).

Vous pouvez également spécifier un répertoire par défaut dans lequel sera positionné votre prompt.

Il suffit ensuite de bien penser à mettre des paths relatifs ou absolus, mais dans ce dernier cas sans spécifier la lettre du lecteur pour que la configuration reste elle aussi portable.

Ensuite le git-bash peut se lancer dans Console2 en ouvrant un nouvel onglet

Notez bien que nous n’avons pas touché aux variables d’environnement du système, et que pour autant la commande git est accessible de partout … le path système est en fait modifié directement par le script git-bash.bat

Test sur github

github est un site d’hébergement et de gestion de développement de logiciels utilisant git et choisi par beaucoup de projets open source.

Avec git-bash

générer et configurer une clé RSA

Dans un onglet git bash (que vous venez de créer) tapez

$ ssh-keygen -t rsa

Laissez tous les choix par défaut (appuyez deux fois sur entrée)

Vous obtenez deux fichiers (mazenovi est bien sûr à remplacer par votre nom d’utilisateur) :

/c/Users/mazenovi/.ssh/id_rsa

est votre clé privée, et elle est au bon endroit et

/c/Users/mazenovi/.ssh/id_rsa.pub

est votre clé publique que vous devez saisir dans la section Account settings -> SSH Public Keys.

Vous pouvez ensuite configurer votre nom & mail (à remplacer par les votre)

git config --global user.name "mazenovi"

git config --global user.email vmazenod@mail.com

de manière générale la conf de git est stockée dans

/c/Users/mazenovi/.gitconfig

Tout est alors prêt pour créer votre …

Premier repository

il vous faudra tout d’abord créer un nouveau dépôt (« ckMedia » dans mon cas) sur github

créer le dépôt sur votre machine local, qui n’est rien de plus qu’un répertoire géré par git, en tapant toujours dans l’onglet onglet git bash

mkdir ckMedia

cd ckMedia

le faire gérer par git

git init

le modifier (créer un simple fichier vide README par exemple)

touch README

ne plus faire gérer un fichier par git (les modifications apportées au fichier ne sont plus prises en compte par git)

git rm README

annuler les modifications (revenir à la denière verison)

git checkout

ajouter la modification au prochain commit (prochaine mise à jour du repostory sur github)

git add README

supprimer le fichier du prochain commit

git reset README

faire un commit (valider les changements sur le repository local)

git commit -m 'first commit'

N.B. le commentaire est obligatoire, si vous oubliez l’option -m l’éditeur de texte par défaut est lancé

Pour faire un commit sur tous les fichiers modifiés et gérés par git vous pouvez utiliser l’option -a. Les fichiers supprimés dans le projet seront supprimés (git rm) du dépôt

git commit -a -m 'update all my changes'

Pour faire afficher ce qui est à « commiter », c’est à dire ce qui a déjà fait l’objet d’un add, et ce qui a été simplement modifié, c’est à dire qui est géré mais n’a pas fait l’objet d’un add:

git status

on appelle cet état transitoire entre le moment où le fichier est modifié et le commit le stage

Les schéma suivant résume les commandes que nous venons de voir

ajouter un raccourcis vers l’URL du dépot github. On le nomme ici origin

git remote add origin git@github.com:mazenovi/ckMedia.git

répercuter les changements sur le dépot cible

git push origin master

pour lister tous les commit

git log

Pour la petite histoire

Le magazine PC World nous apprend que « quand on lui a demandé pourquoi il avait appelé son logiciel « git », qui est à peu près l’équivalent de « connard » en argot anglais, Linus Torvalds a répondu « je ne suis qu’un égocentrique, donc j’appelle tous mes projets d’après ma propre personne. D’abord Linux, puis Git. »

source : http://fr.wikipedia.org/wiki/Git

compélément

pour plus de détails http://gitref.org/
pour me trouver sur git http://github.com/mazenovi
Git staging area http://www.gitready.com/beginner/2009/01/18/the-staging-area.html
un petit guide en français: http://www.unixgarden.com/index.php/administration-systeme/git-it
une documentation un peu plus exhaustive en français : http://www.alexgirard.com/git-book/
un tuto en anglais: http://gitimmersion.com

Les vikings & l’agilité

mazenovi — Mon, 13 Sep 2010 18:36:23 +0000

A ma gauche les « vikings laws », à ma droite le manifeste agile.

A ma gauche les règles de vie millénaires d’un peuple de conquérants et d’excellents commerçants, à ma droite les principes des méthodes de gestion de projets les plus récentes.

Viking laws	Manifesto for Agile Software Development
Be brave and aggressive Be direct Grab all opportunities Attack one target at a time Don’t plan everything in detail Be versatile and agile Use varying methods of attack Use top quality weapons	The most efficient and effective method of conveying information to and within a development team is face-to-face conversation Simplicity–the art of maximizing the amount of work not done–is essential Welcome changing requirements, even late in development. Agile processes harness change for the customer’s competitive advantage
Be prepared Keep weapons in good condition Keep in shape Find good battle comrades Agree on important points Choose one chief	Continuous attention to technical excellence and good design enhances agility Agile processes promote sustainable development The sponsors, developers, and users should be able to maintain a constant pace indefinitely Build projects around motivated individuals Give them the environment and support they need, and trust them to get the job done
Be a good merchant Find out what the market needs Don’t promise what you can’t keep Don’t demand overpayment Arrange things so that you can return	Business people and developers must work together daily throughout the project Our highest priority is to satisfy the customerthrough early and continuous delivery of valuable software Deliver working software frequently, from a couple of weeks to a couple of months, with a preference to the shorter timescale Working software is the primary measure of progress.
Keep the camp in order Keep things tidy and organised Arrange enjoyable activities which strengthen the group Make sure everybody does useful work Consult all members of the group for advice	Continuous attention to technical excellence and good design enhances agility At regular intervals, the team reflects on how to become more effective, then tunes and adjusts its behavior accordingly The best architectures, requirements, and designs emerge from self-organizing teams

C’est fout tout ce qu’on a inventé en 1000 ans!

On connaissait les barbus UNIX, les ninjas jQuery … Les vikings symfony arrivent

quitter PuTTY pour KiTTY

mazenovi — Thu, 09 Sep 2010 18:55:30 +0000

Des années que PuTTY est mon meilleur ami pour la gestion de mes serveurs UNIX. Jusque là je n’avais jamais remis ce petit soft en question et c’est en installant conjointement la dernière version de la Framakey et de la Liberkey que je me suis intéressé à KiTTY. Ce dernier ne présente en effet QUE des améliorations par rapport à à son ancêtre

Migrer

Hélas il n’y a pas de solutions miracles pour importer les sessions de PuTTY vers KiTTY. L’idée de base est que ces deux softs écrivent les paramètres des sessions dans la base de registre, de manière temporaire s’ils sont en version portable et de manière permanente sinon.

PuTTY dans la clé HKCU/Software/SimonTatham/PuTTY

et KiTTY dans HKCU/Software/9bis.com/KiTTY

Si vous utilisez PuTTY portable vous devez avoir un répertoire Data/settings/putty.reg dans le répertoire de l’application. Pour la version non portable il vous faudra exporter manuellement à partir de la base de registre (avec regedit puis clic droit -> exporter sur la clé à exporter) la clé

[HKEY_CURRENT_USER\Software\SimonTatham\PuTTY]

Il faut ensuite éditer cette clé avec un éditeur de texte et faire en rechercher / remplacer de l’expression « \SimonTatham\PuTTY » par « \9bis.com\KiTTY », puis sauvegarder le fichier transformé en kitty.reg sur le bureau. Il n’y a ensuite qu’à double cliquer sur ce fichier pour importer les clés que l’on vient de modifier.

A partir de là il faut maintenant utiliser KiTTY en ligne de commande pour qu’il aille chercher la configuration dans la base de registre et qu’il la convertisse en fichier locaux pour que la configuration soit pleinement portable, ce qui se fait via la commande

kitty.exe -convert-dir

Normalement 6 répertoires sont créés dans le répertoire de l’application KiTTY

Fonctionnalités

le fichier kitty.ini, dans le répertoire de l’application permet d’ajouter quelques options sympas, dont

[KiTTY]
icon=yes ;permet d'avoir une <a href="http://www.9bis.net/kitty/?page=That%27s%20all%20folks&zone=fr">icone par session</a>
transparency=yes ;permet de faire le cake en réglant la <a href="http://www.9bis.net/kitty/?page=Transparence&zone=fr">transparence de la fenêtre avec ctrl + et ctrl -</a>

à Voir aussi

note sur les suffixes dans les routes symfony >= 1.2

mazenovi — Fri, 02 Apr 2010 15:41:18 +0000

= 1.2" alt=" note sur les suffixes dans les routes symfony >= 1.2" />

le système de routage

Si comme moi vous avez tenté d’utiliser la directive .suffix dans le routing.yml

prod:
  routing:
    param:
      suffix: .html

et que vous vous attendiez à ce que vorte suffixe .html soit ajouté automatiquement à tous les liens générés via link_to et gen_url … c’est que vous ne savez pas que par défaut symfony génère des urls aussi courtes que possible.

Il vous faudra donc changer ce comportement dans factories.yml

all:
  routing:
    class: sfPatternRouting
    param:
      generate_shortest_url: false

outils de modélisation pour symfony

mazenovi — Wed, 31 Mar 2010 10:14:18 +0000

Symfony à radicalement changer mon approche du développement PHP.

En effet l’approche RAD proposée par ce framework rend d’autant plus crucial le schéma de base de données, sur lequel est basé l’application. Ce schéma matérialisé par le fichier schema.yml (ou .xml si vous utilisez propel) est en quelque sorte la feuille de route du développeur agile.

Il est intéressant de remarquer qu’une modélisation graphique de ce schéma donne un point de vue (partiel certes) sur le système d’information que l’applicaiton sert …

Il ya déjà quelques temps déjà j’avais cherché à automatiser la modification du schéma géré par symfony via des outils graphiques (Utiliser DBDesigner avec l’i18n de symfony 1.0)

Aujourd’hui je vous propose un petit tour d’horizon des solutions à votre disposition selon vos outils et votre orm préférés

DbDesigner

si vous utilisez propel

Le plugin sfDB4toPropelPlugin automatisera le processus de conversion du schéma sauvé par DbDesigner en un schema.yml (à la manière des scritps cités précédemment)

si vous utilisez Doctrine

le plugin sfDbDesignerPlugin ne s’installe pas correctement via la commande symfony. En revanche en l’installant manuellement, i.e. en téléchargeant l’archive directement sur le site et en la décompressant dans /plugins/sfDbDesignerPlugin puis en activant le plugin dans /config/ProjectConfiguration.class.php

enablePlugins('sfDoctrinePlugin');
    $this->enablePlugins('sfDbDesignerPlugin');
  }
}

vous aurez accès à la task

php symfony dbdesigner:convert-doctrine doc/database.xml

Où doc/database.xml est le path vers le fichier DBDesigner.
Si vous n’avez pas une application nommée frontend il faudra la passer ne paramètre

php symfony dbdesigner:convert-doctrine --application=myapp doc/database.xml

vous obtiendrez alors un fichier « ready to build » du schéma modélisé avec DBDesigner dans config/doctrine/schema.yml

MySQLWorkBench

Il est à noter que MySQLWorkbench est un fork de DBDesigner4, mais il ne peut pas remplacer ce dernier. En effet si MySQLWorkbench sait parfaitement importer un fichier xml produit par DbDesigner4, il est en revanche incapable d’exporter ce schéma au format xml de DbDesigner4. MySQLWorkbench ne permet que d’enregistrer au format mwb.

Ce format est en fait un zip, qui une fois décompresser donne un fichier xml, mais qui n’a rien à voir avec le xml généré par DBDesigner4, le fichier xml issu du .wmb est donc inutilisatble avec les deux plugins ci dessus.

MySQLWorkbench bénéficie en revanche d’une bibliothèque de plugins qui permettent de l’utiliser en remplaçant de DBDesigner.

Pour installer un plugin dans MySQLWorkbench il suffit de copier le fichier .lua qui contient le code du plugin (du Python Like) dans le répertoire « modules » du répertoire d’installation de MySQLWorkbench

Si vous utilisez Doctrine mysql-workbench-doctrine-plugin¹ fonctionne plutôt bien
Si vous utilisez Propel mysql-workbench-propel-export-plugin² de générer le contenu de schema.xml, alors que SymfonyYamlMysqlWorkbenchPlugin³ vous permettra de générer le contenu de schema.yml

Dia

Si vous utilisez propel, il est possible de modéliser également votre schéma avec Dia grâce au plugin diaToPropelPlugin, en utilisant la boite à outil « Database » ça va sans dire.

Si vous utilisez Doctrine le plugin ConvertPropelSchemaToDoctrineSchema réalisera la conversion d’un schéma propel en schéma doctrine.

ArgoUML

En graltant un pei plus j’ai trouvé également le plugin uml2symfony, qui semble avoir l’ambition de traduire non pas un schéma de base de données, mais un schéma UML généré avec ArgoUML. Je vous laisse aller plus loin car j’ai personnellement trouvé l’idée séduisante mais la documentation très pauvre, voir inexistante!

Conclusion

Mon choix se portera sur le doublette gagnante MySQLWorkbench, mysql-workbench-doctrine-plugin car:

DBDesigner n’est plus maintenu depuis belle lurette (je me rends compte en écrivant ce post que DBDesigner fork qui a dormi pendant prêt de 3 ans semble revenir à la vie depuis quelques jours)
j’utilise maintenant Doctrine
ce plugin permet une gestion fine des Behaviors Doctrine