Build docs/api via Rake

Author: pusewicz

.gitignore

@@ -1,5 +1,6 @@
 _site
 mruby
+/docs/api/
 /.bundle/
 /vendor/
 .worktrees

Gemfile

@@ -1,5 +1,6 @@
 source 'https://rubygems.org'
 
+gem 'rake'
 gem 'github-pages', group: :jekyll_plugins
 
 group :jekyll_plugins do

Gemfile.lock

@@ -258,6 +258,7 @@ GEM
       track_open_instances (~> 0.1)
     public_suffix (5.1.1)
     racc (1.8.1)
+    rake (13.3.1)
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
@@ -304,6 +305,7 @@ DEPENDENCIES
   jekyll-feed
   jekyll-sitemap
   mgem
+  rake
   yard-coderay
   yard-mruby
 

Rakefile

@@ -0,0 +1,128 @@
+namespace :gen do
+  desc 'Regenerate mrbgem library data (_data/mgems.yml)'
+  task :mgemdata do
+    require 'mgem'
+    require 'yaml'
+
+    class File
+      class << self
+        alias_method :exists?, :exist? unless method_defined?(:exists?)
+      end
+    end
+
+    include Mrbgem
+    mgems = load_gems
+    mgems.update!
+
+    mgem_info = mgems.map do |mgem|
+      {
+        'name'        => mgem.name,
+        'description' => mgem.description,
+        'author'      => mgem.author,
+        'website'     => mgem.website,
+        'protocol'    => mgem.protocol,
+        'repository'  => mgem.repository,
+        'repooptions' => mgem.repooptions
+      }
+    end
+
+    mgem_info.sort_by! { |g| g['name'].downcase }
+
+    File.open('_data/mgems.yml', 'w') { |f| f.write(mgem_info.to_yaml) }
+    puts 'Written _data/mgems.yml'
+  end
+
+  desc 'Regenerate API documentation from mruby source (clones latest release into mruby/)'
+  task :mrbdoc do
+    require 'json'
+
+    # Resolve latest stable release tag via gh CLI (mruby uses tags, not GitHub Releases)
+    tags = JSON.parse(`gh api 'repos/mruby/mruby/tags?per_page=100'`)
+    tag  = tags.map { |t| t['name'] }.find { |n| n.match?(/^\d+\.\d+\.\d+$/) }
+    raise "Could not determine latest stable mruby release tag" unless tag
+    puts "Latest mruby release: #{tag}"
+
+    # Clone mruby at the release tag (or skip if already at the right version)
+    mruby_dir = File.join(__dir__, 'mruby')
+    if Dir.exist?(mruby_dir)
+      current_tag = `git -C #{mruby_dir} describe --exact-match HEAD 2>/dev/null`.strip
+      if current_tag == tag
+        puts "mruby #{tag} already cloned, skipping clone"
+      else
+        puts "mruby dir exists at #{current_tag.empty? ? 'unknown version' : current_tag}, re-cloning at #{tag}"
+        FileUtils.rm_rf(mruby_dir)
+        sh "git clone --depth 1 --branch #{tag} https://github.com/mruby/mruby.git #{mruby_dir}"
+      end
+    else
+      sh "git clone --depth 1 --branch #{tag} https://github.com/mruby/mruby.git #{mruby_dir}"
+    end
+
+    # Run mrbdoc (from yard-mruby) in the mruby directory — equivalent to doc:api
+    Dir.chdir(mruby_dir) do
+      sh "BUNDLE_GEMFILE=#{__dir__}/Gemfile bundle exec mrbdoc"
+    end
+
+    # Copy generated docs into our docs/api/ directory
+    dest = File.join(__dir__, 'docs', 'api')
+    FileUtils.mkdir_p(dest)
+    FileUtils.cp_r(Dir.glob("#{mruby_dir}/doc/api/*"), dest)
+    puts "Copied mruby API docs to docs/api/"
+  end
+
+  desc 'Regenerate release data from GitHub API (_data/releases.yml)'
+  task :releasedata do
+    require 'json'
+    require 'shellwords'
+    require 'yaml'
+
+    repo      = 'mruby/mruby'
+    data_file = File.join(__dir__, '_data', 'releases.yml')
+
+    gh_api = lambda { |path| JSON.parse(`gh api #{Shellwords.escape(path)}`) }
+
+    post_dates = {}
+    Dir.glob(File.join(__dir__, '_posts', '*.{markdown,md}')).each do |f|
+      if (m = File.basename(f).match(/^(\d{4}-\d{2}-\d{2})-mruby-([\d.]+)-released/))
+        post_dates[m[2]] = m[1]
+      end
+    end
+
+    tags = []
+    page = 1
+    loop do
+      batch = gh_api.call("/repos/#{repo}/tags?per_page=100&page=#{page}")
+      break if batch.empty?
+      tags.concat(batch)
+      break if batch.size < 100
+      page += 1
+    end
+
+    versioned = tags.select { |t| t['name'].match?(/^\d/) }
+
+    releases = versioned.map do |tag|
+      version    = tag['name']
+      prerelease = !version.match?(/^\d+\.\d+\.\d+$/)
+      date       = post_dates[version] || begin
+        commit = gh_api.call("/repos/#{repo}/commits/#{tag['commit']['sha']}")
+        commit.dig('commit', 'committer', 'date')&.slice(0, 10)
+      end
+      puts "  #{version}: #{date}#{' (prerelease)' if prerelease}"
+      { 'version' => version, 'date' => date, 'prerelease' => prerelease }
+    end
+
+    File.write(data_file, releases.to_yaml)
+    puts "\nWritten #{releases.size} releases to #{data_file}"
+  end
+end
+
+desc 'Build the Jekyll site'
+task build: %w[gen:mgemdata gen:mrbdoc gen:releasedata] do
+  sh 'bundle exec jekyll build'
+end
+
+desc 'Serve the Jekyll site locally with live reload'
+task :serve do
+  sh 'bundle exec jekyll serve'
+end
+
+task default: :build