Class: Utopia::Content

Inherits:
Object
  • Object
show all
Defined in:
lib/utopia/content.rb,
lib/utopia/content/link.rb,
lib/utopia/content/node.rb,
lib/utopia/content/tags.rb,
lib/utopia/content/links.rb,
lib/utopia/content/markup.rb,
lib/utopia/content/document.rb,
lib/utopia/content/response.rb,
lib/utopia/content/namespace.rb

Overview

A middleware which serves dynamically generated content based on markup files.

Defined Under Namespace

Modules: Namespace, Tags Classes: Document, Link, Links, MarkupParser, Node, Response, SymbolicHash, UnbalancedTagError

Constant Summary collapse

CONTENT_NAMESPACE = 
'content'.freeze
UTOPIA_NAMESPACE = 
'utopia'.freeze
DEFERRED_TAG_NAME = 
'utopia:deferred'.freeze
CONTENT_TAG_NAME = 
'utopia:content'.freeze
XNODE_EXTENSION =

The file extension for markup nodes on disk.

'.xnode'
INDEX = 
"index"
Tag = 
Trenni::Tag
EXPIRES =

Compatibility with older versions of rack:

'expires'.freeze
CACHE_CONTROL = 
'cache-control'.freeze
CONTENT_TYPE = 
'content-type'.freeze
NO_CACHE = 
'no-cache'.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(app, root: Utopia::default_root, namespaces: {}) ⇒ Content

Returns a new instance of Content.

Parameters:

  • root (String) (defaults to: Utopia::default_root) —

    The content root where pages will be generated from.

  • namespaces (Hash<String,Library>) (defaults to: {}) —

    Tag namespaces for dynamic tag lookup.



45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/utopia/content.rb', line 45

def initialize(app, root: Utopia::default_root, namespaces: {})
	@app = app
	@root = root
	
	@template_cache = Concurrent::Map.new
	@node_cache = Concurrent::Map.new
	
	@links = Links.new(@root)
	
	@namespaces = namespaces
	
	# Default content namespace for dynamic path based lookup:
	@namespaces[CONTENT_NAMESPACE] ||= self.method(:content_tag)
	
	# The core namespace for utopia specific functionality:
	@namespaces[UTOPIA_NAMESPACE] ||= Tags
end

Instance Attribute Details

#root ⇒ Object (readonly)

Returns the value of attribute root.



73
74
75
 
# File 'lib/utopia/content.rb', line 73

def root
  @root
end

Instance Method Details

#call(env) ⇒ Object 



112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
 
# File 'lib/utopia/content.rb', line 112

def call(env)
	request = Rack::Request.new(env)
	path = Path.create(request.path_info)
	
	# Check if the request is to a non-specific index. This only works for requests with a given name:
	basename = path.basename
	directory_path = File.join(@root, path.dirname.components, basename)
	
	# If the request for /foo/bar is actually a directory, rewrite it to /foo/bar/index:
	if File.directory? directory_path
		index_path = [basename, INDEX]
		
		return [307, {HTTP::LOCATION => path.dirname.join(index_path).to_s}, []]
	end
	
	locale = env[Localization::CURRENT_LOCALE_KEY]
	if link = @links.for(path, locale)
		if node = resolve_link(link)
			attributes = request.env.fetch(VARIABLES_KEY, {}).to_hash
			
			return node.process!(request, attributes)
		elsif redirect_uri = link[:uri]
			return [307, {HTTP::LOCATION => redirect_uri}, []]
		end
	end
	
	return @app.call(env)
end

#fetch_template(path) ⇒ Object 



80
81
82
83
84
 
# File 'lib/utopia/content.rb', line 80

def fetch_template(path)
	@template_cache.fetch_or_store(path.to_s) do
		Trenni::MarkupTemplate.load_file(path)
	end
end

#freeze ⇒ Object 



63
64
65
66
67
68
69
70
71
 
# File 'lib/utopia/content.rb', line 63

def freeze
	return self if frozen?
	
	@root.freeze
	@namespaces.values.each(&:freeze)
	@namespaces.freeze
	
	super
end

#links(path, **options) ⇒ Object

TODO we should remove this method and expose ‘@links` directly.



76
77
78
 
# File 'lib/utopia/content.rb', line 76

def links(path, **options)
	@links.index(path, **options)
end

#lookup_node(path, locale = nil) ⇒ Object

Parameters:

  • path (Path) —

    the request_path is an absolute uri path, e.g. ‘/foo/bar`. If an xnode file exists on disk for this exact path, it is instantiated, otherwise nil.



96
97
98
99
100
 
# File 'lib/utopia/content.rb', line 96

def lookup_node(path, locale = nil)
	resolve_link(
		@links.for(path, locale)
	)
end

#lookup_tag(qualified_name, node) ⇒ Object

Look up a named tag such as ‘<entry />` or `<content:page>…`



87
88
89
90
91
92
93
 
# File 'lib/utopia/content.rb', line 87

def lookup_tag(qualified_name, node)
	namespace, name = Trenni::Tag.split(qualified_name)
	
	if library = @namespaces[namespace]
		library.call(name, node)
	end
end

#resolve_link(link) ⇒ Object 



102
103
104
105
106
107
108
109
110
 
# File 'lib/utopia/content.rb', line 102

def resolve_link(link)
	if path = link&.path
		full_path = File.join(@root, path.dirname, link.key + XNODE_EXTENSION)
		
		if File.exist?(full_path)
			return Node.new(self, path, path, full_path)
		end
	end
end