strelka-presenters 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bde111f87ede9477a436d489cf6b8675ab93031fb3231a08965c227389c59aa3
+  data.tar.gz: b64413df84cec398d8f5c45a22fca13c09deb5caa73238ca360ca5fd68d88869
+SHA512:
+  metadata.gz: bb85149d0e58a0ed2fc38b6b675a955315933d4d67885044c5e07a785621b80e0f818f766aa30bbadf13c511dd5baf640bd77588c96ce0456076e5719369e1d5
+  data.tar.gz: 0304763de7b1e4f01b2f64cfb618e968af67780843038d28b876ba671777d44d354a914dee477b750e1866726a969bc28ec665126c6cdb561ce222e9251a6052

data.tar.gz.sig

@@ -0,0 +1,4 @@
+��Cʥ�Fe؈��|�����znk��vwn3����!��
+zG+HA��Pi���Ѝhewu�T�l���vX`&��^�d32])�?J(�	��s�!x�cS�+vٳ,,O
+���w0�q�*N�w�8{�n{5w�3�Aޑ����5op/�6�摰qZ&��lv屹�[��u�0&>�$W_Z�G4^#�y,��St&^0�b=B���7P}[;6��DZ!MD��<�G1�M4i��e��j~�P��2�%����]Z6�6?V���B(wq����y�h٩�s�������!Ѽ��N���G�5��O����w{89X��vbfyGm�?#:Չ;��)
+�g���"hk%���K�0����9����
G]Nеi������

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+README.md
+ChangeLog.md
+
+LICENSE.txt

data/.rdoc_options

@@ -0,0 +1,16 @@
+--- !ruby/object:RDoc::Options
+encoding: UTF-8
+static_path: []
+rdoc_include:
+  - .
+charset: UTF-8
+exclude: 
+hyperlink_all: false
+line_numbers: false
+main_page: README.md
+markup: markdown
+show_hash: false
+tab_width: 8
+title: strelka-Presenters Documentation
+visibility: :protected
+webcvs:

data/.simplecov

@@ -0,0 +1,9 @@
+# Simplecov config
+
+SimpleCov.start do
+	add_filter 'spec'
+	add_filter 'integration'
+	add_group "Needing tests" do |file|
+		file.covered_percent < 90
+	end
+end

data/ChangeLog

@@ -0,0 +1,42 @@
+2019-08-13  Michael Granger  <ged@FaerieMUD.org>
+
+@  	* README.md:
+|  	Fix URLs and title in the README
+|  	[6ac7de9075da] [tip]
+|
+2019-08-12  Michael Granger  <ged@FaerieMUD.org>
+
+o  	* Rakefile, strelka-presenters.gemspec:
+|  	Add URLs to the gemspec.
+|  	[720bbedd3323]
+|
+o  	* strelka-presenters.gemspec:
+|  	Commit the pre-release gemspec
+|  	[7193b0e574d3]
+|
+2019-08-11  Michael Granger  <ged@FaerieMUD.org>
+
+o  	* .hgignore, Manifest.txt:
+|  	Update the manifest
+|  	[dfa3077cfaeb]
+|
+o  	* Rakefile:
+|  	Remove the publishing guard
+|  	[3d2b12a06693]
+|
+2019-08-07  Michael Granger  <ged@FaerieMUD.org>
+
+o  	* .document, .editorconfig, .gems, .hgignore, .pryrc, .rdoc_options,
+   	.ruby-gemset, .ruby-version, .simplecov, Gemfile, History.md,
+   	LICENSE.txt, Manifest.txt, README.md, Rakefile, certs/ged.pem,
+   	lib/strelka/app/presenters.rb,
+   	lib/strelka/httpresponse/presenters.rb, lib/strelka/presenters.rb,
+   	spec/spec_helper.rb, spec/strelka/app/presenters_spec.rb,
+   	spec/strelka/httpresponse/presenters_spec.rb,
+   	spec/strelka/presenters_spec.rb, spec/testlib.rb,
+   	spec/testlib/base.rb, spec/testlib/fixtures.rb,
+   	spec/testlib/fixtures/groups.rb, spec/testlib/fixtures/users.rb,
+   	spec/testlib/group.rb, spec/testlib/presenters.rb,
+   	spec/testlib/user.rb:
+   	Initial commit.
+   	[83ab22adf1b7]

data/History.md

@@ -0,0 +1,4 @@
+## v0.1.0 [2019-08-24] Michael Granger <ged@FaerieMUD.org>
+
+Initial release.
+

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2019 Michael Granger
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -0,0 +1,24 @@
+.document
+.rdoc_options
+.simplecov
+ChangeLog
+History.md
+LICENSE.txt
+Manifest.txt
+README.md
+Rakefile
+lib/strelka/app/presenters.rb
+lib/strelka/httpresponse/presenters.rb
+lib/strelka/presenters.rb
+spec/spec_helper.rb
+spec/strelka/app/presenters_spec.rb
+spec/strelka/httpresponse/presenters_spec.rb
+spec/strelka/presenters_spec.rb
+spec/testlib.rb
+spec/testlib/base.rb
+spec/testlib/fixtures.rb
+spec/testlib/fixtures/groups.rb
+spec/testlib/fixtures/users.rb
+spec/testlib/group.rb
+spec/testlib/presenters.rb
+spec/testlib/user.rb

data/README.md

@@ -0,0 +1,107 @@
+# Strelka-Presenters
+
+home
+: http://deveiate.org/projects/strelka-presenters
+
+code
+: http://bitbucket.org/ged/strelka-presenters
+
+github
+: https://github.com/ged/strelka-presenters
+
+docs
+: http://deveiate.org/code/strelka-presenters
+
+
+## Description
+
+Strelka-Presenters is a plugin for the Strelka web framework that adds
+integration with the [Yaks hypermedia library][Yaks].
+
+### Usage
+
+Load the plugin in your Strelka app, passing the Yaks configuration block:
+
+    class Example::App < Strelka::App
+  
+      plugin :presenters do
+        default_format :hal
+        rel_template 'https://example.com/rels/{rel}'
+        mapper_namespace Example::Service::Presenters
+      end
+
+      plugin :router
+      
+      get 'users' do |request|
+        users = Example::Users.all
+        response = request.response
+        response.present( users )
+        return response
+      end
+
+    end
+
+Your app will automatically load the `negotiation` plugin, and responses will have a #present method that will map objects passed to it using Yaks into an acceptable response format using HTTP content negotiation.
+
+See the documentation for [Yaks][] for more info.
+
+## Prerequisites
+
+* Ruby
+
+
+## Installation
+
+    $ gem install strelka-presenters
+
+
+## Contributing
+
+You can check out the current development source with Mercurial via its
+[project page][project]. Or if you prefer Git, via
+[its Github mirror][gitmirror].
+
+After checking out the source, run:
+
+    $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the API documentation.
+
+
+## License
+
+Copyright (c) 2019, Michael Granger
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the author/s, nor the names of the project's
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+
+[project]: http://bitbucket.org/ged/strelka-presenters
+[Yaks]: https://github.com/plexus/yaks/blob/master/yaks/README.md
+[gitmirror]: https://github.com/ged/strelka-presenters
+

data/Rakefile

@@ -0,0 +1,100 @@
+#!/usr/bin/env rake
+
+begin
+	require 'hoe'
+rescue LoadError
+	abort "This Rakefile requires hoe (gem install hoe)"
+end
+
+GEMSPEC = 'strelka-presenters.gemspec'
+
+
+Hoe.plugin :mercurial
+Hoe.plugin :signing
+Hoe.plugin :deveiate
+
+Hoe.plugins.delete :rubyforge
+
+hoespec = Hoe.spec 'strelka-presenters' do |spec|
+
+	spec.readme_file = 'README.md'
+	spec.history_file = 'History.md'
+
+	spec.extra_rdoc_files = FileList[ '*.rdoc', '*.md' ]
+	spec.license 'BSD-3-Clause'
+	spec.urls = {
+		home:   'https://bitbucket.org/ged/strelka-presenters',
+		code:   'https://bitbucket.org/ged/strelka-presenters/src',
+		docs:   'https://deveiate.org/code/strelka-presenters',
+		github: 'https://github.com/ged/strelka-presenters',
+	}
+
+	spec.developer 'Michael Granger', 'ged@FaerieMUD.org'
+
+	spec.dependency 'strelka', '~> 0.16'
+	spec.dependency 'yaks', '~> 0.13'
+
+	spec.dependency 'faker', '~> 2.1'
+	spec.dependency 'fluent_fixtures', '~> 0.8'
+	spec.dependency 'hoe-deveiate', '~> 0.10', :developer
+	spec.dependency 'simplecov', '~> 0.17', :developer
+	spec.dependency 'rdoc-generator-fivefish', '~> 0.1', :developer
+
+	spec.require_ruby_version( '>=2.5.0' )
+	spec.hg_sign_tags = true if spec.respond_to?( :hg_sign_tags= )
+	spec.check_history_on_release = true if spec.respond_to?( :check_history_on_release= )
+
+	self.rdoc_locations << "deveiate:/usr/local/www/public/code/#{remote_rdoc_dir}"
+end
+
+
+ENV['VERSION'] ||= hoespec.spec.version.to_s
+
+# Run the tests before checking in
+task 'hg:precheckin' => [ :check_history, :check_manifest, :gemspec, :spec ]
+
+task :test => :spec
+
+# Rebuild the ChangeLog immediately before release
+task :prerelease => 'ChangeLog'
+CLOBBER.include( 'ChangeLog' )
+
+desc "Build a coverage report"
+task :coverage do
+	ENV["COVERAGE"] = 'yes'
+	Rake::Task[:spec].invoke
+end
+CLOBBER.include( 'coverage' )
+
+
+# Use the fivefish formatter for docs generated from development checkout
+if File.directory?( '.hg' )
+	require 'rdoc/task'
+
+	Rake::Task[ 'docs' ].clear
+	RDoc::Task.new( 'docs' ) do |rdoc|
+	    rdoc.main = "README.md"
+		rdoc.markup = 'markdown'
+	    rdoc.rdoc_files.include( "*.md", "ChangeLog", "lib/**/*.rb" )
+	    rdoc.generator = :fivefish
+		rdoc.title = 'Strelka Presenters Plugin'
+	    rdoc.rdoc_dir = 'doc'
+	end
+end
+
+task :gemspec => GEMSPEC
+file GEMSPEC => __FILE__
+task GEMSPEC do |task|
+	spec = $hoespec.spec
+	spec.files.delete( '.gemtest' )
+	spec.signing_key = nil
+	spec.cert_chain = ['certs/ged.pem']
+	spec.version = "#{spec.version.bump}.0.pre#{Time.now.strftime("%Y%m%d%H%M%S")}"
+	File.open( task.name, 'w' ) do |fh|
+		fh.write( spec.to_ruby )
+	end
+end
+CLOBBER.include( GEMSPEC.to_s )
+
+task :default => :gemspec
+

data/lib/strelka/app/presenters.rb

@@ -0,0 +1,85 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'yaks'
+
+require 'strelka/app' unless defined?( Strelka::App )
+require 'strelka/plugins'
+require 'strelka/mixins'
+
+require 'strelka/httpresponse/presenters'
+
+
+# Presentation layer plugin for Strelka service apps.
+module Strelka::App::Presenters
+	include Strelka::Constants
+	extend Strelka::Plugin
+
+	run_outside :routing, :filters
+	run_inside  :templating, :parameters, :negotiation
+
+
+	# Class methods to add to classes with presenters
+	module ClassMethods
+
+		##
+		# The block given to Yaks when it's configured
+		attr_accessor :presenter_config_block
+
+	end # module ClassMethods
+
+
+	### Extension callback -- extend the HTTPResponse classes with presenter logic
+	### when the plugin is loaded.
+	def self::included( object )
+		Strelka::HTTPResponse.include( Strelka::HTTPResponse::Presenters )
+		super
+	end
+
+
+	### Set a block passed to `plugin` to the presenter library when it's
+	### configured.
+	def self::configure_block( app, &block )
+		app.plugin( :negotiation )
+		app.presenter_config_block = block
+	end
+
+
+	### Set up the presenters when the app is created.
+	def initialize( * )
+		super
+		@presenter = self.setup_presentation_layer
+	end
+
+
+	######
+	public
+	######
+
+	##
+	# The configured Yaks presenter object
+	attr_reader :presenter
+
+
+	### Set up the presenter when the response has returned.
+	def handle_request( req )
+		self.log.debug "[:negotiation] Wrapping response with hypermedia presentation."
+
+		response = super
+		response.presenter = self.presenter
+
+		return response
+	end
+
+
+	### Configure and return the presenter.
+	def setup_presentation_layer
+		self.log.debug "Setting up presenters using %s" %
+			[ self.class.presenter_config_block&.inspect || 'defaults' ]
+		config_block = self.class.presenter_config_block || Proc.new {}
+		return Yaks.new( &config_block )
+	end
+
+end # module Strelka::App::Presenters
+
+

data/lib/strelka/httpresponse/presenters.rb

@@ -0,0 +1,45 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'yaks'
+
+require 'strelka/httpresponse' unless defined?( Strelka::HTTPResponse )
+
+
+# Hypermedia presentation logic for Strelka HTTP responses
+module Strelka::HTTPResponse::Presenters
+
+	### Initialize some instance variables when a new response is created.
+	def initialize( * )
+		@presenter = nil
+		super
+	end
+
+
+	######
+	public
+	######
+
+	##
+	# The presenter to use when negotiating the response
+	attr_accessor :presenter
+
+
+	### Added so we can pass the response object to the presenters as the `env`.
+	def []( * ) # :nodoc:
+		return nil
+	end
+
+
+	### Set the entity that should be rendered to form the response body.
+	def present( entity, **options )
+		Yaks::Format.all.each do |format|
+			self.for( format.media_type ) do
+				opts = options.merge( format: format.format_name, env: self )
+				self.presenter.call( entity, opts )
+			end
+		end
+	end
+
+end # module Strelka::HTTPResponse::Presenters
+

data/lib/strelka/presenters.rb

@@ -0,0 +1,21 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'strelka' unless defined?( Strelka )
+
+
+# Toplevel namespace
+module Strelka::Presenters
+
+	# Package version
+	VERSION = '0.1.0'
+
+	# Version control revision
+	REVISION = %q$Revision$
+
+
+	require 'strelka/app/presenters'
+	require 'strelka/httpresponse/presenters'
+
+end # module Strelka::Presenters
+

data/spec/spec_helper.rb

@@ -0,0 +1,42 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+BEGIN {
+	$LOAD_PATH.unshift( '../Strelka/lib' )
+}
+
+require 'simplecov' if ENV['COVERAGE']
+
+require 'rspec'
+
+require 'loggability/spechelpers'
+require 'mongrel2'
+require 'mongrel2/testing'
+require 'strelka'
+require 'strelka/testing'
+
+
+### Mock with RSpec
+RSpec.configure do |config|
+	config.mock_with( :rspec ) do |mock|
+		mock.syntax = :expect
+	end
+
+	config.disable_monkey_patching!
+	config.example_status_persistence_file_path = "spec/.status"
+	config.filter_run :focus
+	config.filter_run_when_matching :focus
+	config.order = :random
+	config.profile_examples = 5
+	config.run_all_when_everything_filtered = true
+	config.shared_context_metadata_behavior = :apply_to_host_groups
+	# config.warnings = true
+
+	config.include( Loggability::SpecHelpers )
+	config.include( Mongrel2::SpecHelpers )
+	config.include( Mongrel2::Constants )
+	config.include( Strelka::Constants )
+	config.include( Strelka::Testing )
+end
+
+

data/spec/strelka/app/presenters_spec.rb

@@ -0,0 +1,260 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require_relative '../../spec_helper'
+
+require 'strelka'
+require 'mongrel2/testing'
+require 'strelka/testing'
+require 'strelka/constants'
+require 'strelka/behavior/plugin'
+
+require 'testlib'
+
+require 'strelka/app/presenters'
+
+
+RSpec.describe( Strelka::App::Presenters ) do
+
+	TEST_SEND_SPEC = 'tcp://127.0.0.1:12012'
+	TEST_RECV_SPEC = 'tcp://127.0.0.1:12013'
+
+
+	before( :all ) do
+		Testlib::Fixtures.load( :users, :groups )
+
+		@request_factory = Mongrel2::RequestFactory.new(
+			route: '/api/v1',
+			host: 'acme.com',
+			port: 80
+		)
+	end
+
+
+	it_should_behave_like( "A Strelka Plugin" )
+
+
+	describe "an including App" do
+
+		before( :each ) do
+			Testlib.reset
+
+			@app = Class.new( Strelka::App ) do
+				def initialize( appid='presenters-test', sspec=TEST_SEND_SPEC, rspec=TEST_RECV_SPEC )
+					super
+				end
+
+				plugins :routing
+				router :exclusive
+
+				plugin :parameters
+				param :id, :integer
+
+				plugin :presenters do
+					default_format :hal
+					rel_template 'https://acme.com/rels/{rel}'
+					format_options( :hal, plural_links: [:copyright] )
+					mapper_namespace Testlib::Presenters
+				end
+
+				get '/users' do |req|
+					res = req.response
+					res.present( Testlib::User.all )
+					return res
+				end
+
+				get '/users/:id' do |req|
+					id = req.params[:id]
+
+					user = Testlib::User[ id ] or finish_with HTTP::NOT_FOUND, "no such user"
+					res = req.response
+					res.present( user )
+
+					return res
+				end
+			end
+		end
+
+
+		let( :user_factory ) { Testlib::Fixtures.user.full }
+		let( :user_generator ) { user_factory.generator(create: true) }
+
+
+		it "can render a singleton HAL response" do
+			user = user_factory.create
+
+			req = @request_factory.get( "/api/v1/users/#{user.id}", accept: 'application/hal+json' )
+			res = @app.new.handle( req )
+
+			expect( res.status ).to eq( 200 )
+			expect( res.content_type ).to eq( 'application/hal+json' )
+			expect( res ).to have_json_body( Object ).
+				that_includes(
+					id: user.id,
+					name: user.name,
+					email: user.email,
+					login: user.login,
+					_links: a_hash_including(
+						self: {
+							href: "/api/v1/users/#{user.id}"
+						}
+					)
+				)
+		end
+
+
+		it "can render a collection HAL response" do
+			users = user_generator.take( 10 )
+
+			req = @request_factory.get( "/api/v1/users", accept: 'application/hal+json' )
+			res = @app.new.handle( req )
+
+			expect( res.status ).to eq( 200 )
+			expect( res.content_type ).to eq( 'application/hal+json' )
+			expect( res ).to have_json_body( Object ).
+				that_includes(
+					_embedded: {
+						"https://acme.com/rels/users": a_collection_containing_exactly(
+							*users.map {|u| a_hash_including(id: u.id) }
+						)
+					}
+				)
+		end
+
+
+		it "can render a singleton HALO response" do
+			user = user_factory.create
+
+			req = @request_factory.get( "/api/v1/users/#{user.id}", accept: 'application/halo+json' )
+			res = @app.new.handle( req )
+
+			expect( res.status ).to eq( 200 )
+			expect( res.content_type ).to eq( 'application/halo+json' )
+			expect( res ).to have_json_body( Object ).
+				that_includes(
+					id: user.id,
+					name: user.name,
+					email: user.email,
+					login: user.login,
+					_links: a_hash_including(
+						self: {
+							href: "/api/v1/users/#{user.id}"
+						}
+					)
+				)
+		end
+
+
+		it "can render a collection HALO response" do
+			users = user_generator.take( 10 )
+
+			req = @request_factory.get( "/api/v1/users", accept: 'application/halo+json' )
+			res = @app.new.handle( req )
+
+			expect( res.status ).to eq( 200 )
+			expect( res.content_type ).to eq( 'application/halo+json' )
+			expect( res ).to have_json_body( Object ).
+				that_includes(
+					_embedded: {
+						"https://acme.com/rels/users": a_collection_containing_exactly(
+							*users.map {|u| a_hash_including(id: u.id) }
+						)
+					}
+				)
+		end
+
+
+		it "can render a singleton JSON-API response" do
+			user = user_factory.create
+
+			req = @request_factory.get( "/api/v1/users/#{user.id}", accept: 'application/vnd.api+json' )
+			res = @app.new.handle( req )
+
+			expect( res.status ).to eq( 200 )
+			expect( res.content_type ).to eq( 'application/vnd.api+json' )
+			expect( res ).to have_json_body( Object ).
+				that_includes(
+					data: {
+						attributes: {
+							name: user.name,
+							email: user.email,
+							login: user.login,
+						},
+						id: user.id.to_s,
+						links: {
+							self: "/api/v1/users/#{user.id}"
+						},
+						type: "users"
+					}
+				)
+		end
+
+
+		it "can render a collection JSON-API response" do
+			users = user_generator.take( 10 )
+
+			req = @request_factory.get( "/api/v1/users", accept: 'application/vnd.api+json' )
+			res = @app.new.handle( req )
+
+			expect( res.status ).to eq( 200 )
+			expect( res.content_type ).to eq( 'application/vnd.api+json' )
+			expect( res ).to have_json_body( Object ).
+				that_includes(
+					data: a_collection_containing_exactly(
+						*users.map {|u| a_hash_including(id: u.id.to_s) }
+					)
+				)
+		end
+
+
+		it "can render a singleton Collection+JSON response" do
+			user = user_factory.create
+
+			req = @request_factory.get(
+				"/api/v1/users/#{user.id}",
+				accept: 'application/vnd.collection+json'
+			)
+			res = @app.new.handle( req )
+
+			expect( res.status ).to eq( 200 )
+			expect( res.content_type ).to eq( 'application/vnd.collection+json' )
+			expect( res ).to have_json_body( Object ).
+				that_includes(
+					collection: {
+						version: '1.0',
+						items: [
+							{
+								data: a_collection_containing_exactly(
+									{ name: "name", value: user.name},
+									{ name: "email", value: user.email},
+									{ name: "login", value: user.login},
+									{ name: "id", value: user.id},
+								),
+								href: "/api/v1/users/#{user.id}"
+							}
+						],
+						href: "/api/v1/users/#{user.id}"
+					}
+				)
+		end
+
+
+		it "can render a collection Collection+JSON response" do
+			users = user_generator.take( 10 )
+
+			req = @request_factory.get(
+				"/api/v1/users",
+				accept: 'application/vnd.collection+json'
+			)
+			res = @app.new.handle( req )
+
+			expect( res.status ).to eq( 200 )
+			expect( res.content_type ).to eq( 'application/vnd.collection+json' )
+			expect( res ).to have_json_body( Object ).
+				that_includes( :collection )
+		end
+
+	end
+
+end
+

data/spec/strelka/httpresponse/presenters_spec.rb

@@ -0,0 +1,22 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require_relative '../../spec_helper'
+
+require 'strelka/httpresponse/presenters'
+
+
+RSpec.describe Strelka::HTTPResponse::Presenters do
+
+	it "adds an index operator to the response to allow it to quack like a Rack ENV" do
+		dummy_response_class = Class.new
+		dummy_response_class.include( described_class )
+		dummy_response = dummy_response_class.new
+
+		expect {
+			dummy_response[ 'HTTP_ACCEPT' ]
+		}.to_not raise_error()
+	end
+
+end
+

data/spec/strelka/presenters_spec.rb

@@ -0,0 +1,17 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require_relative '../spec_helper'
+
+require 'rspec'
+require 'strelka/presenters'
+
+
+RSpec.describe( Strelka::Presenters ) do
+
+	it "knows what version of the library it is" do
+		expect( described_class::VERSION ).to be_a( String ).and( match(/\A\d+\.\d+\.\d+\z/) )
+	end
+
+end
+

data/spec/testlib.rb

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+module Testlib
+
+	autoload :Base, 'testlib/base'
+	autoload :Group, 'testlib/group'
+	autoload :User, 'testlib/user'
+	autoload :Fixtures, 'testlib/fixtures'
+	autoload :Presenters, 'testlib/presenters'
+
+
+	def self::reset
+		Testlib::Base::DATASTORE.clear
+		Testlib::Base::SERIAL_GENERATOR.clear
+	end
+
+end
+
+

data/spec/testlib/base.rb

@@ -0,0 +1,57 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'testlib' unless defined?( Testlib )
+
+
+class Testlib::Base
+
+	# Fancy database simulator
+	DATASTORE = Hash.new do |h, modelclass|
+		h[ modelclass ] = {}
+	end
+	SERIAL_GENERATOR = Hash.new do |h, modelclass|
+		h[ modelclass ] = Enumerator.new do |yielder|
+			i = 0
+			loop { i += 1; yielder.yield(i) }
+		end
+	end
+
+
+	def self::[]( id )
+		return DATASTORE[ self ][ id ]
+	end
+
+	def self::all
+		return DATASTORE[ self ].values
+	end
+
+
+	def initialize( params={} )
+		params.each do |name, value|
+			self.send( "#{name}=", value )
+		end
+	end
+
+
+	attr_accessor :id
+	alias_method :pk, :id
+
+
+	def []( attr_name )
+		return self.public_send( param )
+	end
+
+
+	def save
+		self.id ||= SERIAL_GENERATOR[ self.class ].next
+		DATASTORE[ self.class ][ self.id ] = self.dup
+	end
+
+
+	def saved?
+		return self.id && DATASTORE[ self.class ].key?( self.id )
+	end
+
+end
+

data/spec/testlib/fixtures.rb

@@ -0,0 +1,22 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'fluent_fixtures'
+require 'testlib' unless defined?( Testlib )
+
+module Testlib::Fixtures
+	extend FluentFixtures::Collection
+
+	fixture_path_prefix 'testlib/fixtures'
+
+
+	def self::describe
+		desc = "%p: %d fixtures loaded" % [ self, self.modules.length ]
+		unless self.modules.empty?
+			desc << ": %s" % [ self.modules.keys.map(&:to_s).join(', ') ]
+		end
+		return desc
+	end
+
+end
+

data/spec/testlib/fixtures/groups.rb

@@ -0,0 +1,12 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'faker'
+require 'testlib/fixtures'
+require 'testlib/group'
+
+module Testlib::Fixtures::Groups
+	extend Testlib::Fixtures
+	fixtured_class Testlib::Group
+end
+

data/spec/testlib/fixtures/users.rb

@@ -0,0 +1,28 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'faker'
+require 'testlib/fixtures'
+require 'testlib/user'
+
+module Testlib::Fixtures::Users
+	extend Testlib::Fixtures
+	fixtured_class Testlib::User
+
+	decorator :with_random_first_name do
+		self.first_name = Faker::Name.first_name
+	end
+
+	decorator :with_random_last_name do
+		self.last_name = Faker::Name.last_name
+	end
+
+	compose :with_random_name => [ :with_random_first_name, :with_random_last_name ]
+
+	compose :full => :with_random_name do
+		self.login = "%s%s" % [ self.first_name[0,1].downcase, self.last_name.downcase ]
+		self.email = "%s@example.com" % [ self.first_name.downcase ]
+	end
+
+end
+

data/spec/testlib/group.rb

@@ -0,0 +1,19 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'set'
+require 'testlib' unless defined?( Testlib )
+require 'testlib/base'
+
+
+class Testlib::Group < Testlib::Base
+
+	def initialize( * )
+		super
+		@members ||= Set.new
+	end
+
+	attr_accessor :name, :members
+
+end
+

data/spec/testlib/presenters.rb

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'yaks'
+
+require 'testlib' unless defined?( Testlib )
+
+
+# Presentation entities
+module Testlib::Presenters
+
+	class UserMapper < Yaks::Mapper
+		link :self, '/api/v1/users/{id}'
+
+		attributes :id, :name, :email, :login
+
+	end # class PersonaMapper
+
+end # module Prestigio::Service::Presenters
+

data/spec/testlib/user.rb

@@ -0,0 +1,24 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+require 'set'
+require 'testlib' unless defined?( Testlib )
+require 'testlib/base'
+
+
+class Testlib::User < Testlib::Base
+
+	def initialize( * )
+		super
+		@roles ||= Set.new
+	end
+
+	attr_accessor :first_name, :last_name, :email, :login, :groups
+
+
+	def name
+		return [ self.first_name, self.last_name ].compact.join( ' ' )
+	end
+
+end
+

metadata

@@ -0,0 +1,262 @@
+--- !ruby/object:Gem::Specification
+name: strelka-presenters
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michael Granger
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIENDCCApygAwIBAgIBATANBgkqhkiG9w0BAQsFADAiMSAwHgYDVQQDDBdnZWQv
+  REM9RmFlcmllTVVEL0RDPW9yZzAeFw0xODExMjAxODI5NTlaFw0xOTExMjAxODI5
+  NTlaMCIxIDAeBgNVBAMMF2dlZC9EQz1GYWVyaWVNVUQvREM9b3JnMIIBojANBgkq
+  hkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAvyVhkRzvlEs0fe7145BYLfN6njX9ih5H
+  L60U0p0euIurpv84op9CNKF9tx+1WKwyQvQP7qFGuZxkSUuWcP/sFhDXL1lWUuIl
+  M4uHbGCRmOshDrF4dgnBeOvkHr1fIhPlJm5FO+Vew8tSQmlDsosxLUx+VB7DrVFO
+  5PU2AEbf04GGSrmqADGWXeaslaoRdb1fu/0M5qfPTRn5V39sWD9umuDAF9qqil/x
+  Sl6phTvgBrG8GExHbNZpLARd3xrBYLEFsX7RvBn2UPfgsrtvpdXjsHGfpT3IPN+B
+  vQ66lts4alKC69TE5cuKasWBm+16A4aEe3XdZBRNmtOu/g81gvwA7fkJHKllJuaI
+  dXzdHqq+zbGZVSQ7pRYHYomD0IiDe1DbIouFnPWmagaBnGHwXkDT2bKKP+s2v21m
+  ozilJg4aar2okb/RA6VS87o+d7g6LpDDMMQjH4G9OPnJENLdhu8KnPw/ivSVvQw7
+  N2I4L/ZOIe2DIVuYH7aLHfjZDQv/mNgpAgMBAAGjdTBzMAkGA1UdEwQCMAAwCwYD
+  VR0PBAQDAgSwMB0GA1UdDgQWBBRyjf55EbrHagiRLqt5YAd3yb8k4DAcBgNVHREE
+  FTATgRFnZWRARmFlcmllTVVELm9yZzAcBgNVHRIEFTATgRFnZWRARmFlcmllTVVE
+  Lm9yZzANBgkqhkiG9w0BAQsFAAOCAYEAP9Ffkvg4e8CjIWi8SykQ8oJSS8jbmbgF
+  abke3vXWLG6V9kFiObuJd5wZRBluJANu7bEtjgc3fFaGVP2XxVdCpVjNbmMDg4Qp
+  ovvczP53X6pQP2RSZgxF6Lblvy8y11RziUTVRG/Z2aJHsElo6gI7vQznE/OSDrhC
+  gEhr8uaIUt7D+HZWRbU0+MkKPpL5uMqaFuJbqXEvSwPTuUuYkDfNfsjQO7ruWBac
+  bxHCrvpZ6Tijc0nrlyXi6gPOCLeaqhau2xFnlvKgELwsGYSoKBJyDwqtQ5kwrOlU
+  tkSyLrfZ+RZcH535Hyvif7ZxB0v5OxXXoec+N2vrUsEUMRDL9dg4/WFdN8hIOixF
+  3IPKpZ1ho0Ya5q7yhygtBK9/NBFHw+nbJjcltfPDBXleRe8u73gnQo8AZIhStYSP
+  v4qqqa27Bs468d6SoPxjSm8a2mM9HZ4OdWhq4tFsbTeXDVquCfi64OTEaTt2xQdR
+  JnC4lpJfCP6aCXa5h2XAQfPSH636cQap
+  -----END CERTIFICATE-----
+date: 2019-08-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: strelka
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+- !ruby/object:Gem::Dependency
+  name: yaks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: fluent_fixtures
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: hoe-mercurial
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: hoe-deveiate
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: hoe-highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.17'
+- !ruby/object:Gem::Dependency
+  name: rdoc-generator-fivefish
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+description: |-
+  Strelka-Presenters is a plugin for the Strelka web framework that adds
+  integration with the [Yaks hypermedia library][Yaks].
+email:
+- ged@FaerieMUD.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- History.md
+- LICENSE.txt
+- Manifest.txt
+- README.md
+files:
+- ".document"
+- ".rdoc_options"
+- ".simplecov"
+- ChangeLog
+- History.md
+- LICENSE.txt
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/strelka/app/presenters.rb
+- lib/strelka/httpresponse/presenters.rb
+- lib/strelka/presenters.rb
+- spec/spec_helper.rb
+- spec/strelka/app/presenters_spec.rb
+- spec/strelka/httpresponse/presenters_spec.rb
+- spec/strelka/presenters_spec.rb
+- spec/testlib.rb
+- spec/testlib/base.rb
+- spec/testlib/fixtures.rb
+- spec/testlib/fixtures/groups.rb
+- spec/testlib/fixtures/users.rb
+- spec/testlib/group.rb
+- spec/testlib/presenters.rb
+- spec/testlib/user.rb
+homepage: https://bitbucket.org/ged/strelka-presenters
+licenses:
+- BSD-3-Clause
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Strelka-Presenters is a plugin for the Strelka web framework that adds integration
+  with the [Yaks hypermedia library][Yaks].
+test_files: []