class Configuration

parameter　root　String | Pathname

The project directory containing package.json.

returns　Configuration

The validated project configuration.

raises　ConfigurationError

If package.json is missing, malformed or invalid.

def self.load(root)
	root = Pathname.new(root).expand_path
	package_path = root + "package.json"
	
	unless package_path.file?
		raise ConfigurationError, "Could not find package.json in #{root}!"
	end
	
	package_json = JSON.parse(package_path.read)
	new(root, package_json)
rescue JSON::ParserError => error
	raise ConfigurationError, "Could not parse #{package_path}: #{error.message}"
end

parameter　root　String | Pathname

The project root directory.

parameter　package_json　Hash

The parsed contents of package.json.

raises　ConfigurationError

If the configuration is invalid.

def initialize(root, package_json)
	@root = Pathname.new(root).expand_path
	@package_json = package_json
	
	unless @package_json.is_a?(Hash)
		raise ConfigurationError, "package.json must contain an object!"
	end
	
	configuration = @package_json.fetch("web-packages", {})
	
	unless configuration.is_a?(Hash)
		raise ConfigurationError, "web-packages configuration must be an object!"
	end
	
	@package_root = expand_within_root(configuration.fetch("packageRoot", "node_modules"), "packageRoot")
	@output = configuration.fetch("output", DEFAULT_OUTPUT)
	@base = configuration.fetch("base", DEFAULT_BASE)
	@packages = load_packages(configuration["packages"])
	
	unless @base.is_a?(String) && @base.end_with?("/")
		raise ConfigurationError, "web-packages base must be a string ending in '/'!"
	end
	
	output_path
end

attribute　Pathname

The expanded project root directory.

attribute　Hash

The parsed contents of package.json.

attribute　Pathname

The directory containing installed Node.js packages.

attribute　String

The public URL prefix for static packages.

attribute　Hash(String, Package)

The packages selected for static deployment.

parameter　override　String | Nil

An optional project-relative output directory.

returns　Pathname

The expanded output directory.

raises　ConfigurationError

If the output directory escapes the project root.

def output_path(override = nil)
	expand_within_root(override || @output, "output", allow_root: false)
end