Reprendre un paquet qui n'est plus maintenu

Edited By

Arnaud Limbourg

$Date: 2008-10-09 15:17:02 $

Si vous voulez devenir le mainteneur principal d'un paquet qui est marqué comme étant plus maintenu sur le site web de PEAR, ce chapitre va vous expliquer les étapes pour y parvenir.

  1. La première chose à faire est d'en informer la liste de diffusion de l'assurance qualité PEAR. Si vous n'avez encore rien réaliser au sein du projet PEAR, il convient d'écrire quelques lignes sur vous et sur vos motivations.

  2. L'équipe QA décidera si oui ou non vous pouvez reprendre ce paquet, en expliquant éventuellement pourquoi. Vous pouvez ensuite demander un compte pour le site web PEAR si vous n'en avez pas déjà un. Le groupe PEAR pourra mettre à jour ce compte et ensuite, l'équipe QA vous assignera en tant que nouveau mainteneur pour ce paquet.

  3. Si les sources de ce paquet sont sur le CVS de PHP, vous devez également avoir un accès CVS. Vous pouvez le demander sur le site de PHP. Mentionnez dans le commentaire de la demande que l'équipe QA de PEAR vous a demandé de faire les démarches pour avoir un compte CVS, votre demande n'en sera que traitée plus rapidement. Les comptes CVS sont gérés par le groupe PHP, PEAR n'a qu'une influence limitée sur ce processus.

    Si vous avez déjà un compte CVS pour cvs.php.net, il est nécessaire d'aquérir un "karma" supplémentaire pour le module où réside le paquet. Vous pouvez demander ce karma en envoyant un mail au groupe PEAR. (Mentionnez également dans ce mail que vous avez déjà vu les détails avec l'équipe QA).

  4. Si tout s'est déroulé correctement, vous devriez être maintenant le nouveau mainteneur de ce paquet. Si ce n'est toujours pas le cas, n'hésitez pas à solliciter de l'aide sur la liste de diffusion QA.

Modification d'une proposition (Previous) PEAR Developer Guide (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

Note by: doconnor
PEAR has started the process of migrating packages over to github; as they fall unmaintained.

There's a migration tool for this @ https://github.com/pear/pear-svn-git

By utilising github; new maintainers can quickly contribute patches via a local fork.

Note by: doconnor
Coding standards and unit tests.

PEAR has some pretty picky standards for acceptance, and some pretty picky people.

If you are contributing a patch or looking to move forward with package maintainence, make sure you've read our coding standard. There are even tools to help you check for conformance - like PHP_CodeSniffer http://pear.php.net/php_codesniffer

Even more loved by us PEAR folk is unit test coverage.

We use either simple phpt tests, or PHPUnit tests (http://phpunit.de).

We have a CI server, which runs hourly.
http://test.pear.php.net/unit-test-results/

Making sure your contributions don't break tests, and even adding further test coverage is a sure fire way to get your foot in the door with PEAR.


To run, from an svn checkout of your package:
# If the package uses simple tests
pear run-tests -r tests/

# Or if it's PHPUnit enabled
php tests/AllTests.php

Gotten stuck, because there's lots of existing broken tests? Or the tests don't run?
File a bug :)
Note by: doconnor
What else do you need to know about taking over a pear package?

We're a friendly bunch, but a busy bunch - so if we are giving you the silent treatment or being a bit picky, don't despair.

We are on a variety of mediums, from mailing lists to IRC - if you aren't sure of what to do next or how to progress things, why not chat to us.

All of the details are on the home page - http://pear.php.net/
Note by: doconnor
Another great step that will get you brownie points - take a look at open bug reports for the package.

If you can fix or improve them, why not do a patch?

Grabbing the source is easy.
1) svn checkout http://svn.php.net/repository/pear/packages/Foo/trunk Foo
2) Make your changes
3) svn diff > mypatch.txt
4) File a bug report/feature request and upload your patch