920707cd7e
## Motivation and Context The three conformance tasks were named `conformance`, `conformance_list`, and `conformance_server`, spelling out with underscores the grouping that Rake expresses with namespaces. They are now `conformance:test`, `conformance:list`, and `conformance:server`. The bare `conformance` task is kept as an alias for `conformance:test`. ## How Has This Been Tested? By running `rake -T` to confirm the three tasks are grouped under `conformance:` with the alias listed beside them, `rake --dry-run default` to confirm that the default task resolves `conformance:test`, and `rake conformance:list` to exercise a renamed task end to end. ## Breaking Changes None. These are development-only Rake tasks.
103 lines
3.4 KiB
Ruby
103 lines
3.4 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
require "bundler/gem_tasks"
|
|
require "rake/testtask"
|
|
|
|
Rake::TestTask.new(:test) do |t|
|
|
t.ruby_opts = ["-W0", "-W:deprecated"]
|
|
t.libs << "test"
|
|
t.libs << "lib"
|
|
t.test_files = FileList["test/**/*_test.rb"]
|
|
end
|
|
|
|
require "rubocop/rake_task"
|
|
|
|
RuboCop::RakeTask.new
|
|
|
|
task default: [:rubocop, :test, "conformance:test"]
|
|
|
|
namespace :conformance do
|
|
desc "Run MCP conformance tests (PORT, SCENARIO, SPEC_VERSION, VERBOSE)"
|
|
task :test do |t|
|
|
next unless npx_available?(t.name)
|
|
|
|
require_relative "conformance/server_runner"
|
|
require_relative "conformance/client_runner"
|
|
|
|
options = {}
|
|
options[:port] = Integer(ENV["PORT"]) if ENV["PORT"]
|
|
options[:scenario] = ENV["SCENARIO"] if ENV["SCENARIO"]
|
|
options[:spec_version] = ENV["SPEC_VERSION"] if ENV["SPEC_VERSION"]
|
|
options[:verbose] = true if ENV["VERBOSE"]
|
|
|
|
Conformance::ServerRunner.new(**options).run
|
|
Conformance::ClientRunner.new(**options.reject { |key, _value| key == :port }).run
|
|
end
|
|
|
|
desc "List available conformance scenarios"
|
|
task :list do |t|
|
|
next unless npx_available?(t.name)
|
|
|
|
system("npx", "--yes", "@modelcontextprotocol/conformance", "list", "--server")
|
|
system("npx", "--yes", "@modelcontextprotocol/conformance", "list", "--client")
|
|
end
|
|
|
|
desc "Start the conformance server (PORT)"
|
|
task :server do
|
|
require_relative "conformance/server"
|
|
|
|
options = {}
|
|
options[:port] = Integer(ENV["PORT"]) if ENV["PORT"]
|
|
|
|
Conformance::Server.new(**options).start
|
|
end
|
|
end
|
|
|
|
# The other two former names now fail with a "Did you mean?" suggestion, but a bare `conformance`
|
|
# would match the `conformance/` directory: Rake synthesizes a file task for it and exits 0 without
|
|
# running anything. This keeps the name pointing at the suite instead of at that silent no-op.
|
|
desc "Alias for conformance:test"
|
|
task conformance: "conformance:test"
|
|
|
|
namespace :docs do
|
|
desc "Serve the documentation site locally at http://localhost:4000 (PORT)"
|
|
task :preview do
|
|
docs_dir = File.expand_path("docs", __dir__)
|
|
generate_docs_versions_data(docs_dir)
|
|
|
|
env = {
|
|
"BUNDLE_GEMFILE" => File.join(docs_dir, "Gemfile"),
|
|
"RUBYOPT" => "-r#{File.join(docs_dir, "_preview", "taint_shim.rb")}",
|
|
}
|
|
port = ENV.fetch("PORT", "4000")
|
|
|
|
Bundler.with_unbundled_env do
|
|
system(env, "bundle", "install", "--quiet", chdir: docs_dir, exception: true)
|
|
system(env, "bundle", "exec", "jekyll", "serve", "--port", port, chdir: docs_dir, exception: true)
|
|
rescue Interrupt
|
|
# Ctrl-C is the way to stop the preview, not an error.
|
|
end
|
|
end
|
|
end
|
|
|
|
# Mirrors bin/generate-gh-pages.sh: the released site receives `_data/versions.yml` from
|
|
# the version tags at deploy time, and the preview generates the same data so the nav footer
|
|
# shows the released-gem version line.
|
|
def generate_docs_versions_data(docs_dir)
|
|
versions = %x(git tag --list).split("\n").filter_map { |tag|
|
|
tag[/\A[^0-9]*(\d+\.\d+\.\d+(?:-[a-zA-Z0-9.-]+)?)\z/, 1]
|
|
}.sort_by { |version|
|
|
Gem::Version.new(version)
|
|
}.reverse
|
|
return if versions.empty?
|
|
|
|
mkdir_p(File.join(docs_dir, "_data"))
|
|
File.write(File.join(docs_dir, "_data", "versions.yml"), versions.map { |version| "- #{version}\n" }.join)
|
|
end
|
|
|
|
def npx_available?(task_name)
|
|
return true if system("which", "npx", out: File::NULL, err: File::NULL)
|
|
|
|
warn("Skipping #{task_name}: npx is not installed. Install Node.js to run this task: https://nodejs.org/")
|
|
false
|
|
end
|