bhook 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fbf30bb96c81aaa4b89f0709d42b878c1a53a0c87fed519d42796f15502adcc
-  data.tar.gz: f191aa122210048ce00af81de973a5adce5821a84851e774fcc864a89a300d08
+  metadata.gz: 90521640ce67d31a8e080b88cb860559033426b3afc55f1a03d09d42d0a415c5
+  data.tar.gz: f10067505bfdaa6c8e6bc4892340bd07d6937c0882b5472772f815705ca463ec
 SHA512:
-  metadata.gz: 01afd14cbb7f1e607b8306399cbad5e3a1de627be32923c5107868e3c06fce031266c6222f4bcf466cd3a19fd2c8ceb9c5a52a7e4ab535abd287a8fb1b5dcc98
-  data.tar.gz: 208dd8b71184dff3c7ebcc1d16c5f631c03a725166ec9dc532ce06a1a59a0705804480ad322a4547276c31a8e0ac2fcda54cc6968c04a4b70ab4c796d25ec599
+  metadata.gz: ee03d8c7ea7a5e39db17acbf3638dcf53c3d2f37a55b897e6800ca24a0dde2efd4037806619438ea8097781a7c75e15de6a5a34bb25c7693cdd1b98f069f4193
+  data.tar.gz: 94bf726b2a6a3afb8490f172a01f992ea8bfd063a54ed2143b3ace48c644c15b93c5b5faf2a68f110b0a04a79bbed7b167846a60ec44e7bb206c1d24e5d5cfb3

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.2)
+    bhook (0.3.0)
       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, Config::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 }
     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/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::Config.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/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 {
@@ -103,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.2'
+  VERSION = '0.3.0'
 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

@@ -32,5 +32,7 @@ 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'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bhook
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Sidu Ponnappa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-13 00:00:00.000000000 Z
+date: 2022-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: git
@@ -202,12 +202,14 @@ files:
 - lib/bhook/directory.rb
 - lib/bhook/logger.rb
 - lib/bhook/md_file.rb
+- lib/bhook/root_directory.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