Foro - Perl en Español

¿Cómo colaborar con CPAN? Digo, por si yo hiciera un módulo y quisiera publicarlo en CPAN para ser una de las caras de CPAN: http://hexten.net/cpan-faces/

¿ Cómo tendría qué hacer ?

El que esas caras aparezcan ahí no es el objetivo de CPAN, sino el de crear código para compartirlo con los demás

El proceso, es largo de explicar, y conlleva saber varias cosas... algunas de ellas:

• Crear una distribución Perl. Antiguamente era un proceso algo tedioso, pero con las nuevas distribuciones ExtUtils::MakeMaker, Module::Build, Module::Install o, el más moderno (aunque no completo), Dist::Zilla, se puede hacer de forma mucho más cómoda
• En la creación, no hay que olvidar incluir test de prueba, lo cual es todo un arte
• Antes incluso de empaquetar la distribución, antes incluso de hacer nada, hay que dar un nombre a todo esto, y ese nombre no se puede elegir alegremente... hay que seguir unas reglas. Lo más básica es anunciar en los grupos de discusión y listas de correo de los desarrolladores Perl que has hecho una nueva distribución, que hace qué, y que quieres llamarla de tal forma. Entonces, es posible que recibas críticas aconsejándote que no lo hagas con ese nombre, porque se "pega" con alguna distribución anterior ya publicada, o que lo metas dentro del espacio de nombres de otra familia (por ejemplo, si tu módulo trata XML, pues que depende de alguno de los módulos XML anteriores, si se trata de una variación de ellos), o quizás una crítica muy clara que dice "eso ya existe en CPAN y se llama así". Tómate las críticas siempre de forma constructiva
• Hay que leerse y entender el manual de uso de PAUSE que es la web que gestiona todo lo relacionado con la parte de publicación de tus ficheros en CPAN. Ahí viene también explicado lo del proceso de anuncio del nombre de la distribución en las listas de correo y foros de discusión
• Para tener imagen en CPAN (y en muchos otros sitios), debes darte de alta en gravatar.com, asociando tus direcciones de correo electrónico a la imagen que quieras subir. Creo (no lo he comprobado), que las imágenes que aparecen en CPAN son los gravatar asociados a las cuentas de correo [email protected], que se crean de forma automática al registrarte en PAUSE.
• ... (seguro que me dejo un montón de cosas)

Más cosas...

Para elegir el nombre de la distribución, si se tienen dudas, es mejor pedir ayuda a las listas de correo [email protected] y [email protected], donde la gente te dirá si tu módulo está bien que lo publiques, o si ya hay módulos que hacen lo que quieres hacer, o cuál sería el mejor nombre.

En el grupo de noticias comp.lang.perl.modules puedes entonces enviar un RFC, indicando que tienes la intención de publicar un módulo con un cierto nombre y que hace algo determinado.

Sam Tregar, en el 2002, publicó el libro «Writing Perl Modules for CPAN». En la página 130 pone un ejemplo de cómo sería ese envío:

(un ejemplo real)

Si al cabo de tres días nadie te dice nada, o te animan a que lo hagas, pues ya puedes publicarlo. Quizás recibas críticas constructivas (las más), así que hay que tomarlas con deportividad, y pensar que a lo mejor tienen razón (¿Por qué hacer un módulo más de XML si hay más de doscientos? ¿Por qué hacer un sistema de plantillas si hay 4 docenas?)

En este libro se explican también todos los pasos para crear y publicar la distribución, pero como es del año 2002, están un poco anticuados.

En otros libros de Perl, como en «Effective Perl Programming», 2ª ed., 2010, se explica cómo crear una distribución CPAN, con ayuda de Module::Starter.