bhook 0.2.1 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 144ecf729bff710fb2848d0e64a1bd2c9aa2b1178ce079760f3cb7f0fa3cbb74
-  data.tar.gz: a615cb26c8c45647ca9dba86f382c84344e76e0710c7f1408f5cffee0022cc09
+  metadata.gz: 1e5a2ce989dc5f18be7fe40f71b3c2afbec926f43a8abd417a40b9b738af1075
+  data.tar.gz: 6f20fc641d2c96deaf22a6def9547b8da373ceeec507f96ef92542ae110397ec
 SHA512:
-  metadata.gz: 37caec4b0a9144b8a918b9af5d30ed84ae1882f22e2d29e1bd17dcfd03671865027c1a18cd8cd1c6f6931013cfac766a9f9e1096234cb9d8034ca49f791314fb
-  data.tar.gz: afe25a780b1f31a937876d33178142b0236341eccce7092db264668863f0cdfa8ed1473a4c0159465b1211e00bd7ea8761830be3b578852ab80d87c9e21a7659
+  metadata.gz: 91851c0792324aa103da6c6c157b64924187afe33901566f004d808e12437821598502e0bb487bd449b3e154d030734a3c81641156f02b12200926c77855b5b5
+  data.tar.gz: 78c3ebb19723089cd939ed8de447343240fd9ae5c4389b89185fdb65c6a8a06cbe55759f88ee5d210ec49c6638e8b6a0aaab5429d7a3c9b78d861007a90f9a71

data/.rubocop.yml

@@ -32,4 +32,5 @@ Metrics/BlockLength:
 Metrics/AbcSize:
   Exclude:
     - lib/bhook/args_parser.rb
+    - spec/**/*_spec.rb
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    bhook (0.2.1)
+    bhook (0.3.1)
       git (~> 1.10)
       kramdown (~> 2.3)
       listen (~> 3.7)

data/README.md

@@ -9,11 +9,15 @@
 
 Bhook is a static website generator that works off a git repo containing a markdown file based wiki, like for example, the [India Startup Wiki](https://gitlab.com/india-startups/wiki).
 
+Since you control the source markdown, Bhook applies no restrictions on what you can put in there. Wanna embed a YouTube video in an `iframe`? Sure thing!
+
 I use this to create [HTML versions of the wiki](https://sidu.in/wiki/startups) and of [my essays](https://sidu.in/essays/) that I can publish.
 
 ## Installation
 
-Install it yourself as:
+`bhook` requires [`ruby`](https://www.ruby-lang.org/en/documentation/installation/). If you are on OSX or Linux, it is likely to already be installed. 
+
+To install `bhook` run:
 
     $ gem install bhook
 
@@ -22,7 +26,7 @@ Install it yourself as:
 Getting help:
 
 	$ bhook --help
-	Bhook version 0.2.0
+	Bhook version 0.3.0
 	Usage: bhook --source /source/path --output /output/path
 	    -s, --source=SOURCE              Path to version controlled directory containing source md files
 	    -o, --output=OUTPUT              Path to directory where output files are to be generated
@@ -33,11 +37,20 @@ Getting help:
 	        --benchmark                  Run a performance benchmark for the specified source
 	    -h, --help                       Prints this help
 
-How I use it:
+### 1-to-1 mode
 
 	➜  essays git:(main) ✗ bhook -s . -o /tmp/out -t /tmp/out/theme -w -v
 
-Here's an example `.bhook.yml` [config file](https://gitlab.com/india-startups/wiki/-/blob/master/.bhook.yml).
+Here's an example `.bhook.yml` [config file](https://gitlab.com/india-startups/wiki/-/blob/master/.bhook.yml) for a source directory.
+
+### n-to-1 mode
+
+This requires the destination directory to have a `.bhook.yml` config file set up that describes all the sources.
+
+	➜  kaiwren.github.com git:(main) ✗ bhook -w -v
+
+Here's an example `.bhook.yml` [config file](https://github.com/kaiwren/kaiwren.github.com/blob/master/.bhook.yml) for a destination directory
+with multiple source directories.
 
 ## Development
 

data/Rakefile

@@ -31,4 +31,4 @@ namespace :ci do
   task spec: %i[spec]
 end
 
-task default: %i[autocorrect_basic_style_issues rubocop sorbet spec]
+task default: %i[autocorrect_basic_style_issues sorbet spec rubocop]

data/bin/bhook

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 require 'bundler/setup'
-require 'bhook'
+require_relative File.join('..', 'lib', 'bhook')
 
 puts "Bhook version #{Bhook::VERSION}"
 parser = Bhook::ArgsParser.new(ARGV)
@@ -15,24 +15,35 @@ if args.help
   exit
 end
 
+Bhook::L.level = args.verbose ? Logger::DEBUG : Logger::INFO
+
 if args.generate_theme
   Bhook::L.level = Logger::DEBUG
   Bhook::ThemeGenerator.new(args.generate_theme).generate!
   exit
 end
 
-Bhook::L.level = args.verbose ? Logger::DEBUG : Logger::INFO
+workspaces = Bhook::Workspaces.new
 
-workspace = Bhook::Workspace.new(args.source, args.output, args.theme)
+if args.mount
+  args.mount.each do |project, from_to|
+    from = File.expand_path(from_to['from'])
+    to = File.expand_path(from_to['to'])
+    Bhook::L.debug "Mounting: #{project} \n\tfrom #{from} \n\tto #{to}"
+    workspaces.mount(Bhook::Workspace.new(from, to, args.theme))
+  end
+else
+  workspaces.mount(Bhook::Workspace.new(args.source, args.output, args.theme))
+end
 
 if args.benchmark
   require 'benchmark'
   n = 10
   Benchmark.bmbm do |bench|
     Bhook::L.level = Logger::WARN
-    bench.report("Generate HTML #{n} times") { n.times { workspace.process! } }
+    bench.report("Generate HTML #{n} times") { n.times { workspaces.each(&:process!) } }
   end
   exit
 end
 
-args.watch ? workspace.watch! : workspace.process!
+args.watch ? workspaces.watch! : workspaces.process!

data/lib/bhook/args_parser.rb

@@ -5,25 +5,29 @@ module Bhook
   class ArgsParser
     extend T::Sig
 
-    Options = Struct.new(:source, :output, :watch, :verbose, :theme, :generate_theme, :benchmark, :help)
+    Options = Struct.new(:source, :output, :watch, :verbose, :theme, :generate_theme, :benchmark, :mount, :help)
 
     def initialize(argv)
-      @args = Options.new(nil, nil, false, false, Bhook::THEME_DIR_PATH, nil, false, false)
+      @args = Options.new(nil, nil, false, false, Bhook::THEME_DIR_PATH, nil, false, nil, false)
       @argv = argv.clone
       @opt_parser = build_opt_parser
     end
 
     def parse
+      if (mount = detect_and_read_mount_args_from_config_in_pwd)
+        @args.mount = mount
+      end
+
       begin
         @opt_parser.parse(@argv)
-        if generate_theme_missing? && help_missing? && source_or_output_paths_missing?
+        if generate_theme_missing? && help_missing? &&
+           source_or_output_paths_missing? && mount_config_missing?
           raise OptionParser::MissingArgument, 'See --help.'
         end
       rescue OptionParser::ParseError => e
         puts "\nError! #{e.message}\n"
         return nil
       end
-
       @args
     end
 
@@ -33,6 +37,17 @@ module Bhook
 
     private
 
+    def detect_and_read_mount_args_from_config_in_pwd
+      bhook_config_path = File.join(Dir.pwd, SourceConfig::BHOOK_CONFIG_FILE)
+      return unless File.exist?(bhook_config_path)
+
+      YAML.safe_load(File.read(bhook_config_path))['mount']
+    end
+
+    def mount_config_missing?
+      !@args.mount
+    end
+
     def help_missing?
       !@args.help
     end

data/lib/bhook/directory.rb

@@ -8,15 +8,15 @@ module Bhook
     GIT_DIR = '.git'
     MD_EXT = '.md'
 
-    sig { params(src_path: Pathname, out_path: Pathname).returns(Bhook::Directory) }
+    sig { params(src_path: Pathname, out_path: Pathname).returns(Bhook::RootDirectory) }
     def self.new_root_directory(src_path, out_path)
-      new(src_path, out_path, Git.open(src_path), Bhook::Config.new(src_path))
+      RootDirectory.new(src_path, out_path)
     end
 
-    sig { params(src_path: Pathname, out_path: Pathname, git: Git::Base, config: Bhook::Config).void }
+    sig { params(src_path: Pathname, out_path: Pathname, git: Git::Base, config: Bhook::SourceConfig).void }
     def initialize(src_path, out_path, git, config)
       @src_path = src_path
-      @out_path = T.let(out_path.join(src_path.basename), Pathname)
+      @out_path = T.let(build_out_path(src_path, out_path), Pathname)
       @git = git
       @config = config
       @sub_dirs = T.let([], T::Array[Directory])
@@ -46,6 +46,11 @@ module Bhook
 
     private
 
+    sig { params(src_path: Pathname, out_path: Pathname).returns(Pathname) }
+    def build_out_path(src_path, out_path)
+      out_path.join(src_path.basename)
+    end
+
     sig { void }
     def build_next_level_nodes
       children = @src_path.children

data/lib/bhook/md_file.rb

@@ -17,7 +17,7 @@ module Bhook
     sig { returns(String) }
     attr_reader :md
 
-    sig { params(src_file_path: Pathname, out_path: Pathname, git: Git::Base, config: Bhook::Config).void }
+    sig { params(src_file_path: Pathname, out_path: Pathname, git: Git::Base, config: Bhook::SourceConfig).void }
     def initialize(src_file_path, out_path, git, config)
       L.debug "Reading: #{src_file_path}"
       @md = T.let(File.read(src_file_path), String)

data/lib/bhook/root_directory.rb

@@ -0,0 +1,20 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Bhook
+  class RootDirectory < Directory
+    extend T::Sig
+
+    sig { params(src_path: Pathname, out_path: Pathname).void }
+    def initialize(src_path, out_path)
+      super(src_path, out_path, Git.open(src_path), Bhook::SourceConfig.new(src_path))
+    end
+
+    private
+
+    sig { params(_src_path: Pathname, out_path: Pathname).returns(Pathname) }
+    def build_out_path(_src_path, out_path)
+      out_path
+    end
+  end
+end

data/lib/bhook/{config.rb → source_config.rb}

@@ -8,7 +8,7 @@ module Bhook
   #   - link to place in the footer
   # - exclude
   #   - list of .md file paths relative to config files
-  class Config
+  class SourceConfig
     extend T::Sig
     BHOOK_CONFIG_FILE = T.let('.bhook.yml', String)
     WEBSITE_KEY = T.let('website', String)
@@ -40,7 +40,7 @@ module Bhook
 
     sig { params(excluded_files: T::Array[String]).returns(T::Array[Pathname]) }
     def parse_excluded_files(excluded_files)
-      excluded_files.map { |file_path| @root_dir_path.join(file_path) }
+      excluded_files.map { |file_path| @root_dir_path.join(file_path) if file_path }.compact
     end
 
     sig do

data/lib/bhook/theme/page.erb

@@ -51,8 +51,25 @@
           margin-bottom: 1.5em;
       }
 
+      div.youtube-video {
+          margin: 1em 0 1em 0;
+          width: 100%;
+          justify-content: center;
+          display: flex;
+      }
+
+      div.content {
+      }
+
       div.footer {
-          margin: 0.5em 0 1.5em 0;
+          margin: 0.5em 0 0.5em 0;
+      }
+
+      div.bhook-cta a {
+          font-size: x-small;
+          text-decoration: none;
+          margin-bottom: 1.5em;
+          color: #bbbbbb;
       }
 
       table {
@@ -86,9 +103,6 @@
   <title><%= src_title -%></title>
 </head>
 <body>
-<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16">
-  <path fill="#333" fill-rule="evenodd" d="M9.683 6.676l-.047-.048C8.27 5.26 6.07 5.243 4.726 6.588l-2.29 2.29c-1.344 1.344-1.328 3.544.04 4.91 1.366 1.368 3.564 1.385 4.908.04l1.753-1.752c-.695.074-1.457-.078-2.176-.444L5.934 12.66c-.634.634-1.67.625-2.312-.017-.642-.643-.65-1.677-.017-2.312L6.035 7.9c.634-.634 1.67-.625 2.312.017.024.024.048.05.07.075l.003-.002c.36.36.943.366 1.3.01.355-.356.35-.938-.01-1.3l-.027-.024zM6.58 9.586l.048.05c1.367 1.366 3.565 1.384 4.91.04l2.29-2.292c1.344-1.343 1.328-3.542-.04-4.91-1.366-1.366-3.564-1.384-4.908-.04L7.127 4.187c.695-.074 1.457.078 2.176.444l1.028-1.027c.635-.634 1.67-.624 2.313.017.643.644.652 1.678.018 2.312l-2.43 2.432c-.635.634-1.67.624-2.313-.018-.024-.024-.048-.05-.07-.075l-.003.004c-.36-.362-.943-.367-1.3-.01-.355.355-.35.937.01 1.3.01.007.018.015.027.023z"/>
-</svg>
 <div class="body container">
   <div class="content row justify-content-center">
     <div class="col-10">
@@ -106,6 +120,9 @@
       <%= src_file_date -%> © <a href="https://sidu.in">Sidu Ponnappa</a>
     </div>
   </div>
+  <div class="bhook-cta d-flex justify-content-center">
+    <a href="https://gitlab.com/kaiwren/bhook" target="_blank">powered by bhook</a>
+  </div>
 </div>
 </body>
 </html>

data/lib/bhook/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Bhook
-  VERSION = '0.2.1'
+  VERSION = '0.3.1'
 end

data/lib/bhook/workspace.rb

@@ -28,19 +28,13 @@ module Bhook
         process!
       end
       listener.start
-      sleep
-    end
-
-    sig { returns(T::Array[MdFile]) }
-    def all_md_files
-      root_dir.all_md_files
     end
 
     private
 
     sig { returns(Bhook::Directory) }
     def root_dir
-      Directory.new_root_directory(@src_path, @out_path)
+      RootDirectory.new(@src_path, @out_path)
     end
   end
 end

data/lib/bhook/workspaces.rb

@@ -0,0 +1,29 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Bhook
+  class Workspaces
+    extend T::Sig
+
+    sig { void }
+    def initialize
+      @workspaces = T.let([], T::Array[Bhook::Workspace])
+    end
+
+    sig { params(workspace: Workspace).void }
+    def mount(workspace)
+      @workspaces << workspace
+    end
+
+    sig { void }
+    def process!
+      @workspaces.each(&:process!)
+    end
+
+    sig { void }
+    def watch!
+      @workspaces.each(&:watch!)
+      Kernel.sleep
+    end
+  end
+end

data/lib/bhook.rb

@@ -27,10 +27,12 @@ end
 require_relative 'bhook/version'
 require_relative 'bhook/logger'
 require_relative 'bhook/args_parser'
-require_relative 'bhook/config'
+require_relative 'bhook/source_config'
 require_relative 'bhook/theme_generator'
 require_relative 'bhook/theme'
 require_relative 'bhook/converter/html'
 require_relative 'bhook/directory'
+require_relative 'bhook/root_directory'
 require_relative 'bhook/md_file'
 require_relative 'bhook/workspace'
+require_relative 'bhook/workspaces'

data/sorbet/rbi/hidden-definitions/hidden.rbi

@@ -28,7 +28,7 @@ class Bhook::ArgsParser::Options
   def self.members(); end
 end
 
-class Bhook::Config
+class Bhook::SourceConfig
   extend ::T::Private::Methods::MethodHooks
   extend ::T::Private::Methods::SingletonMethodHooks
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bhook
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.1
 platform: ruby
 authors:
 - Sidu Ponnappa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-12 00:00:00.000000000 Z
+date: 2022-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: git
@@ -197,17 +197,19 @@ files:
 - bin/bhook
 - lib/bhook.rb
 - lib/bhook/args_parser.rb
-- lib/bhook/config.rb
 - lib/bhook/converter/html.rb
 - lib/bhook/directory.rb
 - lib/bhook/logger.rb
 - lib/bhook/md_file.rb
+- lib/bhook/root_directory.rb
+- lib/bhook/source_config.rb
 - lib/bhook/theme.rb
 - lib/bhook/theme/_after_h1.erb
 - lib/bhook/theme/page.erb
 - lib/bhook/theme_generator.rb
 - lib/bhook/version.rb
 - lib/bhook/workspace.rb
+- lib/bhook/workspaces.rb
 - sorbet/config
 - sorbet/rbi/gems/ast.rbi
 - sorbet/rbi/gems/bhook.rbi