Perl CPAN :: Primera vez

CONTENIDO

• NOMBRE
• SINOPSIS
• DESCRIPCIÓN
• LICENCIA

NOMBRE

CPAN :: FirstTime – Utilidad para CPAN :: Inicialización del archivo de configuración

SINOPSIS

CPAN :: Primera hora :: init ()

DESCRIPCIÓN

La rutina init hace algunas preguntas y escribe un archivo CPAN / Config.pm o CPAN / MyConfig.pm (dependiendo de lo que esté usando actualmente).

A continuación, se recopilan todas las preguntas y explicaciones sobre las variables de configuración.

allow_installing_module_downgrades

El caparazón de CPAN puede ver el blib/ directorios que se crean antes de ejecutarse make test para determinar si la distribución actual terminará sobrescribiendo módulos con números de versión de módulo decrecientes. Luego puede dejar que la compilación de esta distribución falle cuando descubra una degradación.

¿Quiere permitir la instalación de distribuciones con versiones de módulos decrecientes en comparación con lo que ha instalado (sí, no, pregunte / sí, pregunte / no)?

allow_installing_outdated_dists

El caparazón de CPAN puede ver el blib/ directorios que se crean antes de ejecutarse make test para determinar si la distribución actual contiene módulos que están indexados con una distribución con un número de versión de distribución más alto que el actual. Luego puede dejar que la compilación de esta distribución falle cuando no representaría la versión más actualizada de la distribución.

Nota: si elige cualquier cosa que no sea “sí” para esta opción, será necesario instalar Devel :: DistnameInfo para que surta efecto.

¿Quiere permitir la instalación de distribuciones que no estén indexadas como la versión de distribución más alta para todos los módulos contenidos (sí, no, pregunte / sí, pregunte / no)?

auto_commit

Normalmente, CPAN.pm mantiene las variables de configuración en la memoria y los cambios deben guardarse en un comando separado ‘o conf commit’ para que sean permanentes entre sesiones. Si establece la opción ‘auto_commit’ en verdadero, los cambios en una variable de configuración siempre se confirman automáticamente en el disco.

¿Confirmar siempre los cambios de las variables de configuración en el disco?

build_cache

CPAN.pm puede limitar el tamaño del área del disco para mantener los directorios de compilación con todos los archivos intermedios.

¿Tamaño de la caché para el directorio de compilación (en MB)?

build_dir

¿Directorio donde se lleva a cabo el proceso de construcción?

build_dir_reuse

Hasta la versión 1.88, CPAN.pm nunca confiaba en el contenido del directorio build_dir entre sesiones. Desde 1.88_58 CPAN.pm tiene un mecanismo basado en YAML que hace posible compartir el contenido del directorio build_dir / entre diferentes sesiones con la misma versión de perl. A las personas que prefieren probar las cosas varios días antes de la instalación les gustará esta función porque les ahorra mucho tiempo.

Si responde que sí a la siguiente pregunta, CPAN intentará almacenar suficiente información sobre el proceso de compilación para que pueda retomar en sesiones futuras en el mismo estado de cosas que dejó una sesión anterior.

¿Almacenar y reutilizar información de estado sobre distribuciones entre sesiones de CPAN.pm?

build_requires_install_policy

Cuando un módulo declara otro como un prerrequisito ‘build_requires’, esto significa que el otro módulo solo es necesario para construir o probar el módulo, pero no necesita instalarse permanentemente. En este caso, es posible que desee instalar ese otro módulo de todos modos o simplemente mantenerlo en el directorio ‘build_dir’ para que esté disponible solo temporalmente. La instalación ahorra tiempo en instalaciones futuras pero hace que la instalación de perl sea más grande.

Puede elegir si desea instalar siempre (sí), nunca instalar (no) o que siempre se le pregunte. En el último caso, puede establecer la respuesta predeterminada para la pregunta en sí (preguntar / sí) o no (preguntar / no).

¿Política sobre la instalación de módulos ‘build_requires’ (sí, no, pregunte / sí, pregunte / no)?

cache_metadata

Para acelerar considerablemente el inicio del shell CPAN inicial, es posible utilizar Storable para crear una caché de metadatos. Si Storable no está disponible, se utilizará el mecanismo de índice normal.

Nota: este mecanismo no se utiliza cuando use_sqlite está activado y SQLLite se está ejecutando.

¿Metadatos de caché (sí / no)?

check_sigs

Los paquetes de CPAN pueden ser firmados digitalmente por los autores y, por lo tanto, verificados con la seguridad proporcionada por una sólida criptografía. El mecanismo exacto se define en el módulo Module :: Signature. Si bien esto generalmente se considera algo bueno, no siempre es conveniente para el usuario final instalar módulos que están firmados incorrectamente o donde la clave del autor no está disponible o donde algún requisito previo para Module :: Signature tiene un error, etc. .

Con el parámetro check_sigs puede activar y desactivar la verificación de firmas. El valor predeterminado está desactivado por ahora porque algunos aún no consideran madura toda la cadena de herramientas para la funcionalidad. El autor de CPAN.pm recomendaría configurarlo en verdadero la mayor parte del tiempo y apagarlo solo si resulta molesto.

Tenga en cuenta que si no tiene Module :: Signature instalado, no se realizarán comprobaciones de firmas.

Siempre intente comprobar y verificar las firmas si hay un archivo de FIRMA en el paquete y el Módulo :: Firma está instalado (sí / no).

cleanup_after_install

Los usuarios que instalan módulos y no tienen la intención de mirar hacia atrás, pueden liberar espacio en disco ocupado rápidamente permitiendo que CPAN.pm limpie cada directorio de compilación inmediatamente después de una instalación exitosa.

¿Eliminar el directorio de compilación después de una instalación exitosa? (sí No)?

colorize_output

Cuando tiene Term :: ANSIColor instalado, puede activar la salida coloreada para tener algunas diferencias visuales entre la salida normal de CPAN.pm, las advertencias, la salida de depuración y la salida de los módulos que se instalan. Establezca sus colores favoritos después de experimentar con el módulo Term :: ANSIColor.

Tenga en cuenta que en las plataformas Windows la salida coloreada también requiere el módulo Win32 :: Console :: ANSI.

¿Quieres activar la salida en color?

colorize_print

¿Color para salida normal?

colorize_warn

¿Color para las advertencias?

colorize_debug

¿Color para depurar mensajes?

commandnumber_in_prompt

El indicador del shell cpan puede contener el número de comando actual para facilitar el seguimiento de la sesión o ser una cadena simple.

¿Quiere el número de comando en el indicador (sí / no)?

connect_to_internet_ok

Si nunca has definido el tuyo urllist en su configuración entonces CPAN.pm dudará en usar los sitios predeterminados integrados para la descarga. Le preguntará una vez por sesión si la conexión a Internet está bien y solo si dice que sí, intentará conectarse. Pero para evitar esta pregunta, puede elegir sus sitios de descarga favoritos una vez y salirse con la suya. O, si no tiene sitios de descarga favoritos, responda afirmativamente a la siguiente pregunta.

Si aún no se ha elegido una lista de direcciones URL, ¿preferiría que CPAN.pm se conecte a los sitios predeterminados integrados sin preguntar? (sí No)?

ftp_passive

¿Estableceremos siempre la variable de entorno FTP_PASSIVE cuando se trate de descargas de ftp (sí / no)?

ftpstats_period

Las estadísticas sobre descargas se truncan por tamaño y período simultáneamente.

¿Cuántos días mantendremos estadísticas sobre descargas?

ftpstats_size

Las estadísticas sobre descargas se truncan por tamaño y período simultáneamente. Establecer esto en cero o negativo deshabilita las estadísticas de descarga.

¿Cuántos elementos guardaremos en las estadísticas de descargas?

getcwd

CPAN.pm cambia el directorio de trabajo actual con frecuencia y necesita determinar su propio directorio de trabajo actual. Por defecto usa Cwd :: cwd pero si esto no funciona en su sistema por alguna razón, se pueden configurar alternativas de acuerdo a la siguiente tabla:

cwd         Cwd::cwd
getcwd      Cwd::getcwd
fastcwd     Cwd::fastcwd
getdcwd     Cwd::getdcwd
backtickcwd external command cwd

¿Método preferido para determinar el directorio de trabajo actual?

halt_on_failure

Normalmente, CPAN.pm continúa procesando la lista completa de destinos y dependencias, incluso si uno de ellos falla. Sin embargo, puede especificar que CPAN se detenga después del primer error. (Tenga en cuenta que los módulos opcionales recomendados o sugeridos que fallan no causarán una interrupción).

¿Quiere detenerse en caso de falla (sí / no)?

histfile

Si tiene uno de los paquetes readline (Term :: ReadLine :: Perl, Term :: ReadLine :: Gnu, posiblemente otros) instalado, el shell CPAN interactivo tendrá soporte histórico. Las siguientes dos preguntas tratan sobre el nombre del archivo histórico y su tamaño. Si no desea establecer esta variable, presione ESPACIO ENTRAR a la siguiente pregunta.

¿Archivo para guardar su historial?

histsize

¿Número de líneas para guardar?

tiempo de inactividad

A veces, es posible que desee dejar los procesos ejecutados por CPAN solo sin preocuparse por ellos. Debido a que Makefile.PL o Build.PL a veces contienen preguntas que se espera que responda, puede configurar un temporizador que matará un proceso ‘perl Makefile.PL’ después del tiempo especificado en segundos.

Si establece este valor en 0, estos procesos esperarán eternamente. Esta es la configuración predeterminada y recomendada.

¿Se agotó el tiempo de inactividad durante Makefile, Build .PL?

index_expire

Los índices de CPAN generalmente se reconstruyen una o dos veces por hora, pero el espejo típico de CPAN se refleja solo una o dos veces al día. Dependiendo de la calidad de su espejo y su deseo de estar a la vanguardia, es posible que desee establecer el siguiente valor en más o menos de un día (que es el valor predeterminado). Determina después de cuántos días CPAN.pm descarga nuevos índices.

¿Deje que el índice caduque después de cuántos días?

inhibit_startup_message

Cuando se inicia el shell de CPAN, normalmente muestra un mensaje de saludo que contiene la versión en ejecución y el estado del soporte de readline.

¿Quieres desactivar este mensaje?

keep_source_where

A menos que esté accediendo al CPAN en su sistema de archivos a través de un archivo: URL, CPAN.pm necesita mantener los archivos fuente que descarga en algún lugar. Proporcione un directorio donde se guardarán los archivos descargados.

¿Descargar directorio de destino?

load_module_verbosity

Cuando CPAN.pm carga un módulo que necesita para alguna característica opcional, generalmente informa sobre el nombre y la versión del módulo. Elija ‘v’ para obtener este mensaje, ‘ninguno’ para suprimirlo.

¿Nivel de verbosidad para cargar módulos (ninguno o v)?

makepl_arg

Perl ejecuta cada Makefile.PL en un proceso separado. Del mismo modo, ejecutamos ‘make’ y ‘make install’ en procesos separados. Si tiene algún parámetro (por ejemplo, PREFIX, UNINST o similar) que desea pasar a las llamadas, especifíquelo aquí.

Si no entiende esta pregunta, simplemente presione ENTER.

Configuraciones típicas de uso frecuente:

PREFIX=~/perl    # non-root users (please see manual for more hints)

¿Parámetros para el comando ‘perl Makefile.PL’?

make_arg

¿Parámetros para el comando ‘make’? Configuración típica de uso frecuente:

-j3              # dual processor system (on GNU make)

Tu elección:

make_install_arg

¿Parámetros para el comando ‘make install’? Configuración típica de uso frecuente:

UNINST=1# to always uninstall potentially conflicting files# (but do NOT use with local::lib or INSTALL_BASE)

Tu elección:

make_install_make_command

¿Quieres usar un comando make diferente para ‘make install’? Las personas cautelosas probablemente preferirán:

   su root -c make
or
   sudo make
or/path1/to/sudo-u admin_account /path2/to/make

o algo así. Tu elección:

mbuildpl_arg

Perl ejecuta un Build.PL en un proceso separado. Del mismo modo, ejecutamos ‘./Build’ y ‘./Build install’ en procesos separados. Si tiene algún parámetro que desee pasar a las llamadas, especifíquelo aquí.

Configuraciones típicas de uso frecuente:

--install_base /home/xxx# different installation directory

¿Parámetros para el comando ‘perl Build.PL’?

mbuild_arg

¿Parámetros para el comando ‘./Build’? El ajuste puede ser:

--extra_linker_flags -L/usr/foo/lib  # non-standard library location

Tu elección:

mbuild_install_arg

¿Parámetros para el comando ‘./Build install’? Configuración típica de uso frecuente:

--uninst 1# uninstall conflicting files# (but do NOT use with local::lib or INSTALL_BASE)

Tu elección:

mbuild_install_build_command

¿Desea utilizar un comando diferente para ‘./Build install’? Los usuarios de Sudo probablemente prefieran:

   su root -c./Build
or
   sudo ./Build
or/path1/to/sudo-u admin_account ./Build

o algo así. Tu elección:

buscapersonas

¿Cuál es su programa de buscapersonas favorito?

prefer_installer

Cuando tiene Module :: Build instalado y un módulo viene con Makefile.PL y Build.PL, ¿cuál tendrá prioridad?

Los dos módulos de instalación estándar principales son los antiguos y bien establecidos ExtUtils :: MakeMaker (para abreviar: EUMM) que usa Makefile.PL. Y el instalador de próxima generación Module :: Build (MB) que funciona con Build.PL (y a menudo también viene con Makefile.PL). Si un módulo viene solo con uno de los dos, lo usaremos, pero si se suministran ambos, entonces se debe tomar una decisión entre EUMM y MB. Consulte también http://rt.cpan.org/Ticket/Display.html?id=29235 para ver una discusión sobre el valor predeterminado correcto.

O, como tercera opción, puede elegir RAND, que tomará una decisión aleatoria (algo que los probadores de CPAN habituales disfrutarán).

En caso de que pueda elegir entre ejecutar Makefile.PL o Build.PL, ¿qué instalador preferiría (EUMM o MB o RAND)?

prefs_dir

CPAN.pm puede almacenar entornos de compilación personalizados basados ​​en expresiones regulares para nombres de distribución. Estos son archivos YAML donde las opciones predeterminadas para CPAN.pm y el entorno se pueden anular y se pueden almacenar secuencias de diálogo que luego pueden ser ejecutadas por un objeto Expect.pm. La distribución CPAN.pm viene con algunos archivos YAML prefabricados que cubren distribuciones de muestra que pueden usarse como planos para almacenar sus propias preferencias. Consulte el directorio distroprefs / de la distribución CPAN.pm para obtener un inicio rápido en el sistema de preferencias.

¿Directorio donde almacenar las opciones / entorno / diálogos predeterminados para construir módulos que necesitan alguna personalización?

prerequisites_policy

El módulo CPAN puede detectar cuándo un módulo que está intentando construir depende de los requisitos previos. Si esto sucede, puede crear los requisitos previos para usted automáticamente (‘seguir’), pedirle confirmación (‘preguntar’) o simplemente ignorarlos (‘ignorar’). La elección de ‘seguir’ también establece PERL_AUTOINSTALL y PERL_EXTUTILS_AUTOINSTALL para “–defaultdeps” si aún no está configurado.

Establezca su política en uno de los tres valores.

¿Política sobre requisitos previos de construcción (seguir, preguntar o ignorar)?

randomize_urllist

CPAN.pm puede introducir algo de aleatoriedad al usar hosts para descarga que están configurados en el parámetro urllist. Ingrese un valor numérico entre 0 y 1 para indicar la frecuencia con la que desea permitir que CPAN.pm pruebe un host aleatorio de la lista de URL. Un valor de uno especifica que siempre se utilice un host aleatorio como primer intento. Un valor de cero significa que no hay aleatoriedad en absoluto. Cualquier valor intermedio especifica con qué frecuencia, en promedio, se debe probar primero un host aleatorio.

Parámetro de aleatorización

recomienda_política

(¡Característica experimental!) Algunos módulos CPAN recomiendan dependencias opcionales adicionales. Por lo general, estos deben instalarse excepto en entornos con recursos limitados. Cuando esta política sea cierta, los módulos recomendados se incluirán con los módulos requeridos.

¿Incluir módulos recomendados?

scan_cache

De forma predeterminada, cada vez que se inicia el módulo CPAN, se realiza un escaneo de caché para mantener el tamaño de la caché sincronizado (‘al inicio’). Alternativamente, el escaneo y la limpieza pueden ocurrir cuando CPAN sale (‘atexit’). Para evitar cualquier limpieza de caché, responda “nunca”.

¿Realizar escaneo de caché (‘atstart’, ‘atexit’ o ‘never’)?

cascarón

¿Cuál es tu caparazón favorito?

show_unparsable_versions

Durante el comando ‘r’, CPAN.pm busca módulos sin número de versión. Cuando finaliza el comando, imprime un informe sobre esto. Si desea que este informe sea muy detallado, responda sí a la siguiente variable.

¿Mostrar todos los módulos individuales que no tienen $ VERSION?

show_upload_date

Los comandos ‘d’ y ‘m’ normalmente solo le muestran la información que tienen en su base de datos en memoria y, por lo tanto, nunca se conectarán a Internet. Si establece la variable ‘show_upload_date’ en verdadero, ‘m’ y ‘d’ le mostrarán adicionalmente la fecha de carga del módulo o distribución. De forma predeterminada, esta función está desactivada porque puede requerir una conexión de red para llegar a la fecha de carga.

¿Siempre intente mostrar la fecha de carga con los comandos ‘d’ y ‘m’ (sí / no)?

show_zero_versions

Durante el comando ‘r’, CPAN.pm busca módulos con un número de versión cero. Cuando finaliza el comando, imprime un informe sobre esto. Si desea que este informe sea muy detallado, responda sí a la siguiente variable.

¿Mostrar todos los módulos individuales que tienen $ VERSION de cero?

sugiere_política

(¡Característica experimental!) Algunos módulos CPAN sugieren dependencias opcionales adicionales. Estas dependencias de “sugerencia” proporcionan un funcionamiento mejorado. Cuando esta política sea cierta, los módulos sugeridos se incluirán con los módulos requeridos.

¿Incluir módulos sugeridos?

tar_verbosity

Cuando CPAN.pm utiliza el comando tar, ¿qué conmutador de verbosidad se utilizará? Elija ‘ninguno’ para un funcionamiento silencioso, ‘v’ para la lista de nombres de archivo, ‘vv’ para la lista completa.

Nivel de verbosidad del comando de alquitrán (ninguno o v o vv)?

term_is_latin

La siguiente opción trata con el juego de caracteres (también conocido como juego de caracteres) que admite su terminal. En general, CPAN es un territorio de habla inglesa, por lo que el juego de caracteres no importa mucho, pero algunos CPAN tienen nombres que están fuera del rango ASCII. Si su terminal es compatible con UTF-8, debe responder que no a la siguiente pregunta. Si espera ISO-8859-1 (también conocido como LATIN1), entonces debería decir que sí. Si no admite ninguna de las dos, su respuesta no importa porque de todos modos no podrá leer los nombres de algunos autores. Si responde no, los nombres se mostrarán en UTF-8.

¿Su terminal espera ISO-8859-1 (sí / no)?

term_ornaments

Al usar Term :: ReadLine, puede activar los adornos para que su entrada se destaque frente a la salida de CPAN.pm.

¿Quieres encender los adornos?

informe de prueba

El objetivo del proyecto CPAN Testers (http://testers.cpan.org/) es probar tantos paquetes CPAN como sea posible en tantas plataformas como sea posible. Esto proporciona comentarios valiosos a los autores de módulos y a los usuarios potenciales para identificar errores o problemas de compatibilidad de la plataforma y mejora la calidad y el valor generales de CPAN.

Una forma en la que puede contribuir es enviando los resultados de las pruebas para cada módulo que instale. Si instala el módulo CPAN :: Reporter, tiene la opción de generar y entregar automáticamente informes de prueba a los probadores de CPAN siempre que ejecute pruebas en un paquete de CPAN.

Consulte la documentación de CPAN :: Reporter para obtener detalles adicionales y opciones de configuración. Si su firewall bloquea el tráfico saliente, es posible que deba configurar CPAN :: Reporter antes de enviar informes.

¿Generar informes de prueba si CPAN :: Reporter está instalado (sí / no)?

perl5lib_verbosity

Cuando CPAN.pm extiende @INC a través de PERL5LIB, imprime una lista de directorios agregados (o un resumen de cuántos directorios se agregan). Elija ‘v’ para obtener este mensaje, ‘ninguno’ para suprimirlo.

¿Nivel de verbosidad para los cambios de PERL5LIB (ninguno o v)?

prefer_external_tar

Por defecto, todas las operaciones untar se realizan con el módulo perl Archive :: Tar; al establecer esta variable en verdadero, el comando tar externo se usa si está disponible; en Unix esto suele ser el preferido porque tienen una implementación gnutar rápida y confiable.

Utilice el programa tar externo en lugar de Archive :: Tar?

trust_test_report_history

Cuando CPAN :: Reporter ya ha probado una distribución en esta máquina, CPAN puede omitir la fase de prueba y simplemente confiar en el historial del informe de prueba.

Tenga en cuenta que esto no se aplicará a las distribuciones que fallaron en las pruebas debido a que faltan dependencias. Además, las pruebas se pueden ejecutar independientemente del historial utilizando “force”.

¿Quiere confiar en el historial de informes de prueba (sí / no)?

urllist_ping_external

Cuando se realiza la selección automática de los espejos cpan más cercanos, active el uso del ping externo a través de Net :: Ping :: External. Esto se recomienda en el caso de que la red local tenga un proxy transparente.

¿Desea utilizar el comando ping externo al seleccionar automáticamente los espejos?

urllist_ping_verbose

Cuando se realiza la selección automática de los espejos cpan más cercanos, esta opción se puede usar para activar la verbosidad durante el proceso de selección.

¿Quieres ver la verbosidad activada al seleccionar espejos automáticamente?

use_prompt_default

Cuando esto sea cierto, CPAN establecerá PERL_MM_USE_DEFAULT en un valor verdadero. Esto hace que los mensajes de ExtUtils :: MakeMaker (y compatibles) usen valores predeterminados en lugar de detenerse para pedirle que responda preguntas. También establece NONINTERACTIVE_TESTING en un valor verdadero para indicar de manera más general que las distribuciones no deberían intentar interactuar con usted.

¿Desea utilizar valores predeterminados de solicitud (sí / no)?

use_sqlite

CPAN :: SQLite es una capa entre los archivos de índice que se descargan de CPAN y CPAN.pm que acelera las consultas de metadatos y reduce la memoria consumo de CPAN.pm considerablemente.

¿Usar CPAN :: SQLite si está disponible? (sí No)?

version_timeout

Este tiempo de espera evita que CPAN se cuelgue al intentar analizar una $ VERSION codificada patológicamente de un módulo.

El valor predeterminado es de 15 segundos. Si establece este valor en 0, no se producirá ningún tiempo de espera, pero no se recomienda.

¿Se agotó el tiempo de espera para analizar las versiones del módulo?

yaml_load_code

Tanto YAML.pm como YAML :: Syck son capaces de deserializar código. Como esto requiere una evaluación de cadena, que podría ser un riesgo de seguridad, puede usar esta opción para habilitar o deshabilitar la deserialización del código a través de CPAN :: DeferredCode. (Nota: esto no funciona con perl 5.6)

¿Quiere habilitar la deserialización de código (sí / no)?

yaml_module

En el momento de escribir este artículo (2009-03) hay tres implementaciones de YAML en funcionamiento: YAML, YAML :: Syck y YAML :: XS. Los dos últimos son más rápidos pero necesitan un compilador C instalado en su sistema. Puede haber más módulos alternativos que se ajusten a YAML. Cuando probé con otros dos reproductores, YAML :: Tiny y YAML :: Perl, no parecían lo suficientemente potentes para trabajar con CPAN.pm. Esto puede haber cambiado mientras tanto.

¿Qué implementación de YAML preferirías?

LICENCIA

Este programa es software gratuito; puede redistribuirlo y / o modificarlo en los mismos términos que el propio Perl.