ready 0.0.1 → 0.0.2

data/extra/formatter

@@ -0,0 +1,108 @@
+#!/usr/bin/env zsh
+
+SCRIPT_DIR=${0:A:h}
+file=$1
+typeset -x temp=$(mktemp)
+cat $file > $temp
+{
+$SCRIPT_DIR/by -e "$(cat <<'EOF'
+
+require 'prism'
+
+TERM_RE = /_term/
+
+def classify(code)
+  return :text if code.lines.all? { |l| l.strip.empty? || l.start_with?("#") }
+  clean = code.gsub(/---/, "")
+  r = Prism.parse(clean)
+  return :code if r.errors.empty?
+  has_term = r.errors.any? { |e| e.type.to_s.match?(TERM_RE) }
+  if has_term
+    (1..5).each do |n|
+      return :incomplete_code if Prism.parse(clean + ("\nend" * n)).errors.empty?
+    end
+  end
+  :text
+end
+
+def flush(buf, mode)
+  return if buf.empty?
+  text = buf.join("\n\n")
+  # Convert definition lists (term\n:   desc) to term\n  desc
+  # so glow doesn't render them with the 🠶 character
+  text.gsub!(/^:   /m, "  ")
+  if mode == :code
+    puts "```ruby"
+    puts text
+    puts "```"
+  else
+    puts text
+  end
+  puts
+end
+
+buf = []
+mode = nil
+accumulating = false
+
+File.open(ENV.fetch("temp")).each("\n\n", chomp: true) do |para|
+  para.chomp!
+  next if para.strip.empty?
+
+  if accumulating
+    buf << para
+    combined_cls = classify(buf.join("\n"))
+    if combined_cls == :code
+      flush(buf, :code)
+      buf = []
+      mode = nil
+      accumulating = false
+    elsif combined_cls == :incomplete_code
+      # keep accumulating
+    else
+      # new paragraph broke it — flush accumulated as code, reprocess current
+      current = buf.pop
+      flush(buf, :code)
+      buf = []
+      accumulating = false
+
+      cls = classify(current)
+      if cls == :incomplete_code
+        accumulating = true
+        mode = :code
+        buf = [current]
+      else
+        mode = cls == :code ? :code : :text
+        buf = [current]
+      end
+    end
+  else
+    cls = classify(para)
+    if cls == :incomplete_code
+      if mode && mode != :code
+        flush(buf, mode)
+        buf = []
+      end
+      mode = :code
+      buf << para
+      accumulating = true
+    else
+      cur = cls == :code ? :code : :text
+      if mode && mode != cur
+        flush(buf, mode)
+        buf = []
+      end
+      mode = cur
+      buf << para
+    end
+  end
+end
+
+flush(buf, mode)
+exit
+warn :done
+EOF
+)"
+} always {
+	rm -f $temp
+}

data/extra/formatter.rb

@@ -0,0 +1,92 @@
+require 'prism'
+
+TERM_RE = /_term/
+
+def classify(code)
+  return :text if code.lines.all? { |l| l.strip.empty? || l.start_with?("#") }
+  clean = code.gsub(/---/, "")
+  r = Prism.parse(clean)
+  return :code if r.errors.empty?
+  has_term = r.errors.any? { |e| e.type.to_s.match?(TERM_RE) }
+  if has_term
+    (1..5).each do |n|
+      return :incomplete_code if Prism.parse(clean + ("\nend" * n)).errors.empty?
+    end
+  end
+  :text
+end
+
+def flush(buf, mode)
+  return if buf.empty?
+  text = buf.join("\n\n")
+  # Convert definition lists (term\n:   desc) to term\n  desc
+  # so glow doesn't render them with the 🠶 character
+  text.gsub!(/^:   /m, "  ")
+  if mode == :code
+    puts "```ruby"
+    puts text
+    puts "```"
+  else
+    puts text
+  end
+  puts
+end
+
+buf = []
+mode = nil
+accumulating = false
+
+ARGF.to_io.each("\n\n", chomp: true) do |paragraph|
+  paragraph.chomp!
+  next if paragraph.strip.empty?
+
+  if accumulating
+    buf << paragraph
+    combined_cls = classify(buf.join("\n"))
+    if combined_cls == :code
+      flush(buf, :code)
+      buf = []
+      mode = nil
+      accumulating = false
+    elsif combined_cls == :incomplete_code
+      # keep accumulating
+    else
+      # new paragraph broke it — flush accumulated as code, reprocess current
+      current = buf.pop
+      flush(buf, :code)
+      buf = []
+      accumulating = false
+
+      cls = classify(current)
+      if cls == :incomplete_code
+        accumulating = true
+        mode = :code
+        buf = [current]
+      else
+        mode = cls == :code ? :code : :text
+        buf = [current]
+      end
+    end
+  else
+    cls = classify(paragraph)
+    if cls == :incomplete_code
+      if mode && mode != :code
+        flush(buf, mode)
+        buf = []
+      end
+      mode = :code
+      buf << paragraph
+      accumulating = true
+    else
+      cur = cls == :code ? :code : :text
+      if mode && mode != cur
+        flush(buf, mode)
+        buf = []
+      end
+      mode = cur
+      buf << paragraph
+    end
+  end
+end
+
+flush(buf, mode)

data/extra/ri.rb

@@ -0,0 +1,78 @@
+require "rdoc/ri"
+require "rdoc/ri/driver"
+
+ready_defaults = {
+  use_home: false,
+  use_site: false,
+  use_system: true,
+  use_gems: true,
+  use_stdout: true,
+  formatter: RDoc::Markup::ToAnsi
+}
+
+$ri_driver = RDoc::RI::Driver.new
+# warm the cache
+$ri_driver.classes
+
+RDoc::RI::Driver.define_method :assign_attributes do |initial_options = {}|
+  @paging = false
+
+  original_default_options = self.class.default_options.update({})
+  default_options = original_default_options.merge(ready_defaults)
+  options = default_options.merge(initial_options)
+  # quick hack for now, optparse is the real one setting the defaults
+  options.merge!(ready_defaults)
+
+  @formatter_klass = options[:formatter]
+
+  require "profile" if options[:profile]
+
+  @names = options[:names]
+  @list = options[:list]
+  @list_doc_dirs = options[:list_doc_dirs]
+  @interactive = options[:interactive]
+  @server      = options[:server]
+  @use_stdout  = options[:use_stdout]
+  @show_all    = options[:show_all]
+  @width       = options[:width]
+  @expand_refs = options[:expand_refs]
+end
+
+RDoc::RI::Driver.define_method :classes_and_includes_and_extends_for do |name|
+  klasses = []
+  extends = []
+  includes = []
+
+  candidate_stores = classes[name] || [] # only stores that actually have `name`
+
+  found = candidate_stores.map do |store|
+    begin
+      klass = store.load_class name
+      klasses  << klass
+      extends  << [klass.extends,  store] if klass.extends
+      includes << [klass.includes, store] if klass.includes
+      [store, klass]
+    rescue RDoc::Store::MissingFileError
+    end
+  end.compact
+
+  extends.reject! do |modules,|
+    modules.empty?
+  end
+
+  includes.reject! do |modules,|
+    modules.empty?
+  end
+
+  [found, klasses, includes, extends]
+end
+
+RDoc::RI::Driver.define_singleton_method :run do |argv|
+  options = process_args argv
+  if options[:dump_path]
+    dump options[:dump_path]
+    return
+  end
+  $ri_driver.assign_attributes(options)
+  $ri_driver.run
+end