Project

seeren

0.0
No commit activity in last 3 years
No release in over 3 years
The way we build and structure our Views are fundamentally wrong. Views should be composed of multiple interdependent pieces, or components if you will, that when assembled together will work as expected.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 4.0.0
 Project Readme

#Seeren The way we build and structure our Views are fundamentally wrong. Views should be composed of multiple interdependent pieces, or components if you will, that when assembled together will work as expected.

Seeren was built to support the creation process behind this idea. Where you should develop and test your view's look & feel, behavior and assertiveness, as units and later on put them together as whole.

##Getting started

Seeren sets up the an entry point, "/components/:component_name", to your tests.

http://localhost:3000/components/sidebar // sidebar is the component name

It also gives you the option to specify the size of the container that the component should reside. In this way you could write various tests for multiple resolutions.

http://localhost:3000/components/header?width=1024px&height=75px
http://localhost:3000/components/sidebar?width=320px
http://localhost:3000/components/producs?width=800px

Then define all the templates and assets your tests care about in the mapping file (config/seeren_mapping.yml) under the config folder:

header:
  view: application/header
  javascript: header
  stylesheet: header

sidebar:
  view: application/sidebar
  javascript: sidebar
  stylesheet: sidebar

products_list:
  view: products/index
  javascript: products
  stylesheet: products

##Installing

Add this line to your application's Gemfile:

gem 'seeren'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install seeren

And setup the initializer:

require 'seeren'

Seeren.setup do |config|
  config.mapping "#{Rails.root}/config/seeren_mapping.yml"
end

##Credits Many thanks for @leaverou for letting me use her awesome code on my examples: