Contents

# frozen_string_literal: true

# Released under the MIT License.
# Copyright, 2023-2024, by Samuel Williams.

require 'utopia/project'
require 'xrb'

def update(path: "readme.md", documentation_url: nil)
	project = Utopia::Project::Base.new(context.root)
	readme = project.readme_document
	
	documentation_url ||= public_documentation_url
	
	readme.replace_section("Usage") do |header|
		current = header
		
		usage_section = self.usage_section(documentation_url, project)
		usage_section.each do |child|
			current.insert_after(child)
			current = child
		end
	end
	
	readme.replace_section("Releases", children: true) do |header|
		current = header
		
		releases_section = self.releases_section(documentation_url, project)
		releases_section.each do |child|
			current.insert_after(child)
			current = child
		end
	end
	
	File.write(path, readme.root.to_markdown)
end

private

Scope = Struct.new(:documentation_url, :project)

def gemspec_path
	Dir.glob("*.gemspec", base: context.root).first
end

def gemspec
	if gemspec_path = self.gemspec_path
		@gemspec ||= ::Gem::Specification.load(gemspec_path)
	end
end

# The public documentation URL if it can be determined.
def public_documentation_url
	if metadata = gemspec.metadata
		if documentation_uri = metadata['documentation_uri']
			return documentation_uri
		end
	end
	
	return gemspec&.homepage
end

def usage_section(documentation_url, project)
	template = XRB::Template.load_file(File.expand_path("usage.xrb", __dir__))
	scope = Scope.new(documentation_url, project)
	
	output = template.to_string(scope)
	
	return Markly.parse(output)
end

def releases_section(documentation_url, project)
	template = XRB::Template.load_file(File.expand_path("releases.xrb", __dir__))
	scope = Scope.new(documentation_url, project)
	
	output = template.to_string(scope)
	
	return Markly.parse(output)
end

Version data entries

6 entries across 6 versions & 1 rubygems

Version	Path
utopia-project-0.31.0	bake/utopia/project/readme/update.rb
utopia-project-0.30.1	bake/utopia/project/readme/update.rb
utopia-project-0.30.0	bake/utopia/project/readme/update.rb
utopia-project-0.29.0	bake/utopia/project/readme/update.rb
utopia-project-0.28.1	bake/utopia/project/readme/update.rb
utopia-project-0.28.0	bake/utopia/project/readme/update.rb