Listado de todos los comandos de referencia a la hora de la creación y manejo de las gemas de Ruby.
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 i
el 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.
- RubyGems: Encuentra, instala, y publica gemas de Ruby (1)
- RubyGems: Descargar RubyGems (2)
- RubyGems: Conceptos Básicos (3)
- RubyGems: ¿Qué es una Gema? (4)
- RubyGems: ¿Cómo hacer una gema? (5)
- RubyGems: Gemas con extensiones (6)
- RubyGems: Nombrando tu gema (7)
- RubyGems: Publicar y compartir tu gema (8)
- RubyGems: Prácticas de seguridad (9)
- RubyGems: Administrar Propietarios (10)
- RubyGems: Eliminar una gema publicada (11)
- RubyGems: Actualizar certificado SSL (12)
- RubyGems: Patrones (13)
- RubyGems: Referencias archivo GEMSPEC (14)