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 pista sobre cómo requerir los archivos de tu gema.
Seguir estas convenciones también permite que Bundler requiera tu gema sin configuración adicional.
Si publicas una gema en rubygems.org, es posible que se elimine si el nombre es objetable, viola la propiedad intelectual o si el contenido de la gema no cumple con estos criterios.
Puede informar sobre dicha gema a support@rubygems.org por correo electrónico.
Si una clase o módulo tiene varias palabras, use guiones bajos para separarlas. Esto coincide con el archivo que requerirá el usuario, lo que facilita que el usuario comience a usar su gema.
Si estás agregando funcionalidad a otra gema, usa un guion. Eso generalmente corresponde a una /en la instrucción require (y por lo tanto a la estructura de directorios de su gema) y una :: en el nombre de su clase o módulo principal.
Si tu clase o módulo tiene varias palabras y también estás agregando funcionalidad a otra gema, sigue las dos reglas anteriores.
Por ejemplo, net-http-digest_authagrega autenticación de resumen HTTP a net/http. El usuario require 'net/http/digest_auth' usará la extensión (en clase Net::HTTP::DigestAuth).
OS X y Windows tienen sistemas de archivos que no distinguen entre mayúsculas y minúsculas de forma predeterminada.
Los usuarios pueden requerir por error archivos de una gema usando letras mayúsculas que no serán portátiles si lo mueven a un sistema que no sea Windows o OS X.
<<
Los juegos gratis de Amazon Prime Gaming representan un atractivo significativo para los suscriptores de…
Si eres un amante de los videojuegos, estás de suerte. Hasta el 20 de noviembre…
La computación cuántica acaba de dar un salto gigante. John M. Martinis, recién galardonado con…
La biografía más vendida del cofundador de Apple, Steve Jobs; escrita por uno de los…
Hubo un tiempo en el que la “seguridad en el hogar” significaba confiar en un…
Elon Musk vuelve a romper todos los esquemas. Los accionistas de Tesla acaban de aprobar…