RubyGems: Comandos de referencia (15)

Listado de todos los comandos de referencia a la hora de la creación y manejo de las gemas de Ruby.

Contenidos

Construir una Gema

Construir una gema a partir de una gemspec.

Uso

gem build GEMSPEC_FILE [options]

Opciones

  • --platform PLATFORM – Especificar la plataforma de gema a construir.
  • --force – omitir la validación de la especificación
  • --strict – considere las advertencias como errores al validar la especificación
  • -o, --output FILE – gema de salida con el nombre de archivo dado
  • -C PATH – Ejecutar como si la creación de gemas se hubiera iniciado enen lugar del directorio de trabajo actual.

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMSPEC_FILE – nombre de archivo gemspec para construir una gema para

Descripción

El comando de compilación le permite crear una gema a partir de una gemspec de ruby.

La mejor manera de construir una gema es usar un Rakefile y Gem::PackageTask que se envía con RubyGems.

La especificación de gema puede crearse a mano o extraerse de una gema existente con especificación de gema:

$ gem unpack my_gem-1.0.gem
Unpacked gem: '.../my_gem-1.0'
$ gem spec my_gem-1.0.gem --ruby > my_gem-1.0/my_gem-1.0.gemspec
$ cd my_gem-1.0
[edit gem contents]
$ gem build my_gem-1.0.gemspec

Las gemas se pueden guardar en un nombre de archivo específico con la opción de salida:

$ gem build my_gem-1.0.gemspec --output=release.gem

Certificar una Gema

Administre los certificados de RubyGems y la configuración de firma

Uso

gem cert [options]

Opciones

  • -a, --add CERT – Agregar un certificado de confianza.
  • -l, --list [FILTER] – Lista de certificados de confianza donde el asunto contiene FILTRO
  • -r, --remove FILTER – Eliminar certificados de confianza donde el asunto contiene FILTRO
  • -b, --build EMAIL_ADDR – Cree una clave privada y un certificado autofirmado para EMAIL_ADDR
  • -C, --certificate CERT – Certificado de firma de --sign
  • -K, --private-key KEY – Clave para --sign o--build
  • -A, --key-algorithm ALGORITHM – Seleccione qué algoritmo clave usar para --build
  • -s, --sign CERT – Firma CERT con la clave de -K y el certificado de -C
  • -d, --days NUMBER_OF_DAYS – Días antes de que caduque el certificado
  • -R, --re-sign – Vuelve a firmar el certificado de -C con la clave de -K

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando cert administra claves de firma y certificados para crear gemas firmadas. Su certificado de firma y clave privada generalmente se almacenan en ~/.gem/gem-public_cert.pem y ~/.gem/gem-private_key.pem respectivamente.

Para crear un certificado para firmar gemas:

gem cert --build you@example

Si ya tiene una clave RSA o está creando un nuevo certificado para una clave existente:

gem cert --build you@example --private-key /path/to/key.pem

Si desea confiar en un certificado, puede agregarlo a la lista de confianza con:

gem cert --add /path/to/cert.pem

Puede enumerar certificados de confianza con:

gem cert --list

O:

gem cert --list cert_subject_substring

Si desea eliminar un certificado de confianza anterior:

gem cert --remove cert_subject_substring

Para firmar el certificado de autor de otra gema:

gem cert --sign /path/to/other_cert.pem

Para obtener más información sobre la firma de gemas, consulte ri Gem::Security.

Gem check

Verifique un repositorio de gemas para archivos agregados o faltantes

Uso

gem check [OPTIONS] [GEMNAME ...] [options]

Opciones

  • -a, --[no-]alien – Informe de archivos “no administrados” o no autorizados en el repositorio de gemas
  • --[no-]doctor – Limpia gemas desinstaladas y especificaciones rotas
  • --[no-]dry-run – No elimine archivos, solo informe lo que se eliminaría
  • --[no-]gems – Verifique las gemas instaladas en busca de problemas
  • -v, --version VERSION – Especifique la versión de la gema para verificar

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema a comprobar

Descripción

El comando de verificación puede enumerar y reparar problemas con las gemas y especificaciones instaladas y limpiará las gemas que se hayan desinstalado parcialmente.

Limpiar una Gema

Limpia versiones antiguas de gemas instaladas

Uso

gem cleanup [GEMNAME ...] [options]

Opciones

  • -n, -d, --dry-run – No desinstalar gemas
  • -D, --[no-]check-development – Verifique las dependencias de desarrollo durante la desinstalación (predeterminado: verdadero)
  • --[no-]user-install – Limpieza en el directorio de inicio del usuario en lugar de GEM_HOME.

Opciones Obsoletas

  • --dryrun – No desinstalar gemas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema a limpiar

Descripción

El comando de limpieza elimina las versiones antiguas de las gemas de GEM_HOME que no son necesarias para cumplir con una dependencia.

Si una gema está instalada en otro lugar de GEM_PATH, el comando de limpieza no la eliminará.

Si no se nombra ninguna gema, se limpian todas las gemas en GEM_HOME.

Contenido de la Gema

Mostrar el contenido de las gemas instaladas

Uso

gem contents GEMNAME [GEMNAME ...] [options]

Opciones

  • -v, --version VERSION – Especificar la versión de la gema al contenido.
  • --all – Contenidos para todas las gemas.
  • -s, --spec-dir a,b,c – Buscar gemas en rutas específicas
  • -l, --[no-]lib-only – Solo devolver archivos en lib_dirs de Gem
  • --[no-]prefix – No incluya el prefijo de ruta instalado
  • --[no-]show-install-dir – Mostrar solo el directorio de instalación de la gema

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema para listar contenidos para

Descripción

El comando de contenido enumera los archivos en una gema instalada. La lista se puede proporcionar como nombres de archivo completos, nombres de archivo sin el prefijo del directorio instalado o solo los archivos que son necesarios.

Dependencias de Gema

Mostrar las dependencias de una gema instalada

Uso

gem dependency REGEXP [options]

Opciones

  • -v, --version VERSION – Especificar la versión de la gema para la dependencia.
  • --platform PLATFORM – Especificar la plataforma de la gema a la dependencia.
  • --[no-]prerelease – Permitir versiones preliminares de una gema
  • -R, --[no-]reverse-dependencies – Incluir dependencias inversas en la salida
  • --pipe – Formato de tubería (nombre ver --version)

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones Local/Remota

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • REGEXP – muestra las dependencias de las gemas cuyos nombres comienzan con REGEXP

Descripción

Los comandos de dependencia enumeran de qué otras gemas depende una determinada gema.

Para las gemas locales, solo se pueden mostrar las dependencias inversas (qué gemas dependen de la gema nombrada).

La lista de dependencias se puede mostrar en un formato adecuado para la canalización para su uso con otros comandos.

Entorno de Gema

Mostrar información sobre el entorno de RubyGems

Uso

gem environment [arg] [options]

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • gemdir – muestra la ruta donde están instaladas las gemas
  • gempath – ruta de visualización utilizada para buscar gemas
  • version – muestra la versión en formato de gema
  • remotesources – muestra los servidores de gemas remotos
  • platform – muestra las plataformas de gemas compatibles
  • – mostrar todo

Descripción

El comando de entorno le permite consultar rubygems para su configuración para usar en scripts de shell o como ayuda para la depuración.

El entorno de RubyGems se puede controlar a través de argumentos de línea de comandos, archivos gemrc, variables de entorno y valores predeterminados integrados.

Los valores predeterminados de los argumentos de la línea de comandos y algunos valores predeterminados de RubyGems se pueden establecer en un archivo ~/.gemrc para usuarios individuales y un gemrc en el DIRECTORIO DE CONFIGURACIÓN DEL SISTEMA para todos los usuarios.

Estos archivos son archivos YAML con las siguientes claves YAML:

:sources: A YAML array of remote gem repositories to install gems from
:verbose: Verbosity of the gem command. false, true, and :really are the
          levels
:update_sources: Enable/disable automatic updating of repository metadata
:backtrace: Print backtrace when RubyGems encounters an error
:gempath: The paths in which to look for gems
:disable_default_gem_server: Force specification of gem server host on push
<gem_command>: A string containing Argumentos for the specified gem command

Ejemplo:

:verbose: false
install: --no-wrappers
update: --no-wrappers
:disable_default_gem_server: true

El repositorio local predeterminado de RubyGems se puede anular con las variables de entorno GEM_PATH y GEM_HOME. GEM_HOME establece el repositorio predeterminado para instalar. GEM_PATH permite buscar gemas en varios repositorios locales.

Si está detrás de un servidor proxy, RubyGems usa las variables de entorno HTTP_PROXY, HTTP_PROXY_USER y HTTP_PROXY_PASS para descubrir el servidor proxy.

Si desea enviar gemas a un servidor de gemas privado, la variable de entorno RUBYGEMS_HOST puede establecerse en el URI de ese servidor.

Si está empaquetando RubyGems, todos los valores predeterminados de RubyGems están en lib/rubygems/defaults.rb. Puede anularlos en lib/rubygems/defaults/operating_system.rb.

Búsqueda de Gema

Descarga una gema y colócala en el directorio actual.

Uso

gem fetch GEMNAME [GEMNAME ...] [options]

Opciones

  • -v, --version VERSION – Especificar la versión de la gema para obtener
  • --platform PLATFORM – Especificar la plataforma de la gema para buscar
  • --[no-]prerelease – Permitir versiones preliminares de una gema
  • --[no-]suggestions – Sugerir alternativas cuando no se encuentran gemas

Opciones Local/Remota

  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • --clear-sources – Limpiar las fuentes de gemas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema para descargar

Descripción

El comando fetch obtiene archivos de gemas que pueden almacenarse para su uso posterior o descomprimirse para examinar su contenido.

Consulte la ayuda del comando de compilación para ver un ejemplo de cómo desempaquetar una gema, modificarla y luego volver a empaquetarla.

Generación de Índice de Gema

Genera los archivos de índice para un directorio de servidor de gemas

Uso

gem generate_index [options]

Opciones

  • -d, --directory=DIRNAME – directorio base del repositorio que contiene el subdirectorio de gemas
  • --[no-]modern – Generar índices para RubyGems (siempre verdadero)
  • --update – Actualizar índices modernos con gemas agregadas desde la última actualización

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando generate_index crea un conjunto de índices para servir gemas de forma estática. El comando espera un directorio de ‘gemas’ en la ruta dada a la opción de directorio. El directorio dado será el directorio que sirva como repositorio de gemas.

Para gem generate_index --directory /path/to/repo, exponga /path/to/repo a través de la configuración de su servidor HTTP (no /path/to/repo/gems).

Cuando termine, generará un conjunto de archivos como este:

gems/*.gem                                   # .gem files you want to
                                             # index

specs.<version>.gz                           # specs index
latest_specs.<version>.gz                    # latest specs index
prerelease_specs.<version>.gz                # prerelease specs index
quick/Marshal.<version>/<gemname>.gemspec.rz # Marshal quick index file

Los archivos de extensión .rz se comprimen con el algoritmo de inflación. El número de versión de Marshal proviene de las constantes Marshal::MAJOR_VERSION y Marshal::MINOR_VERSION de Ruby. Se utiliza para garantizar la compatibilidad.

Ayuda de Gema

Proporcione ayuda en el comando ‘gem’

Uso

gem help ARGUMENT [options]

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Información de Gema

Mostrar información para la gema dada

Uso

gem info GEMNAME [options]

Opciones

  • -i, --[no-]installed – Verificar gema instalada
  • -I – Equivalente a--no-installed
  • -v, --version VERSION – Especificar la versión de la gema a la información para usar con--installed
  • --[no-]versions – Mostrar solo nombres de gemas
  • -a, --all – Mostrar todas las versiones de gemas
  • -e, --exact – Nombre de la(s) gema(s) para consultar coincidencias con la STRING proporcionada
  • --[no-]prerelease – Mostrar versiones preliminares

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones Local/Remota

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema sobre la que imprimir información

Descripción

Info imprime información sobre la gema, como el nombre, la descripción, el sitio web, la licencia y las rutas instaladas.

Instalación de Gema

Instalar una gema en el repositorio local

Uso

gem install [options] GEMNAME [GEMNAME ...] -- --build-flags [options]

Opciones

  • --platform PLATFORM – Especificar la plataforma de gema a instalar.
  • -v, --version VERSION – Especificar la versión de la gema para instalar
  • --[no-]prerelease – Permitir la instalación de versiones preliminares de una gema. (Solo para las gemas enumeradas)

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones de Instalación / Actualización

  • -i, --install-dir DIR – Directorio de repositorio de gemas para instalar gemas.
  • -n, --bindir DIR – Directorio donde se colocarán los ejecutables cuando se instale la gema
  • --document [TYPES] – Generar documentación para gemas instaladas Enumere los tipos de documentación que desea generar. Por ejemplo: rdoc,ri
  • --build-root DIR – Raíz de instalación temporal. Útil para la construcción de paquetes. No use esto al instalar gemas remotas.
  • --vendor – Instalar gem en el directorio de proveedores. Solo para uso de reempaquetadores de gemas.
  • -N, --no-document – Deshabilitar la generación de documentación.
  • -E, --[no-]env-shebang – Vuelva a escribir la línea shebang en los scripts instalados para usar /usr/bin/env
  • -f, --[no-]force – Forzar gema para instalar, sin pasar por los controles de dependencia
  • -w, --[no-]wrappers – Usar envoltorios bin para ejecutables No disponible en plataformas dosish
  • -P, --trust-policy POLICY – Especificar la política de confianza de gemas
  • --ignore-dependencies – No instale ninguna gema dependiente requerida
  • --[no-]format-executable – Hacer que los nombres de los ejecutables instalados coincidan con Ruby. Si Ruby es ruby18, foo_exec será foo_exec18
  • --[no-]user-install – Instalar en el directorio de inicio del usuario en lugar de GEM_HOME.
  • --development – Instalar dependencias de desarrollo adicionales
  • --development-all – Instale dependencias de desarrollo para todas las gemas (incluidos los propios departamentos de desarrollo)
  • --conservative – No intente actualizar las gemas que ya cumplen con los requisitos de versión
  • --[no-]minimal-deps – No actualice ninguna dependencia que ya cumpla con los requisitos de la versión
  • --[no-]post-install-message – Imprimir mensaje posterior a la instalación
  • -g, --file [FILE] – Lea desde un archivo API de dependencias de gemas e instale las gemas enumeradas
  • --without GROUPS – Omita los grupos con nombre (separados por comas) al instalar desde un archivo de dependencias de gemas
  • --default – Agregue la especificación completa de la gema a las especificaciones/predeterminado y extraiga solo su contenedor
  • --explain – En lugar de instalar las gemas, indicar cuál se instalaría
  • --[no-]lock – Crear un archivo de bloqueo (cuando se usa con -g/–file)
  • --[no-]suggestions – Sugerir alternativas cuando no se encuentran gemas

Opciones Local/Remoto

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema a instalar

Descripción

El comando de instalación instala una gema local o remota en un repositorio de gemas.

Para gemas con ejecutables, Ruby instala un archivo contenedor en el directorio ejecutable de forma predeterminada. Esto se puede anular con la opción –sin envoltorios. El envoltorio le permite elegir entre versiones de gemas alternativas usando version .

Por ejemplo rake _0.7.3_ --version, ejecutará la versión 0.7.3 de rake si también está instalada una versión más nueva.

Archivos de Dependencias de Gema

RubyGems puede instalar un conjunto coherente de gemas en varios entornos gem install -g cuando hay un archivo de dependencias de gemas (gem.deps.rb, Gemfile o Isolate). Si no se proporciona un archivo explícito, RubyGems intenta encontrar uno en el directorio actual.

Cuando la variable de entorno RUBYGEMS_GEMDEPS se establece en un archivo de dependencias de gemas, las gemas de ese archivo se activarán en el momento del inicio.

Establézcalo en un nombre de archivo específico o en “-” para que RubyGems descubra automáticamente el archivo de dependencias de gemas al subir desde el directorio actual.

NOTA: Habilitar la detección automática en sistemas multiusuario puede conducir a la ejecución de código arbitrario cuando se usa desde directorios fuera de su control.

Errores de Instalación de Extensiones

Si una extensión no se compila durante la instalación de la gema, la especificación de la gema no se escribe, pero la gema permanece desempaquetada en el repositorio.

Es posible que deba especificar la ruta a los encabezados y bibliotecas de la biblioteca para continuar.

Puede hacer esto agregando un – entre las opciones de RubyGems y las opciones de compilación de la extensión:

$ gem install some_extension_gem
[build fails]
Gem files will remain installed in \
/path/to/gems/some_extension_gem-1.0 for inspection.
Results logged to /path/to/gems/some_extension_gem-1.0/gem_make.out
$ gem install some_extension_gem -- --with-extension-lib=/path/to/lib
[build succeeds]
$ gem list some_extension_gem

*** LOCAL GEMS ***

some_extension_gem (1.0)
$

Si corrige los errores de compilación editando los archivos gem, deberá escribir la especificación a mano. Por ejemplo:

$ gem install some_extension_gem
[build fails]
Gem files will remain installed in \
/path/to/gems/some_extension_gem-1.0 for inspection.
Results logged to /path/to/gems/some_extension_gem-1.0/gem_make.out
$ [cd /path/to/gems/some_extension_gem-1.0]
$ [edit files or what-have-you and run make]
$ gem spec ../../cache/some_extension_gem-1.0.gem --ruby > \
           ../../specifications/some_extension_gem-1.0.gemspec
$ gem list some_extension_gem

*** LOCAL GEMS ***

some_extension_gem (1.0)
$

Alias de Comandos

Puede usar iel comando en lugar de install.

$ gem i GEMNAME

Lista de Gemas

Mostrar gemas locales cuyo nombre coincida con REGEXP

Uso

gem list [REGEXP ...] [options]

Opciones

  • -i, --[no-]installed – Verificar gema instalada
  • -I – Equivalent to --no-installed
  • -v, --version VERSION – Especificar la versión de la gema a la lista para su uso con--installed
  • -d, --[no-]details – Mostrar información detallada de la(s) gema(s)
  • --[no-]versions – Mostrar solo nombres de gemas
  • -a, --all – Mostrar todas las versiones de gemas
  • -e, --exact – Nombre de la(s) gema(s) para consultar coincidencias con la STRING proporcionada
  • --[no-]prerelease – Mostrar versiones preliminares

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones Local/Remoto

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • REGEXP – expresión regular para buscar en el nombre de la gema

Descripción

El comando de lista se usa para ver las gemas que ha instalado localmente.

La opción de detalles muestra detalles adicionales, incluido el resumen, la página de inicio, el autor, las ubicaciones de las diferentes versiones de la gema.

Para buscar gemas remotas, use el comando de búsqueda.

Cerradura de Gema

Generar una lista de bloqueo de gemas

Uso

gem lock GEMNAME-VERSION [GEMNAME-VERSION ...] [options]

Opciones

  • -s, --[no-]strict – fallar si no se puede satisfacer una dependencia

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema para bloquear
  • VERSION – versión de gema para bloquear

Descripción

El comando de bloqueo generará una lista de declaraciones +gem+ que bloquearán las versiones de la gema proporcionada en la línea de comando. Especificará las versiones exactas en la lista de requisitos para garantizar que las gemas cargadas siempre sean consistentes. Se generará una búsqueda recursiva completa de todas las gemas afectadas.

Ejemplo:

gem lock rails-1.0.0 > lockdown.rb

Creará en lockdown.rb:

require "rubygems"
gem 'rails', '= 1.0.0'
gem 'rake', '= 0.7.0.1'
gem 'activesupport', '= 1.2.5'
gem 'activerecord', '= 1.13.2'
gem 'actionpack', '= 1.11.2'
gem 'actionmailer', '= 1.1.5'
gem 'actionwebservice', '= 1.0.0'

Simplemente cargue lockdown.rb desde su aplicación para asegurarse de que se carguen las versiones actuales. Asegúrese de que lockdown.rb esté cargado antes que cualquier otra instrucción require.

Tenga en cuenta que Rails 1.0.0 solo requiere que se use el rake 0.6.2 o superior. Rake-0.7.0.1 es la versión instalada más reciente que cumple con eso, por lo que lo bloqueamos en la versión exacta.

Espejo de Gema

Duplicar todos los archivos de gemas (requiere rubygems-mirror)

Uso

gem mirror [options]

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando espejo se ha movido a la gema rubygems-mirror.

Gema Abierta

Abrir fuentes de gemas en el editor

Uso

gem open [-e COMMAND] GEMNAME [options]

Opciones

  • -e, --editor COMMAND – Antepone COMANDO a la ruta de la gema. Podría usarse para especificar el editor.
  • -v, --version VERSION – Abre una versión de gema específica

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema para abrir en el editor

Descripción

      The open command opens gem in editor and changes current path
      to gem's source directory.
      Editor command can be specified with -e option, otherwise rubygems
      will look for editor in $EDITOR, $VISUAL and $GEM_EDITOR variables.

Gema Obsoleta

Mostrar todas las gemas que necesitan actualizaciones

Uso

gem outdated [options]

Opciones

  • --platform PLATFORM – Especificar la plataforma de gema a obsoleta

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones Local/Remota

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando obsoleto enumera las gemas que quizás desee actualizar a una versión más nueva.

Puede comprobar si hay discrepancias de dependencia con el comando de dependencia y actualizar las gemas con los comandos de actualización o instalación.

Dueño de Gema

Administre los propietarios de gemas de una gema en el servidor push

Uso

gem owner GEM [options]

Opciones

  • -k, --key KEYNAME – Use la clave de API dada desde ~/.local/share/gem/credentials
  • --otp CODE – Código de dígitos para autenticación multifactor También puede usar la variable de entorno GEM_HOST_OTP_CODE
  • -a, --add EMAIL – Añadir un propietario
  • -r, --remove EMAIL – Eliminar un propietario
  • --host HOST – Use otro host compatible con gemcutter (por ejemplo, https://rubygems.org)

Opciones Local/Remoto

  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEM – gema para administrar propietarios

Descripción

El comando de propietario le permite agregar y eliminar propietarios de una gema en un servidor push (el valor predeterminado es https://rubygems.org).

El propietario de una gema tiene permiso para impulsar nuevas versiones, extraer versiones existentes o editar la página HTML de la gema. Tenga cuidado con a quién le da permiso de inserción.

Gema Prístina

Restaura las gemas instaladas a una condición impecable desde los archivos ubicados en el caché de gemas

Uso

gem pristine [GEMNAME ...] [options]

Opciones

  • --all – Restaurar todas las gemas instaladas a un estado impecable
  • --skip=gem_name – utilizado en --all,omitir si nombre == gem_name
  • --[no-]extensions – Restaurar gemas con extensiones además de las gemas regulares
  • --only-executables – Solo restaurar ejecutables
  • --only-plugins – Solo restaurar complementos
  • -E, --[no-]env-shebang – Reescriba los ejecutables con un shebang de /usr/bin/env
  • -i, --install-dir DIR – Repositorio de gemas para instalar binstubs y complementos
  • -n, --bindir DIR – Directorio donde se encuentran los ejecutables
  • -v, --version VERSION – Especifique la versión de la gema para restaurar a su estado original

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – gema para restaurar a una condición prístina (a menos que –todo)

Descripción

El comando pristine compara una gema instalada con el contenido de su archivo .gem almacenado en caché y restaura cualquier archivo que no coincida con la copia de .gem almacenada en caché.

Si ha realizado modificaciones en una gema instalada, el comando prístino las revertirá. Todas las extensiones se reconstruyen y todos los talones de contenedores para la gema se regeneran después de verificar si hay modificaciones.

Si no se puede encontrar la gema almacenada en caché, se descargará.

Si se proporciona –no-extensions, prístine no intentará restaurar una gema con una extensión.

Si se dan –extensiones (pero no –all o nombres de gemas), solo se restaurarán las gemas con extensiones.

Push de Gema

Sube una gema al servidor de gemas

Uso

gem push GEM [options]

Opciones

  • -k, --key KEYNAME – Use la clave de API dada desde ~/.local/share/gem/credentials
  • --otp CODE – Código de dígitos para autenticación multifactor También puede usar la variable de entorno GEM_HOST_OTP_CODE
  • --host HOST – Empuje a otro host compatible con gemcutter (por ejemplo, https://rubygems.org)

Opciones Local/Remoto

  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEM – gema construida para empujar hacia arriba

Descripción

El comando de inserción carga una gema en el servidor de inserción (el valor predeterminado es https://rubygems.org) y la agrega al índice.

La gema se puede eliminar del índice y eliminar del servidor usando el comando yank. Para obtener más información, consulte la ayuda del comando yank.

El comando push usará ~/.gem/credentials para autenticarse en un servidor, pero puede usar la variable de entorno de RubyGems GEM_HOST_API_KEY para configurar la clave API para autenticarse.

Consulta de Gema

Consultar información de gemas en repositorios locales o remotos

Uso

gem query [options]

Opciones

  • -n, --name-matches REGEXP – Nombre de la(s) gema(s) para consultar coincidencias con el REGEXP proporcionado
  • -i, --[no-]installed – Verificar gema instalada
  • -I – Equivalente a--no-installed
  • -v, --version VERSION – Especificar la versión de la gema para consultar para su uso con--installed
  • -d, --[no-]details – Mostrar información detallada de la(s) gema(s)
  • --[no-]versions – Mostrar solo nombres de gemas
  • -a, --all – Mostrar todas las versiones de gemas
  • -e, --exact – Nombre de la(s) gema(s) para consultar coincidencias con la STRING proporcionada
  • --[no-]prerelease – Mostrar versiones preliminares

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones Local/Remota

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando de consulta es la base para los comandos de lista y búsqueda.

Realmente debería usar la lista y los comandos de búsqueda en su lugar. Este comando es demasiado difícil de usar.

RDOC Gema

Genera RDoc para gemas preinstaladas

Uso

gem rdoc [args] [options]

Opciones

  • --all – Generar documentación RDoc/RI para todas las gemas instaladas
  • --[no-]rdoc – Generar RDoc HTML
  • --[no-]ri – Generar datos RI
  • --[no-]overwrite – Sobrescribir documentos instalados
  • -v, --version VERSION – Especificar la versión de la gema para rdoc

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – gema para generar documentación para (a menos que –todos)

Descripción

El comando rdoc crea documentación para las gemas instaladas.

De forma predeterminada, solo la documentación se crea con rdoc, pero se pueden crear tipos adicionales de documentación a través de complementos de rubygems y el enlace Gem.post_installs.

Use –overwrite para forzar la reconstrucción de la documentación..

Búsqueda de Gemas

Mostrar gemas remotas cuyo nombre coincida con REGEXP

Uso

gem search [REGEXP] [options]

Opciones

  • -i, --[no-]installed – Verificar gema instalada
  • -I – Equivalente a--no-installed
  • -v, --version VERSION – Especifique la versión de la gema para buscar su uso--installed
  • -d, --[no-]details – Mostrar información detallada de la(s) gema(s)
  • --[no-]versions – Mostrar solo nombres de gemas
  • -a, --all – Mostrar todas las versiones de gemas
  • -e, --exact – Nombre de la(s) gema(s) para consultar coincidencias con la STRING proporcionada
  • --[no-]prerelease – Mostrar versiones preliminares

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones Local/Remota

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • REGEXP – regexp to search for in gem name

Descripción

El comando de búsqueda muestra gemas remotas cuyo nombre coincide con la expresión regular dada.

La opción de detalles muestra detalles adicionales de la gema, pero tardará un poco más en completarse, ya que debe descargar la información individualmente del índice.

Para enumerar las gemas locales, use el comando de lista.

Servidor de Gemas

Inicia un servidor web que aloja el RDoc (requiere rubygems-server)

Uso

gem server [options]

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando del servidor se ha movido a la gema rubygems-server.

Inicio de Sesion de Gemas

Inicie sesión en cualquier host compatible con gemcutter. Por defecto es https://rubygems.org

Uso

gem signin [options]

Opciones

  • --host HOST – Empuje a otro host compatible con gemcutter
  • --otp CODE – Código de dígitos para autenticación multifactor También puede usar la variable de entorno GEM_HOST_OTP_CODE

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando de inicio de sesión ejecuta el inicio de sesión del host para un servidor push (el valor predeterminado es https://rubygems.org). El host se puede proporcionar con la bandera de host o se puede inferir de la gema proporcionada. La resolución del host coincide con la estrategia de resolución del comando push.

Cierra de Sesión de Gemas

Cerrar sesión en todas las sesiones actuales.

Uso

gem signout [options]

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando signout se usa para cerrar sesión en todas las sesiones actuales, lo que le permite iniciar sesión con un conjunto diferente de credenciales.

Fuentes de Gemas

Manage the sources and cache file RubyGems uses to search for gems

Uso

gem sources [options]

Opciones

  • -a, --add SOURCE_URI – Agregue una fuente
  • -l, --list – Lista de fuentes
  • -r, --remove SOURCE_URI – Eliminar fuente
  • -c, --clear-all – Eliminar todas las fuentes (borrar el caché)
  • -u, --update – Actualizar caché de origen
  • -f, --[no-]force – No muestre ningún mensaje de confirmación y compórtese como si siempre se hubiera respondido ‘sí’

Opciones Local/Remoto

  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

RubyGems obtiene gemas de las fuentes que ha configurado (almacenadas en su ~/.gemrc).

La fuente predeterminada es https://rubygems.org, pero es posible que tenga otras fuentes configuradas. Esta guía lo ayudará a actualizar sus fuentes o configurarse para usar su propio servidor de gemas.

Sin ningún argumento, las fuentes enumeran las fuentes configuradas actualmente:

$ gem sources
*** CURRENT SOURCES ***

https://rubygems.org

Esto puede enumerar múltiples fuentes o fuentes que no sean rubygems. Probablemente los configuró antes o tiene un antiguo ~/.gemrc. Si tiene fuentes que no reconoce, debe eliminarlas.

RubyGems se ha configurado para servir gemas a través de las siguientes URL a lo largo de su historial:

  • http://gems.rubyforge.org (RubyGems 1.3.6 y anteriores)
  • https://rubygems.org/ (RubyGems 1.3.7 a 1.8.25)
  • https://rubygems.org (RubyGems 2.0.1 y posteriores)

Dado que todas estas fuentes apuntan al mismo conjunto de gemas, solo necesita una de ellas en su lista. Se recomienda https://rubygems.org ya que ofrece la protección de una conexión SSL para las descargas de gemas.

Para agregar una fuente, use el argumento –add:

  $ gem sources --add https://rubygems.org
  https://rubygems.org added to sources

RubyGems verificará si las gemas se pueden instalar desde la fuente proporcionada antes de agregarlas.

Para eliminar una fuente, use el argumento –remove:

  $ gem sources --remove https://rubygems.org/
  https://rubygems.org/ removed from sources

Especificación de Gemas

Mostrar especificación de gemas (en yaml)

Uso

gem specification [GEMFILE] [FIELD] [options]

Opciones

  • -v, --version VERSION – Especificar la versión de la gema para examinar
  • --platform PLATFORM – Especifique la plataforma de la gema según las especificaciones.
  • --[no-]prerelease – Permitir versiones preliminares de una gema
  • --all – Especificaciones de salida para todas las versiones de la gema.
  • --ruby – Formato ruby de salida
  • --yaml – Formato YAML de salida
  • --marshal – Formato de Mariscal de salida

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones Local/Remota

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMFILE – nombre de la gema para mostrar la gemspec para
  • FIELD – nombre del campo gemspec para mostrar

Descripción

El comando de especificación le permite extraer la especificación de una gema para examinarla.

La especificación se puede generar en formatos YAML, Ruby o Marshal.

Los campos específicos de la especificación se pueden extraer en formato YAML:

$ gem spec rake summary
--- Ruby based make-like utility.
...

Gemas Pasadas

Lista de gemas junto con los tiempos de acceso

Uso

gem stale [options]

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Descripción

El comando obsoleto enumera el tiempo de acceso más reciente para todos los archivos en sus gemas instaladas.

Puede usar este comando para descubrir gemas y versiones de gemas que ya no usa.

Desinstalación de Gemas

Desinstalar gemas del repositorio local

Uso

gem uninstall GEMNAME [GEMNAME ...] [options]

Opciones

  • -a, --[no-]all – Desinstalar todas las versiones coincidentes
  • -I, --[no-]ignore-dependencies – Ignorar los requisitos de dependencia durante la desinstalación
  • -D, --[no-]check-development – Verifique las dependencias de desarrollo durante la desinstalación (predeterminado: falso)
  • -x, --[no-]executables – Desinstalar ejecutables aplicables sin confirmación
  • -i, --install-dir DIR – Directorio para desinstalar gema
  • -n, --bindir DIR – Directorio para eliminar ejecutables de
  • --[no-]user-install – Desinstalar desde el directorio de inicio del usuario además de GEM_HOME.
  • --[no-]format-executable – Suponga que los nombres de los ejecutables coinciden con el prefijo y el sufijo de Ruby.
  • --[no-]force – Desinstalar todas las versiones de las gemas nombradas ignorando las dependencias
  • --[no-]abort-on-dependent – Impedir la desinstalación de gemas de las que dependen otras gemas.
  • -v, --version VERSION – Especificar la versión de la gema para desinstalar
  • --platform PLATFORM – Especifique la plataforma de la gema para desinstalar
  • --vendor – Desinstalar gema del directorio de proveedores. Solo para uso de reempaquetadores de gemas.

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nnombre de la gema a desinstalar

Descripción

El comando de desinstalación elimina una gema previamente instalada.

RubyGems le pedirá confirmación si está intentando desinstalar una gema que depende de una gema existente. Puede usar la opción –ignorar-dependencias para omitir esta verificación.

Desempaquetar Gema

Descomprima una gema instalada en el directorio actual

Uso

gem unpack GEMNAME [options]

Opciones

  • --target=DIR – directorio de destino para desempaquetar
  • --spec – descomprima la especificación de la gema
  • -v, --version VERSION – Especificar la versión de la gema para desempaquetar

Opciones de Instalación / Actualización

  • -P, --trust-policy POLICY – Especificar la política de confianza de gemas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema para desempaquetar

Descripción

El comando descomprimir le permite examinar el contenido de una gema o modificarlo para ayudar a diagnosticar un error.

Puede agregar el contenido de la gema desempaquetada a la ruta de carga usando la variable de entorno RUBYLIB o -I:

$ gem unpack my_gem
Unpacked gem: '.../my_gem-1.0'
[edit my_gem-1.0/lib/my_gem.rb]
$ ruby -Imy_gem-1.0/lib -S other_program

Puede volver a empaquetar una gema desempaquetada usando el comando de compilación. Consulte la ayuda del comando de compilación para ver un ejemplo.

Actualización de Gemas

Actualice las gemas instaladas a la última versión

Uso

gem update GEMNAME [GEMNAME ...] [options]

Opciones

  • --system [VERSION] – Actualice el software del sistema RubyGems
  • --platform PLATFORM – Especifique la plataforma de la gema para actualizar
  • --[no-]prerelease – Permitir versiones preliminares de una gema como objetivos de actualización

Opciones Obsoletas

  • -u, --[no-]update-sources – Actualizar caché de fuente local

Opciones de Instalación / Actualización

  • -i, --install-dir DIR – Directorio de repositorio de gemas para instalar gemas.
  • -n, --bindir DIR – Directorio donde se colocarán los ejecutables cuando se instale la gema
  • --document [TYPES] – Generar documentación para gemas instaladas Enumere los tipos de documentación que desea generar. Por ejemplo: rdoc,ri
  • --build-root DIR – Raíz de instalación temporal. Útil para la construcción de paquetes. No use esto al instalar gemas remotas
  • --vendor – Instalar gem en el directorio de proveedores. Solo para uso de reempaquetadores de gemas.
  • -N, --no-document – Deshabilitar la generación de documentación.
  • -E, --[no-]env-shebang – Vuelva a escribir la línea shebang en los scripts instalados para usar /usr/bin/env
  • -f, --[no-]force – Forzar gema para instalar, sin pasar por los controles de dependencia
  • -w, --[no-]wrappers – Usar envoltorios bin para ejecutables No disponible en plataformas dosish
  • -P, --trust-policy POLICY – Especificar la política de confianza de gemas
  • --ignore-dependencies – No instale ninguna gema dependiente requerida
  • --[no-]format-executable – Hacer que los nombres de los ejecutables instalados coincidan con Ruby. Si Ruby es ruby18, foo_exec será foo_exec18
  • --[no-]user-install – Instalar en el directorio de inicio del usuario en lugar de GEM_HOME.
  • --development – Instalar dependencias de desarrollo adicionales
  • --development-all – Instale dependencias de desarrollo para todas las gemas (incluidos los propios departamentos de desarrollo)
  • --conservative – No intente actualizar las gemas que ya cumplen con los requisitos de versión
  • --[no-]minimal-deps – No actualice ninguna dependencia que ya cumpla con los requisitos de la versión
  • --[no-]post-install-message – Imprimir mensaje posterior a la instalación
  • -g, --file [FILE] – Lea desde un archivo API de dependencias de gemas e instale las gemas enumeradas
  • --without GROUPS – Omita los grupos con nombre (separados por comas) al instalar desde un archivo de dependencias de gemas
  • --default – Agregue la especificación completa de la gema a las especificaciones/predeterminado y extraiga solo su contenedor
  • --explain – En lugar de instalar las gemas, indicar cuál se instalaría
  • --[no-]lock – Crear un archivo de bloqueo (cuando se usa con -g/–file)
  • --[no-]suggestions – Sugerir alternativas cuando no se encuentran gemas

Opciones Local/Remota

  • -l, --local – Restringir operaciones al dominio LOCAL
  • -r, --remote – Restringir operaciones al dominio REMOTO
  • -b, --both – Permitir operaciones LOCALES y REMOTAS
  • -B, --bulk-threshold COUNT – Umbral para cambiar a sincronización masiva (predeterminado 1000)
  • --clear-sources – Limpiar las fuentes de gemas
  • -s, --source URL – Agregar URL a la lista de fuentes de gemas remotas
  • -p, --[no-]http-proxy [URL] – Usar proxy HTTP para operaciones remotas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEMNAME – nombre de la gema para actualizar

Descripción

El comando de actualización actualizará sus gemas a la última versión.

El comando de actualización no elimina la versión anterior. Use el comando de limpieza para eliminar versiones antiguas.

Which Gema

Encuentre la ubicación de un archivo de biblioteca que puede necesitar.

Uso

gem which FILE [FILE ...] [options]

Opciones

  • -a, --[no-]all – mostrar todos los archivos coincidentes
  • -g, --[no-]gems-first – buscar gemas antes que no gemas

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • FILE – nombre del archivo a buscar

Descripción

El comando which es como el comando which del shell y le muestra dónde se encuentra el archivo que desea solicitar.

Puede usar el comando which para ayudar a determinar por qué necesita una versión que no esperaba o mirar el contenido de un archivo que necesita para ver por qué no se comporta como esperaba.

Gema Yank

Eliminar una gema empujada del índice

Uso

gem yank -v VERSION [-p PLATFORM] [--key KEY_NAME] [--host HOST] GEM [options]

Opciones

  • -v, --version VERSION – Especificar la versión de la gema para eliminar
  • --platform PLATFORM – Especificar la plataforma de la gema para eliminar
  • --otp CODE – Código de dígitos para autenticación multifactor También puede usar la variable de entorno GEM_HOST_OTP_CODE
  • --host HOST – Yank desde otro host compatible con gemcutter (por ejemplo, https://rubygems.org)
  • -k, --key KEYNAME – Use la clave de API dada desde ~/.local/share/gem/credentials

Opciones Comunes

  • -h, --help – Obtener ayuda sobre este comando
  • -V, --[no-]verbose – Establecer el nivel detallado de salida
  • -q, --quiet – Medidor de progreso del comando de silencio
  • --silent – Silenciar la salida de RubyGems
  • --config-file FILE – Use este archivo de configuración en lugar del predeterminado
  • --backtrace – Mostrar seguimiento de pila en errores
  • --debug – Activar la depuración de Ruby
  • --norc – Evite cargar cualquier archivo .gemrc

Argumentos

  • GEM – nombre de la gema

Descripción

El comando yank elimina permanentemente una gema que envió a un servidor.

Una vez que haya enviado una gema, se realizarán automáticamente varias descargas a través de los webhooks.

Si accidentalmente presionó contraseñas u otros datos confidenciales, deberá cambiarlos de inmediato y retirar su gema.


Relacionado

RubyGems: Nombrando tu gema (7)

Estos son algunos ejemplos de recomendaciones para nombrar gemas: NOMBRE DE LA GEMA REQUERIR DECLARACIÓN CLASE PRINCIPAL O MÓDULO ruby_parser require 'ruby_parser' RubyParser rdoc-data require 'rdoc/data' RDoc::Data net-http-persistent require 'net/http/persistent' Net::HTTP::Persistent net-http-digest_auth require 'net/http/digest_auth' Net::HTTP::DigestAuth El objetivo principal de estas recomendaciones es dar al usuario alguna ¡SEGUIR LEYENDO!

RubyGems: Publicar y compartir tu gema (8)

Ahora que has creado tu primera gema , probablemente estés listo para compartirla. Si bien, es perfectamente razonable crear gemas privadas únicamente para organizar el código en grandes proyectos privados, es más común crear gemas para que puedan ser utilizadas por varios proyectos. En esta guía ¡SEGUIR LEYENDO!

RubyGems: Prácticas de seguridad (9)

La instalación de una gema permite que el código de esa gema se ejecute en el contexto de tu aplicación. Claramente, eso tiene implicaciones de seguridad: La instalación de una gema maliciosa en un servidor podría resultar en última instancia en que el autor de la ¡SEGUIR LEYENDO!

RubyGems: Administrar Propietarios (10)

De forma similar a gem owner --add los comandos gem owner --remove de la CLI de las gemas, se pueden agregar o eliminar los propietarios de las gemas que posees mediante la interfaz de usuario web. Sección de propiedad de tu GEMA Si eres propietario de ¡SEGUIR LEYENDO!

15 Mejores Lenguajes de Programación que Aprender

Una de las habilidades más importantes para aprender en el mundo de hoy en día, es saber programar con un lenguaje de programación. En la actualidad, las computadoras han entrado en casi todas las industrias, desde el piloto automático de un avión hasta el velocímetro digital ¡SEGUIR LEYENDO!

Deja un comentario