• Publicidad

Colaborar con CPAN

¿Tienes algo interesante que decir? ¿O quizá algo no tan interesante? Aquí tenemos un espacio para compartir todo lo que queramos decir y que no cabe en ninguno de los otros foros.

Colaborar con CPAN

Notapor BigBear » 2012-02-29 18:45 @823

¿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 ?
BigBear
Perlero frecuente
Perlero frecuente
 
Mensajes: 981
Registrado: 2009-03-01 18:39 @818

Publicidad

Re: Colaborar con CPAN

Notapor explorer » 2012-02-29 19:49 @867

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)
JF^D Perl programming & Raku programming. Grupo en Telegram: https://t.me/Perl_ES
Avatar de Usuario
explorer
Administrador
Administrador
 
Mensajes: 14480
Registrado: 2005-07-24 18:12 @800
Ubicación: Valladolid, España

Re: Colaborar con CPAN

Notapor explorer » 2012-03-03 18:25 @809

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:

Sintáxis: [ Descargar ] [ Ocultar ]
Using text Syntax Highlighting
From: [email protected]
Subject: [RFC] Data::Counter

Hello all - I've written a new module called Data::Counter that I'm planning to
put on CPAN.

Take a look at the documentation and tell me what you think.

NAME

    Data::Counter - a module that counts your data

DESCRIPTION
...
Coloreado en 0.000 segundos, usando GeSHi 1.0.8.4
(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.
JF^D Perl programming & Raku programming. Grupo en Telegram: https://t.me/Perl_ES
Avatar de Usuario
explorer
Administrador
Administrador
 
Mensajes: 14480
Registrado: 2005-07-24 18:12 @800
Ubicación: Valladolid, España


Volver a Pasando el rato

¿Quién está conectado?

Usuarios navegando por este Foro: No hay usuarios registrados visitando el Foro y 1 invitado