gemstash 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aaf9ebeef139205ff90579ee16b1cd307bc3669164704163bb9503b656532eb2
-  data.tar.gz: 7188adfcdde048e812747afc26e915efae2d502c305da21e6f692132d01a8028
+  metadata.gz: 41416a39e4dabbc11e7f8f1ad812dc34ffce3fbfa47c6f997feec01c083bf483
+  data.tar.gz: c274c1eac63e99d2001f946b117c020dd1fe5c25bdcaf1c31dd28e0668603b2d
 SHA512:
-  metadata.gz: 4a4326563fe277ae496e087a5e941d9f829cde351c1c1d92021061e4796cb612f081a73acece2e250a0220a660b631017a4372b401afbb30b4cfe4b95ac6618e
-  data.tar.gz: ff3b604ca9d7280b2ca0b72fa98c605e1b998eb3fcf9aa5801b6854c970c3d9c8f5d5c33732eb619bd8106dc86c27ee2ac6823cc2b14f2a2f8a7d44eb1383cae
+  metadata.gz: 94941045dd2f8232b5c55a79e775df4e89243d62ce88f22bd737d9dda3bf718a9d30b184b790677beba415c98243b3190c362cab800333993e6d89677592d398
+  data.tar.gz: 3f771fae6b0a388dd730978ec0721c83514d3479fd30f9211def6d7bad2ce5f9a83239bbfde091b450f32c053d0f763799e61aa9a9f95b947802dc2c1533275a

data/CHANGELOG.md

@@ -1,3 +1,60 @@
+## 2.1.0 (2020-02-26)
+
+### Bugfixes
+
+  - Shebang should be the first thing in the file ([#222](https://github.com/rubygems/gemstash/pull/222), [@bronzdoc](https://github.com/bronzdoc))
+
+### Changes
+
+  - Update rack-test requirement from ~> 0.6 to ~> 1.1 ([#199](https://github.com/rubygems/gemstash/pull/199), [@dependabot](https://github.com/dependabot))
+  - Update rake requirement from ~> 10.0 to ~> 12.3 ([#200](https://github.com/rubygems/gemstash/pull/200), [@dependabot](https://github.com/dependabot))
+  - CI matrix: Drop 2.0, 2.1, 2.2 ([#201](https://github.com/rubygems/gemstash/pull/201), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop version and update files to be inline with new cops ([#202](https://github.com/rubygems/gemstash/pull/202), [@bronzdoc](https://github.com/bronzdoc))
+  - Update rubocop requirement from = 0.60.0 to = 0.61.0 ([#208](https://github.com/rubygems/gemstash/pull/208), [@dependabot](https://github.com/dependabot))
+  - Update rubocop requirement from = 0.61.0 to = 0.61.1 ([#209](https://github.com/rubygems/gemstash/pull/209), [@dependabot](https://github.com/dependabot))
+  - Avoid Rubocop warnings ([#210](https://github.com/rubygems/gemstash/pull/210), [@olleolleolle](https://github.com/olleolleolle))
+  - RSpec: config.disable_monkey_patching! ([#211](https://github.com/rubygems/gemstash/pull/211), [@olleolleolle](https://github.com/olleolleolle))
+  - Travis: update JRuby to 9.2.5.0 ([#212](https://github.com/rubygems/gemstash/pull/212), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop requirement from = 0.61.1 to = 0.62.0 ([#213](https://github.com/rubygems/gemstash/pull/213), [@dependabot](https://github.com/dependabot))
+  - Update rubocop requirement from = 0.62.0 to = 0.63.0 ([#215](https://github.com/rubygems/gemstash/pull/215), [@dependabot](https://github.com/dependabot))
+  - gemspec: Allow Bundler 2 ([#217](https://github.com/rubygems/gemstash/pull/217), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop requirement from = 0.63.0 to = 0.63.1 ([#218](https://github.com/rubygems/gemstash/pull/218), [@dependabot](https://github.com/dependabot))
+  - Update rubocop requirement from = 0.63.1 to = 0.64.0 ([#220](https://github.com/rubygems/gemstash/pull/220), [@dependabot](https://github.com/dependabot))
+  - CI: matrix updates - update JRuby, add 2.6.1 ([#221](https://github.com/rubygems/gemstash/pull/221), [@olleolleolle](https://github.com/olleolleolle))
+  - Add a failing Aruba-based RSpec test for the CLI client output ([#223](https://github.com/rubygems/gemstash/pull/223), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop requirement from = 0.64.0 to = 0.65.0 ([#224](https://github.com/rubygems/gemstash/pull/224), [@dependabot](https://github.com/dependabot))
+  - CI: use 2.5.5, 2.6.2 ([#225](https://github.com/rubygems/gemstash/pull/225), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop requirement from = 0.65.0 to = 0.66.0 ([#226](https://github.com/rubygems/gemstash/pull/226), [@dependabot](https://github.com/dependabot), [@olleolleolle](https://github.com/olleolleolle), [@bronzdoc](https://github.com/bronzdoc))
+  - CI: Use 2.4.6 ([#228](https://github.com/rubygems/gemstash/pull/228), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop requirement from = 0.66.0 to = 0.67.1 ([#229](https://github.com/rubygems/gemstash/pull/229), [@dependabot](https://github.com/dependabot), [@olleolleolle](https://github.com/olleolleolle))
+  - CI: Drop 2.3.8 ([#230](https://github.com/rubygems/gemstash/pull/230), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop requirement from = 0.67.1 to = 0.67.2 ([#231](https://github.com/rubygems/gemstash/pull/231), [@dependabot](https://github.com/dependabot))
+  - CI: Use JRuby 9.2.7.0 ([#232](https://github.com/rubygems/gemstash/pull/232), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop requirement from = 0.67.2 to = 0.68.0 ([#233](https://github.com/rubygems/gemstash/pull/233), [@dependabot](https://github.com/dependabot), [@olleolleolle](https://github.com/olleolleolle))
+  - Update rubocop requirement from = 0.68.1 to = 0.69.0 ([#234](https://github.com/rubygems/gemstash/pull/234), [@dependabot](https://github.com/dependabot))
+  - Update rubocop requirement from = 0.69.0 to = 0.70.0 ([#235](https://github.com/rubygems/gemstash/pull/235), [@dependabot](https://github.com/dependabot))
+  - Set Travis badge to /rubygems user ([#236](https://github.com/rubygems/gemstash/pull/236), [@olleolleolle](https://github.com/olleolleolle))
+  - Fix broken links ([#240](https://github.com/rubygems/gemstash/pull/240), [@Aliciawyse](https://github.com/Aliciawyse))
+  - Fix various rubocop/codeclimate issues ([#241](https://github.com/rubygems/gemstash/pull/241), [@tchia04](https://github.com/tchia04))
+  - Fix some broken links in readme ([#243](https://github.com/rubygems/gemstash/pull/243), [@Aliciawyse](https://github.com/Aliciawyse))
+  - Improve webspec tests ([#244](https://github.com/rubygems/gemstash/pull/244), [@Aliciawyse](https://github.com/Aliciawyse))
+  - CI: Use jruby-9.2.8.0 ([#245](https://github.com/rubygems/gemstash/pull/245), [@olleolleolle](https://github.com/olleolleolle))
+  - CI: Use ruby 2.4.7, 2.5.6, 2.6.4 ([#246](https://github.com/rubygems/gemstash/pull/246), [@olleolleolle](https://github.com/olleolleolle))
+  - Add puma server pidfile configuration option ([#248](https://github.com/rubygems/gemstash/pull/248), [@krists](https://github.com/krists))
+  - CI: Use jruby-9.2.9.0 ([#249](https://github.com/rubygems/gemstash/pull/249), [@olleolleolle](https://github.com/olleolleolle))
+  - Officially drop support for older rubies ([#250](https://github.com/rubygems/gemstash/pull/250), [@deivid-rodriguez](https://github.com/deivid-rodriguez))
+  - Add config to ignore Gemfile source ([#253](https://github.com/rubygems/gemstash/pull/253), [@zpdcodes](https://github.com/zpdcodes))
+  - Update Puma gem ([#255](https://github.com/rubygems/gemstash/pull/255), [@bronzdoc](https://github.com/bronzdoc))
+  - Spec failures might be due to a bundler version ([#256](https://github.com/rubygems/gemstash/pull/256), [@bronzdoc](https://github.com/bronzdoc))
+  - Update spec homepage ([#257](https://github.com/rubygems/gemstash/pull/257), [@bronzdoc](https://github.com/bronzdoc))
+  - Update README.md links ([#258](https://github.com/rubygems/gemstash/pull/258), [@bronzdoc](https://github.com/bronzdoc))
+  - Add PR template ([#259](https://github.com/rubygems/gemstash/pull/259), [@bronzdoc](https://github.com/bronzdoc))
+  - Update docs ([#260](https://github.com/rubygems/gemstash/pull/260), [@bronzdoc](https://github.com/bronzdoc))
+
+### Features
+
+  - Add configuration options cache_expiration, cache_max_size ([#207](https://github.com/rubygems/gemstash/pull/207), [@optix2000](https://github.com/optix2000), [@olleolleolle](https://github.com/olleolleolle))
+
 ## 2.0.0 (2018-11-18)
 
 ### Changes

data/lib/gemstash/cache.rb

@@ -79,4 +79,41 @@ module Gemstash
       @cache[key] = value
     end
   end
+
+  # Wrapper around the redis-rb gem to behave like a dalli Memcached client.
+  class RedisClient
+    extend Forwardable
+
+    def_delegator :@cache, :del, :delete
+
+    def initialize(redis_servers)
+      require "redis"
+      @cache = ::Redis.new(:url => redis_servers)
+    end
+
+    def alive!
+      @cache.ping == "PONG"
+    end
+
+    def get(key)
+      val = @cache.get(key)
+      YAML.load(val) unless val.nil?
+    end
+
+    def get_multi(keys)
+      @cache.mget(*keys).each do |k, v|
+        next if v.nil?
+
+        yield(k, YAML.load(v))
+      end
+    end
+
+    def set(key, value, expiry)
+      @cache.set(key, YAML.dump(value), :ex => expiry)
+    end
+
+    def flush
+      @cache.flushdb
+    end
+  end
 end

data/lib/gemstash/cli/authorize.rb

@@ -30,7 +30,7 @@ module Gemstash
           raise Gemstash::CLI::Error.new(@cli, "To remove individual permissions, you do not need --remove
 Instead just authorize with the new set of permissions")
         end
-        Gemstash::Authorization.remove(auth_key(false))
+        Gemstash::Authorization.remove(auth_key(allow_generate: false))
       end
 
       def save_authorization
@@ -46,7 +46,7 @@ Instead just authorize with the new set of permissions")
         Gemstash::Authorization.authorize(auth_key, permissions)
       end
 
-      def auth_key(allow_generate = true)
+      def auth_key(allow_generate: true)
         if @cli.options[:key]
           @cli.options[:key]
         elsif allow_generate

data/lib/gemstash/cli/setup.rb

@@ -76,8 +76,9 @@ module Gemstash
 
       def ask_cache
         say_current_config(:cache_type, "Current cache")
-        @config[:cache_type] = ask_with_default("Cache with what?", %w[memory memcached], "memory")
+        @config[:cache_type] = ask_with_default("Cache with what?", %w[memory memcached redis], "memory")
         ask_memcached_details if @config[:cache_type] == "memcached"
+        ask_redis_details if @config[:cache_type] == "redis"
       end
 
       def ask_memcached_details
@@ -87,6 +88,13 @@ module Gemstash
         @config[:memcached_servers] = servers
       end
 
+      def ask_redis_details
+        say_current_config(:redis_servers, "Current Redis servers")
+        servers = @cli.ask "What is the comma-separated list of Redis servers? [localhost:6379]"
+        servers = "localhost:6379" if servers.empty?
+        @config[:redis_servers] = servers
+      end
+
       def ask_database
         say_current_config(:db_adapter, "Current database adapter")
         @config[:db_adapter] = ask_with_default("What database adapter?", %w[sqlite3 postgres mysql mysql2], "sqlite3")
@@ -181,9 +189,9 @@ module Gemstash
         gemstash_env.reset
       end
 
-      def try(thing)
+      def try(thing, &block)
         @cli.say "Checking that the #{thing} is available"
-        with_new_config { yield }
+        with_new_config(&block)
       rescue StandardError => e
         say_error "Error checking #{thing}", e
         raise Gemstash::CLI::Error.new(@cli, "The #{thing} is not available")

data/lib/gemstash/configuration.rb

@@ -4,7 +4,7 @@ require "yaml"
 require "erb"
 
 module Gemstash
-  #:nodoc:
+  # :nodoc:
   class Configuration
     DEFAULTS = {
       cache_type: "memory",

data/lib/gemstash/dependencies.rb

@@ -4,7 +4,7 @@ require "cgi"
 require "set"
 
 module Gemstash
-  #:nodoc:
+  # :nodoc:
   class Dependencies
     def self.for_private
       new(scope: "private", db_model: Gemstash::DB::Dependency)
@@ -24,7 +24,7 @@ module Gemstash
       Fetcher.new(gems, @scope, @http_client, @db_model).fetch
     end
 
-    #:nodoc:
+    # :nodoc:
     class Fetcher
       include Gemstash::Env::Helper
       include Gemstash::Logging

data/lib/gemstash/env.rb

@@ -170,6 +170,8 @@ module Gemstash
           Gemstash::LruReduxClient.new
         when "memcached"
           Dalli::Client.new(config[:memcached_servers])
+        when "redis"
+          Gemstash::RedisClient.new(config[:redis_servers])
         else
           raise "Invalid cache client: '#{config[:cache_type]}'"
         end

data/lib/gemstash/gem_fetcher.rb

@@ -4,11 +4,11 @@ require "gemstash"
 require "set"
 
 module Gemstash
-  #:nodoc:
+  # :nodoc:
   class GemFetcher
     def initialize(http_client)
       @http_client = http_client
-      @valid_headers = Set.new(["etag", "content-type", "content-length", "last-modified"])
+      @valid_headers = Set.new(%w[etag content-type content-length last-modified])
     end
 
     def fetch(gem_id, type, &block)

data/lib/gemstash/gem_pusher.rb

@@ -4,7 +4,7 @@ require "gemstash"
 require "rubygems/package"
 require "stringio"
 
-#:nodoc:
+# :nodoc:
 module Gemstash
   # Class that supports pushing a new gem to the private repository of gems.
   class GemPusher
@@ -127,6 +127,6 @@ module Gemstash
       end
     end
 
-    GemPusher.send(:include, LegacyRubyGemsSupport)
+    GemPusher.include LegacyRubyGemsSupport
   end
 end

data/lib/gemstash/gem_source/private_source.rb

@@ -47,7 +47,7 @@ module Gemstash
       end
 
       def serve_versions
-        halt 403, "Not yet supported"
+        halt 404, "Not yet supported"
       end
 
       def serve_info(name)
@@ -57,7 +57,7 @@ module Gemstash
       def serve_marshal(id)
         authorization.protect(self) do
           auth.check("fetch") if gemstash_env.config[:protected_fetch]
-          gem_full_name = id.sub(/\.gemspec\.rz\z/, "")
+          gem_full_name = id.delete_suffix(".gemspec.rz")
           gem = fetch_gem(gem_full_name)
           halt 404 unless gem.exist?(:spec)
           content_type "application/octet-stream"
@@ -72,7 +72,7 @@ module Gemstash
       def serve_gem(id)
         authorization.protect(self) do
           auth.check("fetch") if gemstash_env.config[:protected_fetch]
-          gem_full_name = id.sub(/\.gem\z/, "")
+          gem_full_name = id.delete_suffix(".gem")
           gem = fetch_gem(gem_full_name)
           content_type "application/octet-stream"
           gem.content(:gem)

data/lib/gemstash/gem_source.rb

@@ -4,7 +4,7 @@ require "gemstash"
 require "forwardable"
 
 module Gemstash
-  #:nodoc:
+  # :nodoc:
   module GemSource
     autoload :DependencyCaching, "gemstash/gem_source/dependency_caching"
     autoload :PrivateSource,     "gemstash/gem_source/private_source"
@@ -29,7 +29,7 @@ module Gemstash
       include Gemstash::Logging
 
       def_delegators :@app, :cache_control, :content_type, :env, :halt,
-        :headers, :http_client_for, :params, :redirect, :request
+                     :headers, :http_client_for, :params, :redirect, :request
 
       def initialize(app)
         @app = app

data/lib/gemstash/http_client.rb

@@ -5,7 +5,7 @@ require "faraday"
 require "faraday_middleware"
 
 module Gemstash
-  #:nodoc:
+  # :nodoc:
   class WebError < StandardError
     attr_reader :code
 
@@ -15,14 +15,14 @@ module Gemstash
     end
   end
 
-  #:nodoc:
+  # :nodoc:
   class ConnectionError < WebError
     def initialize(message)
       super(message, 502) # Bad Gateway
     end
   end
 
-  #:nodoc:
+  # :nodoc:
   class HTTPClient
     extend Gemstash::Env::Helper
     include Gemstash::Logging
@@ -35,12 +35,17 @@ module Gemstash
         config.adapter :net_http
         config.options.timeout = gemstash_env.config[:fetch_timeout]
       end
+
+      client.basic_auth(upstream.user, upstream.password) if upstream.auth?
+
       user_agent = "#{upstream.user_agent} " unless upstream.user_agent.to_s.empty?
       user_agent = user_agent.to_s + DEFAULT_USER_AGENT
 
       new(client, user_agent: user_agent)
     end
 
+    attr_reader :client
+
     def initialize(client = nil, user_agent: nil)
       @client = client
       @user_agent = user_agent || DEFAULT_USER_AGENT

data/lib/gemstash/logging.rb

@@ -4,7 +4,7 @@ require "logger"
 require "puma/events"
 
 module Gemstash
-  #:nodoc:
+  # :nodoc:
   module Logging
     LEVELS = {
       debug: Logger::DEBUG,

data/lib/gemstash/man/gemstash-authorize.1.txt

@@ -1,46 +1 @@
-gemstash-authorize(1)					 gemstash-authorize(1)
 
-
-
-1mNAME0m
-       gemstash-authorize  -  Adds  or	removes authorization to interact with
-       privately stored gems
-
-1mSYNOPSIS0m
-       gemstash authorize [permissions] [--remove] [--key SECURE_KEY]  [--con-
-       fig-file FILE]
-
-1mDESCRIPTION0m
-       Adds or removes authorization to interact with privately stored gems.
-
-       Any  arguments will be used as specific permissions.  Valid permissions
-       include push, yank, and fetch.  If no permissions  are  provided,  then
-       all permissions will be granted (including any that may be added in fu-
-       ture versions of Gemstash).
-
-   1mUSAGE0m
-	      gemstash authorize
-	      gemstash authorize push yank
-	      gemstash authorize yank --key <secure-key>
-	      gemstash authorize --remove --key <secure-key>
-
-1mOPTIONS0m
-       o --config-file FILE: Specify the config file to use.   If  you	aren't
-	 using	the  default  config file at ~/.gemstash/config.yml or ~/.gem-
-	 stash/config.yml.erb (gemstash help customize.7), then you must spec-
-	 ify the config file via this option.
-
-       o --key	SECURE_KEY: Specify the API key to affect.  This should be the
-	 actual key value, not a name.	This option  is	 required  when	 using
-	 --remove  but is optional otherwise.  If adding an authorization, us-
-	 ing this will either create or update the permissions for the	speci-
-	 fied  API  key.   If missing, a new API key will always be generated.
-	 Note that a key can only have a maximum length of 255 chars.
-
-       o --remove: Remove an authorization rather  than	 add  or  update  one.
-	 When  removing,  permission  values  are not allowed.	The --key <se-
-	 cure-key> option is required.
-
-
-
-				October 9, 2015		 gemstash-authorize(1)

data/lib/gemstash/man/gemstash-configuration.5.txt

@@ -1,210 +1 @@
-gemstash-configuration(5)			     gemstash-configuration(5)
 
-
-
-1mNAME0m
-       gemstash-configuration
-
-1mSYNOPSIS0m
-	      # ~/.gemstash/config.yml
-	      ---
-	      :base_path: "/var/gemstash"
-	      :cache_type: memcached
-	      :memcached_servers: localhost:11211
-	      :db_adapter: postgres
-	      :db_url: postgres:///gemstash
-	      :db_connection_options:
-		:test: true
-		:pool_timeout: 2
-	      :rubygems_url: https://my.gem-source.local
-	      :ignore_gemfile_source: false
-	      :puma_threads: 32
-	      :bind: tcp://0.0.0.0:4242
-	      :protected_fetch: true
-	      :fetch_timeout: 10
-	      :log_file: gemstash.log
-
-1mBASE PATH0m
-       :base_path
-
-       Specifies  where	 to  store local files like the server log, cached gem
-       files, and the database (when using SQLite).  If the default  is	 being
-       used,  the  directory  will be created if it does not exist.  Any other
-       directory needs to be created ahead of time and be writable to the Gem-
-       stash  server  process.	 Specifying  the :base_path via gemstash setup
-       (gemstash help setup.1) will create the directory for you.
-
-   1mDEFAULT VALUE0m
-       ~/.gemstash
-
-   1mVALID VALUES0m
-       Any valid path
-
-1mCACHE TYPE0m
-       :cache_type
-
-       Specifies how to cache values other than gem files (such as gem	depen-
-       dencies).   memory  will	 use  an  in memory cache while memcached will
-       point to 1 or more Memcached servers.  Use the :memcached_servers  con-
-       figuration key for specifying where the Memcached server(s) are.
-
-   1mDEFAULT VALUE0m
-       memory
-
-   1mVALID VALUES0m
-       memory, memcached
-
-1mMEMCACHED SERVERS0m
-       :memcached_servers
-
-       Specifies  the Memcached servers to connect to when using memcached for
-       the :cache_type.	 Only used when memcached is used for :cache_type.
-
-   1mDEFAULT VALUE0m
-       localhost:11211
-
-   1mVALID VALUES0m
-       A comma delimited list of Memcached servers
-
-1mDB ADAPTER0m
-       :db_adapter
-
-       Specifies what database adapter to use.	 When  sqlite3	is  used,  the
-       database	 will be located at gemstash.db within the directory specified
-       by :base_path.  The database will automatically be created  when	 using
-       sqlite3.	 When postgres, mysql, or mysql2 is used, the database to con-
-       nect to must be specified in the :db_url configuration key.  The	 data-
-       base must already be created when using anything other than sqlite3.
-
-   1mDEFAULT VALUE0m
-       sqlite3
-
-   1mVALID VALUES0m
-       sqlite3, postgres, mysql, mysql2
-
-1mDB URL0m
-       :db_url
-
-       Specifies  the  database	 to  connect to when using postgres, mysql, or
-       mysql2 for the :db_adapter.  Only used  when  the  :db_adapter  is  not
-       sqlite3.
-
-   1mDEFAULT VALUE0m
-       None
-
-   1mVALID VALUES0m
-       A  valid	 database  URL	for  the  Sequel  gem  (http://sequel.jeremye-
-       vans.net/)
-
-1mDB CONNECTION OPTIONS0m
-       :db_connection_options
-
-       Specifies additional Sequel.connect options to use.  Note that any  op-
-       tions  here  are	 merged	 in  with the default options, so you need not
-       specify the max_connections if you customize this option.
-
-   1mDEFAULT VALUE0m
-       { max_connections: 1 } for sqlite3  adapter,  {	max_connections:  con-
-       fig[:puma_threads] + 1 } for any other adapter.
-
-   1mVALID VALUES0m
-       A  valid	 connection  options  Hash  for the Sequel.connect (http://se-
-       quel.jeremyevans.net/rdoc/files/doc/opening_databases_rdoc.html#label-
-       General+connection+options) method.
-
-1mRUBYGEMS URL0m
-       :rubygems_url
-
-       Specifies  the default gem source URL.  When any API endpoint is called
-       without a /private or /upstream/<url> prefix, this URL will be used  to
-       fetch  the  result.  This value can be safely changed even if there are
-       already gems stashed for the previous value.
-
-   1mDEFAULT VALUE0m
-       https://rubygems.org
-
-   1mVALID VALUES0m
-       A valid gem source URL
-
-1mIGNORE GEMFILE SOURCE0m
-       :ignore_gemfile_source
-
-       Ignore the source specified in Gemfile and always use :rubygems_url  as
-       gems upstream.
-
-   1mDEFAULT VALUE0m
-       false
-
-   1mVALID VALUES0m
-       Boolean: true or false
-
-1mPUMA THREADS0m
-       :puma_threads
-
-       Specifies the number of threads used for the Gemstash server.
-
-   1mDEFAULT VALUE0m
-       16
-
-   1mVALID VALUES0m
-       Integer value with a minimum of 1
-
-1mBIND ADDRESS0m
-       :bind
-
-       Specifies  the binding used to start the Gemstash server.  Keep in mind
-       the user starting Gemstash needs to have access to bind in this manner.
-       For  example,  if  you use a port below 1024, you will need to run Gem-
-       stash as the root user.
-
-   1mDEFAULT VALUE0m
-       tcp://0.0.0.0:9292
-
-   1mVALID VALUES0m
-       Any     valid	 binding     that     is     supported	   by	  Puma
-       (https://github.com/puma/puma#binding-tcp--sockets)
-
-1mPROTECTED FETCH0m
-       :protected_fetch
-
-       Tells  Gemstash	to  authenticate  via  an  API key before allowing the
-       fetching of private gems and specs.  The default behavior is  to	 allow
-       unauthenticated download of private gems and specs.
-
-   1mDEFAULT VALUE0m
-       false
-
-   1mVALID VALUES0m
-       Boolean values true or false
-
-1mFETCH TIMEOUT0m
-       :fetch_timeout
-
-       The  timeout setting for fetching gems.	Fetching gems over a slow con-
-       nection may cause timeout errors.  If you  experience  timeout  errors,
-       you may want to increase this value.  The default is 20 seconds.
-
-   1mDEFAULT VALUE0m
-       20
-
-   1mVALID VALUES0m
-       Integer value with a minimum of 1
-
-1mLOG FILE0m
-       :log_file
-
-       Indicates  the  name  of the file to use for logging.  The file will be
-       placed in the base path (gemstash help configuration.5).
-
-   1mDEFAULT VALUE0m
-       server.log
-
-   1mVALID VALUES0m
-       Any valid file name, or :stdout to log to $stdout
-
-       4mNote:24m 4mUsing24m 4m:stdout24m 4mfor24m 4mthe24m 4m:log_file24m 4mrequires24m 4mrunning24m 4mwith24m 4m--no-daemo-0m
-       4mnize24m 4m(gemstash24m 4mhelp24m 4mstart.1).0m
-
-
-
-			       October 13, 2015	     gemstash-configuration(5)