cinnabar 0.0.6 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1b9aa28bb5ec0a8ab6c27fad3c32118087ddb9bf6caef21a4b511f0c2c0c4c8
-  data.tar.gz: 952f7f0c1d2b915f3fde32ead4cc36c4c96c482e616325a7df596ed8f1187fb4
+  metadata.gz: 8c9380fe3043491a6713a462cf2dbf775dbfac84ba64a4bf07795935784bd970
+  data.tar.gz: 349073ec15c90a198c964a1da6e73e1babe212385a2d173d44d67427181338e2
 SHA512:
-  metadata.gz: 3b20bb4b422443e83afd40753ef2862ec59f8533b2b1e0fee3c33e755e42d1fc26b158b297f73c7ae402a09709be49e82b6f77053b3c761fea31da929d8244e4
-  data.tar.gz: c814343302e8e2f94e3ae04b9558b8306e0512b541e136391ce67863b40edc0468da990a9b69e58440a669424acca1bd352cdebb150dabd4d10dbf93a249da41
+  metadata.gz: cf824e87ce90c648a774f77539aff478653eaaeadc44b943f8699cc7c67d55078a641d1f7223ebf44e5f68944cd35c3038d253a99073bcf9cfe49907fa42b952
+  data.tar.gz: f6bea3d650ad6a835ab7f5436d9cf112649938656c008aa1fd4a273ebadb2ddd1038dea1e01f8d0d7e1e6e9f93b74638ceeda7ab2e65f1d4d134073ee32c0d4e

data/docs/Readme.md

@@ -57,7 +57,7 @@ jobs:
         with:
           repository: 2moe/cinnabar
           path: cinnabar
-          ref: v0.0.5
+          ref: v0.0.8
 
       - name: (example) run cargo command
         run: |
@@ -168,14 +168,46 @@ jobs:
 
 ### GemPath
 
+`GemPath` is used mainly with Ruby started via the `--disable=gems` flag; the code below is equivalent to `%w[ irb rdoc reline ].each { require it }`.
+
+```ruby
+def require_gems = ->(gems) {
+  {
+    # cache_dir: File.expand_path('~/.cache/ruby'),
+    gems:,
+  }
+    .then(&Cinnabar.new_gem_path_proc)
+    .append_load_path!
+
+  gems.each { require _1 }
+}
+
+%w[
+  irb rdoc reline
+].then(&require_gems)
+```
+
 #### Faster IRB
 
-> **NON CI Environment**
+Because `GemPath` automatically caches gem `require_paths`, combining it with `ruby --disable=gems` can significantly reduce IRB startup time.
+
+1. Run: [misc/firb/install.ps1](../misc/firb/install.ps1)
+
+OR:
+
+```pwsh
+gem install cinnabar
+```
+
+2.
+  - Enter the directory:
+    - `ruby -r cinnabar -e "p Cinnabar.firb_path"`
+    - OR: `${XDG_CACHE_HOME:-~/.cache}/ruby/firb/bin/` (POSIX sh)
+    - OR: `~/.cache/ruby/firb/bin/`
+    - OR: `%UserProfile%\.cache\ruby\firb\bin` (Windows CMD)
 
-1. run: [misc/firb/install-cinnabar.ps1](../misc/firb/install-cinnabar.ps1)
-2. Enter `${XDG_CACHE_HOME:-~/.cache}/ruby/firb/bin/`
 3. run
   - [`./firb0`](../misc/firb/bin/firb0)
-  - OR `.\firb0.bat` (Windows)
+  - OR [`.\firb0.bat`](../misc/firb/bin/firb0.bat) (Windows)
   - OR [`./firb`](../misc/firb/bin/firb)
   - OR `.\firb.bat` (Windows)

data/lib/cinnabar/path.rb

@@ -19,6 +19,18 @@ module Cinnabar
   def self.to_path_proc = ->(s) { Pathname(s) }
 end
 
+module Cinnabar
+  module_function
+
+  def firb_path
+    File.expand_path('../../misc/firb/bin/', Kernel.__dir__)
+  end
+
+  def firb_installation_script_path
+    File.expand_path('../../misc/firb/install.ps1', Kernel.__dir__)
+  end
+end
+
 # Adds `String#to_path` as a convenience helper to convert strings into {Kernel.Pathname}.
 #
 # This module supports two integration styles:

data/lib/cinnabar/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cinnabar
-  VERSION = '0.0.6'
+  VERSION = '0.0.8'
 end

data/misc/firb/bin/firb

@@ -22,8 +22,31 @@
 #   which :ruby #=> `which ruby`
 #   cdir '~/.cache' #=> `cd ~/.cache; pwd; ls`
 #   pwd         #=> Dir.pwd
+#
+# Install Dependencies:
+#
+# - Windows:
+#     winget install Microsoft.VCRedist.2015+.x64
+#     # OR: winget install Microsoft.VCRedist.2015+.arm64
+#
+#     scoop install bat eza
+#
+# - macOS:
+#     brew install bat eza
+#
+# - Debian:
+#
+#     apt update
+#     apt install -y bat eza
+#     ln -svf /usr/bin/batcat /usr/local/bin/bat
+#
+# - Arch:
+#   pacman -Sy bat eza
+#
+# - Alpine:
+#   apk add bat eza
+#
 # ====================
-
 Kernel.warn "  ruby:\t#{RUBY_VERSION}" if ARGV.empty?
 
 $ruby_cache_dir = -> {

data/misc/firb/{install-cinnabar.ps1 → install.ps1}

@@ -1,12 +1,12 @@
 #!/usr/bin/env pwsh
 # Usage:
-#   UNIX:
-#     sh install-cinnabar.ps1
+#   UNIX-like:
+#     sh install.ps1
 #   Windows: Copy everything in this file and paste it into PowerShell to run.
 #
 # Description: install cinnabar and copy to cache dir
 # Note: Although the shebang is `pwsh`, you can run it with POSIX sh.
-# Depens: ruby (>= 3.1)
+# Depends: ruby (>= 3.1)
 
 gem install cinnabar
 
@@ -32,4 +32,8 @@ ruby -r pathname -r cinnabar -r fileutils -e "
 
   [lib_dir, firb]
     .each(&copy_to_cache_dir)
+
+  puts '========='
+  print 'Path: '
+  puts File.expand_path('firb/bin', cache_dir)
 "

data/misc/firb/lib/sh_utils.rb

@@ -4,17 +4,9 @@
 
 require_relative 'which'
 
-BAT_CAT_CMD = -> {
-  %w[bat batcat]
-    .each { return [_1, '-Pp'] if which(_1) }
-  ['cat']
-}.call.freeze
-
-EXA_LS_CMD = -> {
-  %w[eza exa]
-    .each { return [_1, '--icons=auto'] if which(_1) }
-  ['ls', '--color=auto']
-}.call.freeze
+BAT_CAT_CMD = ['bat', '-Pp'].freeze
+EXA_LS_CMD = ['eza', '--icons=auto'].freeze
+# EXA_LS_CMD = ['ls', '--color=auto'].freeze
 
 # Similar to `cd "/path/to/dir"; pwd; ls`
 def cdir(path = Dir.home)

data/misc/firb/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Firb
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cinnabar
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.8
 platform: ruby
 authors:
 - 2moe
@@ -47,7 +47,7 @@ files:
 - misc/firb/bin/firb.bat
 - misc/firb/bin/firb0
 - misc/firb/bin/firb0.bat
-- misc/firb/install-cinnabar.ps1
+- misc/firb/install.ps1
 - misc/firb/lib/sh_utils.rb
 - misc/firb/lib/version.rb
 - misc/firb/lib/which.rb