bitclust-core 1.3.0 → 1.6.0

data/lib/bitclust/subcommands/chm_command.rb

@@ -134,7 +134,7 @@ EOS
         end
 
         def method_url(spec)
-          cname, tmark, mname = *split_method_spec(spec)
+          cname, tmark, mname = split_method_spec(spec)
           "/method/#{encodename_fs(cname)}/#{typemark2char(tmark)}/#{encodename_fs(mname)}.html"
         end
 
@@ -170,6 +170,7 @@ EOS
         manager = ScreenManager.new(@manager_config)
         @html_files = []
         db.transaction do
+          # @type var methods: Hash[String, Array[MethodEntry]]
           methods = {}
           db.methods.each do |entry|
             method_name = entry.klass.name + entry.typemark + entry.name
@@ -184,6 +185,7 @@ EOS
             e = c.is_a?(Array) ? c.sort.first : c
             case e.type_id
             when :library
+              # @type var e: LibraryEntry
               content = Sitemap::Content.new(e.name.to_s, filename)
               if e.name.to_s != '_builtin'
                 @sitemap[:library][1] << content
@@ -191,6 +193,7 @@ EOS
               end
               @index_contents << Sitemap::Content.new(e.name.to_s, filename)
             when :class
+              # @type var e: ClassEntry
               content = Sitemap::Content.new(e.name.to_s, filename)
               if e.library.name.to_s == '_builtin'
                 @sitemap[:library][0] << content
@@ -199,12 +202,15 @@ EOS
               end
               @index_contents << Sitemap::Content.new("#{e.name} (#{e.library.name})", filename)
             when :method
+              # @type var e: MethodEntry
               e.names.each do |e_name|
                 name = e.typename == :special_variable ? "$#{e_name}" : e_name
                 @index_contents <<
                   Sitemap::Content.new("#{name} (#{e.library.name} - #{e.klass.name})", filename)
+                # bitclust#250: CHM の索引(.hhk)に出る表示ラベル。4.0 以降の
+                # ドキュメントでは module function を "?." で表示する
                 @index_contents <<
-                  Sitemap::Content.new("#{e.klass.name}#{e.typemark}#{name} (#{e.library.name})", filename)
+                  Sitemap::Content.new("#{e.klass.name}#{e.display_typemark}#{name} (#{e.library.name})", filename)
               end
             end
             pb.title = align_progress_bar_title(e.name)
@@ -219,7 +225,7 @@ EOS
         create_file(@outputdir + 'library/index.html', manager.library_index_screen(db.libraries.sort, {:database => db}).body)
         create_file(@outputdir + 'class/index.html', manager.class_index_screen(db.classes.sort, {:database => db}).body)
         FileUtils.cp(@manager_config[:themedir] + @manager_config[:css_url],
-                     @outputdir.to_s, {:verbose => true, :preserve => true})
+                     @outputdir.to_s, verbose: true, preserve: true)
       end
 
       private
@@ -243,15 +249,17 @@ EOS
                     "\u0308" => "\u2025",
                     "\u2014" => "\u2015",
                     "\u2212" => "\uff0d",
-                    "\u301c" => "\uff5e" } 
+                    "\u301c" => "\uff5e" }
 
       def create_html_file(entry, manager, outputdir, db)
         html = manager.entry_screen(entry, {:database => db}).body
         e = entry.is_a?(Array) ? entry.sort.first : entry
         path = case e.type_id
                when :library, :class, :doc
-                 outputdir + e.type_id.to_s + (NameUtils.encodename_fs(e.name) + '.html')
+                # @type var e: LibraryEntry | ClassEntry | DocEntry
+                outputdir + e.type_id.to_s + (NameUtils.encodename_fs(e.name) + '.html')
                when :method
+                # @type var e: MethodEntry
                  outputdir + e.type_id.to_s + NameUtils.encodename_fs(e.klass.name) +
                    e.typechar + (NameUtils.encodename_fs(e.name) + '.html')
                else
@@ -261,7 +269,7 @@ EOS
 
         begin
           new_html = html.gsub(/charset=utf-8/i, 'charset=Windows-31J').
-                     encode('windows-31j', { :fallback => FIX_UNDEF })
+                     encode('windows-31j', fallback: FIX_UNDEF)
           mode = 'w:windows-31j'
         rescue
           new_html = html # write file as it is, utf-8
@@ -277,7 +285,7 @@ EOS
         $stderr.print("creating #{path} ...")
         str = ERB.new(skel).result(binding).
               gsub(/charset=utf-8/i, 'charset=Windows-31J').
-              encode('windows-31j', { :fallback => FIX_UNDEF } )
+              encode('windows-31j', fallback: FIX_UNDEF)
         path.open('w:windows-31j') do |f|
           f.write(str)
         end

data/lib/bitclust/subcommands/classes_command.rb

@@ -27,6 +27,11 @@ module BitClust
         option_error('wrong number of arguments') unless argv.size == 1
       end
 
+      # システムの ruby を調べるだけで DB を使わない
+      def needs_database?
+        false
+      end
+
       def exec(argv, options)
         lib = argv[0]
         print_crossruby_table {|ruby| defined_classes(ruby, lib, @rejects) }

data/lib/bitclust/subcommands/extract_command.rb

@@ -17,6 +17,11 @@ module BitClust
         }
       end
 
+      # ソースファイルを処理するだけで DB を使わない
+      def needs_database?
+        false
+      end
+
       def exec(argv, options)
         success = true
         argv.each do |path|

data/lib/bitclust/subcommands/htmlfile_command.rb

@@ -16,13 +16,13 @@ module BitClust
         @target = nil
         @templatedir = srcdir_root + "data/bitclust/template.offline"
         @baseurl = "file://" + srcdir_root.to_s
-        @version = "2.0.0"
+        @version = RUBY_VERSION
         @parser.banner = "Usage: #{File.basename($0, '.*')} htmlfile [options] rdfile"
         @parser.on('--target=NAME', 'Compile NAME to HTML.') {|name|
           @target = name
         }
-        @parser.on('--force', '-f', 'Force to use rd_file template.') {|name|
-          @rd_file = true
+        @parser.on('--[no-]force', '-f', 'Force to use rd_file template.') {|bool|
+          @rd_file = bool
         }
         @parser.on('--ruby_version=VER', '--ruby=VER', 'Set Ruby version') {|version|
           @version = version
@@ -35,6 +35,11 @@ module BitClust
         }
       end
 
+      # DB は与えられれば使うが必須ではない (--database は任意)
+      def needs_database?
+        false
+      end
+
       def exec(argv, options)
         db = MethodDatabase.dummy({'version' => @version})
         if options[:prefix]
@@ -42,7 +47,10 @@ module BitClust
         end
         @capi = options[:capi]
         target_file = argv[0]
-        options = { 'version' => @version }
+        if /refm\/doc\// =~ target_file
+          @rd_file = true if @rd_file.nil?
+        end
+        options = { 'version' => @version } #: Database::database_properties
         manager = ScreenManager.new(:templatedir => @templatedir,
                                     :base_url => @baseurl,
                                     :cgi_url => @baseurl,
@@ -59,11 +67,11 @@ module BitClust
               lib = RRDParser.parse_stdlib_file(target_file, options)
             end
             entry = @target ? lookup(lib, @target) : lib
-            puts manager.entry_screen(entry, { :database => db }).body
+            puts manager.entry_screen(entry, { :database => db, :target_version => @version }).body
             return
           rescue ParseError => ex
             $stderr.puts ex.message
-            $stderr.puts ex.backtrace[0], ex.backtrace[1..-1].map{|s| "\tfrom " + s}
+            $stderr.puts ex.backtrace[0], ex.backtrace[1..-1]&.map{|s| "\tfrom " + s}
           end
         end
 
@@ -83,8 +91,12 @@ module BitClust
       def lookup(lib, key)
         case
         when @capi && NameUtils.functionname?(key)
-          lib.find {|func| func.name == key}
+          # @type var lib: Array[FunctionEntry]
+          lib.is_a?(Array) or raise
+          lib.find {|func| func.name == key} or raise
         when NameUtils.method_spec?(key)
+          # @type var lib: LibraryEntry
+          lib.is_a?(LibraryEntry) or raise
           spec = MethodSpec.parse(key)
           if spec.constant?
             begin
@@ -96,6 +108,8 @@ module BitClust
             lib.fetch_methods(spec)
           end
         when NameUtils.classname?(key)
+          # @type var lib: LibraryEntry
+          lib.is_a?(LibraryEntry) or raise
           lib.fetch_class(key)
         else
           raise InvalidKey, "wrong search key: #{key.inspect}"

data/lib/bitclust/subcommands/init_command.rb

@@ -20,12 +20,15 @@ module BitClust
       STANDARD_PROPERTIES = %w( encoding version )
 
       def exec(argv, options)
-        prefix = options[:prefix]
+        prefix = options[:prefix] || raise
         db = MethodDatabase.new(prefix)
         db.init
         db.transaction {
           argv.each do |kv|
             k, v = kv.split('=', 2)
+            if k.nil? || v.nil?
+              raise "argument must be KEY=VALUE, but #{kv.inspect}"
+            end
             db.propset k, v
           end
         }

data/lib/bitclust/subcommands/list_command.rb

@@ -41,21 +41,29 @@ module BitClust
         super
         case @mode
         when :library
-          @db.libraries.map {|lib| lib.name }.sort.each do |name|
+          db = @db
+          db.is_a?(MethodDatabase) or raise "invalid database given. Use without --capi option"
+          db.libraries.map {|lib| lib.name }.sort.each do |name|
             puts name
           end
         when :class
-          @db.classes.map {|c| c.name }.sort.each do |name|
+          db = @db
+          db.is_a?(MethodDatabase) or raise "invalid database given. Use without --capi option"
+          db.classes.map {|c| c.name }.sort.each do |name|
             puts name
           end
         when :method
-          @db.classes.sort_by {|c| c.name }.each do |c|
+          db = @db
+          db.is_a?(MethodDatabase) or raise "invalid database given. Use without --capi option"
+          db.classes.sort_by {|c| c.name }.each do |c|
             c.entries.sort_by {|m| m.id }.each do |m|
               puts m.label
             end
           end
         when :function
-          @db.functions.sort_by {|f| f.name }.each do |f|
+          db = @db
+          db.is_a?(FunctionDatabase) or raise "invalid database given. Use with --capi option"
+          db.functions.sort_by {|f| f.name }.each do |f|
             puts f.name
           end
         else

data/lib/bitclust/subcommands/lookup_command.rb

@@ -51,19 +51,23 @@ module BitClust
 
       def exec(argv, options)
         super
-        entry = fetch_entry(@db, @type, @key)
-        puts fill_template(get_template(@type, @format), entry)
+        entry = fetch_entry(@db, @type, @key || raise)
+        puts fill_template(get_template(@type || raise, @format || raise), entry)
       end
 
       def fetch_entry(db, type, key)
         case type
         when :library
+          # @type var db: MethodDatabase
           db.fetch_library(key)
         when :class
+          # @type var db: MethodDatabase
           db.fetch_class(key)
         when :method
+          # @type var db: MethodDatabase
           db.fetch_method(MethodSpec.parse(key))
         when :function
+          # @type var db: FunctionDatabase
           db.fetch_function(key)
         else
           raise "must not happen: #{type.inspect}"
@@ -96,7 +100,7 @@ module BitClust
            <dt>classes</dt><dd><%= entry.classes.map {|c| c.name }.sort.join(', ') %></dd>
            <dt>methods</dt><dd><%= entry.methods.map {|m| m.name }.sort.join(', ') %></dd>
            </dl>
-           <%= compile_rd(entry.source) %>
+           <%= compile_rd(entry) %>
            End
         },
         :class   => {
@@ -119,7 +123,7 @@ module BitClust
            <dt>singleton_methods</dt><dd><%= entry.singleton_methods.map {|m| m.name }.sort.join(', ') %></dd>
            <dt>instance_methods</dt><dd><%= entry.instance_methods.map {|m| m.name }.sort.join(', ') %></dd>
            </dl>
-           <%= compile_rd(entry.source) %>
+           <%= compile_rd(entry) %>
            End
         },
         :method  => {
@@ -142,7 +146,7 @@ module BitClust
            <dt>kind</dt><dd><%= entry.kind %></dd>
            <dt>library</dt><dd><%= entry.library.name %></dd>
            </dl>
-           <%= compile_rd(entry.source) %>
+           <%= compile_rd(entry) %>
            End
         },
         :function => {
@@ -159,16 +163,31 @@ module BitClust
            <dt>header</dt><dd><%= entry.header %></dd>
            <dt>filename</dt><dd><%= entry.filename %></dd>
            </dl>
-           <%= compile_rd(entry.source) %>
+           <%= compile_rd(entry) %>
            End
         }
       }
 
-      def compile_rd(src)
+      def compile_rd(entry)
         umap = URLMapper.new(:base_url => 'http://example.com',
                              :cgi_url  => 'http://example.com/view')
-        compiler = RDCompiler.new(umap, 2)
-        compiler.compile(src)
+        if @db.properties['source_format'] == 'markdown'
+          # md ソースの DB は screen.rb と同じく MDCompiler（GFM）で描画する
+          Kernel.require 'bitclust/mdcompiler'
+          compiler = MDCompiler.new(umap, 2, { :gfm => true, :database => @db })
+        else
+          compiler = RDCompiler.new(umap, 2, { :database => @db })
+        end
+        # シグネチャ行の描画（permalink の id 等）はエントリ文脈を要求する
+        # ので、compile ではなくエントリ種別ごとの compile_* を使う
+        case entry
+        when MethodEntry
+          compiler.compile_method(entry)
+        when FunctionEntry
+          compiler.compile_function(entry)
+        else
+          compiler.compile(entry.source)
+        end
       end
     end
   end

data/lib/bitclust/subcommands/methods_command.rb

@@ -46,6 +46,11 @@ module BitClust
         option_error("wrong number of arguments") unless argv.size == 1
       end
 
+      # システムの ruby とリファレンスファイルを比較するだけで DB を使わない
+      def needs_database?
+        false
+      end
+
       def exec(argv, options)
         classname = argv[0]
         case @mode
@@ -60,6 +65,7 @@ module BitClust
           c = lib.fetch_class(classname)
           list0 = lib.classes.find_all{|c0| /\A#{classname}\b/o =~ c0.name }
           list0 = c.entries + list0
+          # @type var list: Array[String]
           list = list0.map {|ent| ent.labels.map {|n| expand_mf(n) } }.flatten
           if @content
             ri = @ri_path ? RiDatabase.open(@ri_path, nil) : RiDatabase.open_system_db
@@ -72,7 +78,7 @@ module BitClust
                 puts fmt.method_info(mthd.entry)
               else
                 name = name.sub(/\A\w+#/, '')
-                puts "--- #{name}\n\#@todo\n\n"
+                puts "--- #{name}\n#%todo\n\n"
               end
             end
           else
@@ -84,7 +90,7 @@ module BitClust
             end
           end
         else
-          raise "must not happen: #{mode.inspect}"
+          raise "must not happen: #{@mode.inspect}"
         end
       end
 
@@ -104,6 +110,8 @@ module BitClust
 
       def m_order(m)
         m, t = *m.reverse.split(/(\#|\.|::)/, 2)
+        m or raise
+        t or raise
         [ORDER[t] || 0, m.reverse]
       end
 

data/lib/bitclust/subcommands/methodsince_command.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+#
+# bitclust/subcommands/methodsince_command.rb
+#
+# Fills per-name since/until into method entries by scanning a version
+# ladder of databases:
+#
+#   bitclust methodsince --update=db-3.4 db-1.8.7 db-1.9.3 ... db-3.3 db-3.4
+#
+# Every positional argument and every --update path together form the
+# version ladder used to compute presence; --update paths are additionally
+# written back to (see bitclust/method_since_calculator.rb, bitclust#132 P2).
+#
+
+require 'bitclust'
+require 'bitclust/subcommand'
+require 'bitclust/method_since_calculator'
+require 'tmpdir'
+require 'fileutils'
+
+module BitClust
+  module Subcommands
+    class MethodsinceCommand < Subcommand
+      def initialize
+        super
+        @updates = []
+        @dry_run = false
+        @parser.banner = "Usage: #{File.basename($0, '.*')} methodsince [options] <dbpath>..."
+        @parser.on('--update=PATH', 'Writable target database to fill in-place (repeatable).') {|path|
+          @updates.push path
+        }
+        @parser.on('--dry-run', 'Compute and print stats without saving.') {
+          @dry_run = true
+        }
+      end
+
+      # DB パスは自前の引数(位置引数 + --update)で受けるので、
+      # グローバル --database は不要
+      def needs_database?
+        false
+      end
+
+      def exec(argv, options)
+        error("no --update given (nothing to write to)") if @updates.empty?
+
+        ladder_paths = (argv + @updates).uniq {|path| File.expand_path(path) }
+        calculator = MethodSinceCalculator.new(ladder_paths.map {|path| MethodDatabase.new(path) })
+        calculator.scan
+
+        @updates.each do |path|
+          stats, version = @dry_run ? apply_dry_run(calculator, path) : apply_and_save(calculator, path)
+          puts "#{File.basename(path)} (version #{version}): " \
+               "entries_updated=#{stats[:entries_updated]} since_filled=#{stats[:since_filled]} " \
+               "until_filled=#{stats[:until_filled]} floor_skipped=#{stats[:floor_skipped]}"
+        end
+      end
+
+      private
+
+      def apply_and_save(calculator, path)
+        target = MethodDatabase.new(path)
+        version = target.propget('version') or
+          error("#{path}: no version property (not a bitclust database?)")
+        [calculator.apply(target), version]
+      end
+
+      # --dry-run: 実際のデータベースには一切書き込まず、複製に対して
+      # apply した結果の統計だけを見せる
+      def apply_dry_run(calculator, path)
+        version = MethodDatabase.new(path).propget('version') or
+          error("#{path}: no version property (not a bitclust database?)")
+        Dir.mktmpdir do |tmp|
+          copy = File.join(tmp, 'db')
+          FileUtils.cp_r(path, copy)
+          [calculator.apply(MethodDatabase.new(copy)), version]
+        end
+      end
+    end
+  end
+end

data/lib/bitclust/subcommands/preproc_command.rb

@@ -18,6 +18,11 @@ module BitClust
         }
       end
 
+      # ソースファイルを処理するだけで DB を使わない
+      def needs_database?
+        false
+      end
+
       def exec(argv, options)
         argv.each do |path|
           File.open(path) {|file|

data/lib/bitclust/subcommands/property_command.rb

@@ -49,7 +49,7 @@ module BitClust
       end
 
       def exec(argv, options)
-        prefix = options[:prefix]
+        prefix = options[:prefix] || raise
         db = MethodDatabase.new(prefix)
         case @mode
         when :list
@@ -62,6 +62,7 @@ module BitClust
           end
         when :set
           key, val = *argv
+          key || raise; val || raise
           db.transaction {
             db.propset key, val
           }

data/lib/bitclust/subcommands/searchpage_command.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+#
+# bitclust/subcommands/searchpage_command.rb
+#
+# Generates a standalone, cross-version, client-side search page from
+# multiple version databases:
+#
+#   bitclust searchpage --outputdir=DIR db-3.0 db-3.1 ... db-4.1
+#
+# The output (index.html + js/search_data.js + assets) is fully static and
+# replaces the server-backed rurema-search app at docs.ruby-lang.org/ja/search/.
+# Each database's version is read from its own properties, and the merged
+# index tags every entry with the versions it appears in.
+#
+
+require 'pathname'
+require 'fileutils'
+require 'json'
+require 'optparse'
+
+require 'bitclust'
+require 'bitclust/subcommand'
+require 'bitclust/search_index_generator'
+
+module BitClust
+  module Subcommands
+    class SearchpageCommand < Subcommand
+      # search_init.js is the in-page dropdown wiring used by statichtml
+      # layouts; this page ships its own wiring (search_page.js) instead.
+      VENDORED_JS_FILES = %w[
+        search_navigation.js search_ranker.js search_controller.js
+      ].freeze
+
+      def initialize
+        super
+        @outputdir = nil
+        @themedir = srcdir_root + "theme/default"
+        @templatedir = srcdir_root + "data/bitclust/searchpage"
+        @suffix = ".html"
+        @fs_casesensitive = false
+        @verbose = false
+        @parser.banner = "Usage: #{File.basename($0, '.*')} searchpage [options] <dbpath>..."
+        @parser.on('-o', '--outputdir=PATH', 'Output directory.') {|path|
+          @outputdir = Pathname.new(path)
+        }
+        @parser.on('--themedir=PATH', 'Theme directory.') {|path|
+          @themedir = Pathname.new(path)
+        }
+        @parser.on('--fs-casesensitive', 'Filesystem is case-sensitive.') {
+          @fs_casesensitive = true
+        }
+        @parser.on('--verbose', 'Show progress.') {
+          @verbose = true
+        }
+      end
+
+      # DB paths are taken as positional arguments (one per version), so the
+      # global --database option is not required.
+      def needs_database?
+        false
+      end
+
+      def exec(argv, options)
+        outputdir = @outputdir or error("no --outputdir given")
+        error("no database given (pass one path per version)") if argv.empty?
+
+        generator = SearchIndexGenerator.new(suffix: @suffix,
+                                             fs_casesensitive: @fs_casesensitive)
+        version_indexes = argv.map {|path|
+          db = MethodDatabase.new(path)
+          fdb = FunctionDatabase.new(path) if File.directory?(File.join(path, 'function'))
+          version = db.properties['version'] or
+            error("#{path}: no version property (not a bitclust database?)")
+          $stderr.puts "indexing #{path} (#{version})" if @verbose
+          [version, generator.build_index(db, fdb)] #: [String, Array[SearchIndexGenerator::entry]]
+        }
+        versions = version_indexes.map {|version, _| version }
+                                  .sort_by {|v| Gem::Version.new(v) }
+
+        jsdir = outputdir + "js"
+        FileUtils.mkdir_p(jsdir)
+        (jsdir + "search_data.js").write(SearchIndexGenerator.merged_js(version_indexes))
+        VENDORED_JS_FILES.each do |js|
+          FileUtils.cp(@themedir + "js" + js, jsdir.to_s, :preserve => true)
+        end
+        # Ship the MIT notice for the vendored Aliki files alongside them.
+        FileUtils.cp(@themedir + "js" + "NOTICE", jsdir.to_s, :preserve => true)
+        FileUtils.cp(@themedir + "js" + "search_page.js", jsdir.to_s, :preserve => true)
+        FileUtils.cp(@themedir + "search.css", outputdir.to_s, :preserve => true)
+        (outputdir + "index.html").write(render_page(versions))
+        $stderr.puts "generated search page for #{versions.join(', ')}" if @verbose
+      end
+
+      private
+
+      def render_page(versions)
+        template = (@templatedir + "index.html").read
+        template.sub('%%SEARCH_VERSIONS%%', JSON.generate(versions))
+      end
+    end
+  end
+end

data/lib/bitclust/subcommands/server_command.rb

@@ -107,11 +107,11 @@ module BitClust
           exit 1
         end
         if @pid_file
-          if File.exist?(@pid_file)
+          if File.exist?(@pid_file || raise)
             $stderr.puts "There is still #{@pid_file}.  Is another process running?"
             exit 1
           end
-          @pid_file = File.expand_path(@pid_file)
+          @pid_file = File.expand_path(@pid_file || raise)
         end
       end
 
@@ -133,7 +133,7 @@ module BitClust
           @params[:Logger] = WEBrick::Log.new($stderr, WEBrick::Log::INFO)
           @params[:AccessLog] = []
         end
-        basepath = URI.parse(@baseurl).path
+        basepath = URI.parse(@baseurl || raise).path or raise
         server = WEBrick::HTTPServer.new(@params)
 
         if @autop
@@ -172,17 +172,19 @@ module BitClust
         server.mount File.join(basepath, 'theme/'), WEBrick::HTTPServlet::FileHandler, @themedir
 
         if @debugp
-          trap(:INT) { server.shutdown }
+          Signal.trap(:INT) { server.shutdown }
         else
           WEBrick::Daemon.start do
-            trap(:TERM) {
+            Signal.trap(:TERM) {
               server.shutdown
               begin
-                File.unlink @pid_file if @pid_file
+                pid_file = @pid_file
+                File.unlink pid_file if pid_file
               rescue Errno::ENOENT
               end
             }
-            File.open(@pid_file, 'w') {|f| f.write Process.pid } if @pid_file
+            pid_file = @pid_file
+            File.open(pid_file, 'w') {|f| f.write Process.pid } if pid_file
           end
         end
         exit if $".include?("exerb/mkexy.rb")
@@ -209,7 +211,7 @@ module BitClust
       end
 
       def load_config_file
-        home_directory = Pathname(ENV['HOME'])
+        home_directory = Pathname(ENV.fetch('HOME'))
         config_path = home_directory + ".bitclust/config"
         if config_path.exist?
           config = YAML.load_file(config_path)