Rakefile

require "rspec/core/rake_task"
require "yaml"
require "launchy"

STAGING_DIR = "staging"
SITE_DIR = "site"
TUTORIALS_DIR = "tutorials"

require_relative "tasks/tutorial_tasks"
require_relative "tasks/nokogiri_tasks"

namespace :dev do
  MKDOCS_DIR = "../mkdocs"
  MKDOCS_MATERIAL_INSIDERS_DIR = "mkdocs-material"

  desc "Set up system dependencies to develop this site."
  task :setup do
    sh "pip3 install --upgrade --user pygments pymdown-extensions"
    sh "pip3 uninstall --yes mkdocs mkdocs-material"

    if File.directory?(MKDOCS_DIR)
      Dir.chdir(File.join(MKDOCS_DIR, "..")) do
        sh "pip3 install --user -e mkdocs"
      end
    else
      puts "WARNING: you don't have a custom mkdocs installed, using OSS version which will not index rdocs"
      sh "pip3 install --upgrade --user mkdocs"
    end

    if File.directory?(MKDOCS_MATERIAL_INSIDERS_DIR)
      Dir.chdir(MKDOCS_MATERIAL_INSIDERS_DIR) do
        sh "git pull --rebase"
      end
      sh "pip3 install --user -e #{MKDOCS_MATERIAL_INSIDERS_DIR}"
    else
      puts "WARNING: you don't have mkdocs-material-insiders installed, using OSS version"
      sh "pip3 install --upgrade --user mkdocs-material"
    end
  end
end

desc "Push everything to Github Pages"
task :deploy => :generate do
  sh "mkdocs gh-deploy"
end

namespace :tutorials do
  tasks = create_tutorial_tasks("docs", STAGING_DIR)

  desc "Pull in tutorial content"
  task :generate => tasks
end

namespace :nokogiri do
  tasks = create_nokogiri_tasks(nokogiri_dir, STAGING_DIR)

  desc "Pull in Nokogiri repo files"
  task :generate => tasks
end

namespace :mkdocs do
  desc "Use mkdocs to generate a static site"
  task :generate do
    sh "mkdocs build"
  end

  desc "Use mkdocs to generate a static site"
  task :preview do
    Thread.new do
      sleep 1
      Launchy.open "http://localhost:8000"
    end
    sh "mkdocs serve"
  end
end

task :clean do
  FileUtils.rm_rf STAGING_DIR
  FileUtils.rm_rf SITE_DIR
end

desc "generate a static site"
task :generate => ["tutorials:generate", "nokogiri:generate", "mkdocs:generate"]

desc "preview the site"
task :preview => ["tutorials:generate", "nokogiri:generate", "mkdocs:preview"]

RSpec::Core::RakeTask.new(:spec)
task :spec => :generate
task :default => :spec