rails-views 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3ae8972add2a53443f5b235f7df245d217c61436
-  data.tar.gz: 12f44ead6c7793405f265e644fbef871c9e2c1ce
+  metadata.gz: 43d95d67a1de149edea1976ccfa7b7ea92d07536
+  data.tar.gz: f1451d23405a5c7f3ed13dbb81e2be8f75a290a4
 SHA512:
-  metadata.gz: cee8a0727682c17cdf19e41b6225c077aef8ff9229b9dd7c5738e630a8de0123c59be6ac1de146693ed29554939f198dac579025ac749780a65efcd7fc71f0ac
-  data.tar.gz: a75815bcdf39e3c8866afdca5989efedfcadd88524a6546fed414eee919b6c5ea259527c023891e150c997ec4292e38ae9fc792f001ffec754c6a718ba13750c
+  metadata.gz: 465fd157e02dd032305a8de09724b0473b699698ab863710b541263cabb80db1787ee21ae19ab5352b4422b427d595a051332d3597b43e7923da4936895014b7
+  data.tar.gz: 1a2a284a8bbab8ce663b77bac9a70283411f1e4df96bbda9c785c5f1cf63ff46ceb02c9f48c5aac62c5833750c174999deea66d7b68a6d53882c158dd437fdfe

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2017 Roman Dubrovsky
+Copyright (c) 2017 datarockets
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,38 +1,127 @@
-# Cells::Helpers
+# Rails::Views
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/cells/helpers`. To experiment with that code, run `bin/console` for an interactive prompt.
+*View Components for Ruby and Rails.*
 
-TODO: Delete this and the text above, and describe your gem
+The gem provides view models for Ruby web applications. View models are plain objects that represent a part of the web page. View models can also render views, and be nested.
+
+This gem bases on [cells](https://github.com/trailblazer/cells).
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'cells-helpers'
+gem 'rails-views'
 ```
 
 And then execute:
 
     $ bundle
 
-Or install it yourself as:
+## Usage
 
-    $ gem install cells-helpers
+This gem bases on [cells](https://github.com/trailblazer/cells), but includes only `Concept` logic.
 
-## Usage
+A view is a light-weight class with `show.slim` temlate with base view logic.
 
-TODO: Write usage instructions here
+```ruby
+class Comment::Cell < Rails::View
 
-## Development
+  private
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+  property :body, :author
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+  def author_link
+    link_to "#{author.email}", author
+  end
+end
+```
+
+## Rendering
+
+Gem provides logic for rendering cells instead of ActionView templates.
+
+```ruby
+def CommentsController < ApplicationController
+  def index
+    render cell: true # will render Comments::Cell
+  end
+
+  def show
+    @comment = Comment.find(params[:id])
+    render cell: :show, model: @comment # will render Comments::Show::Cell with @comment as model
+  end
+
+  def new
+    @comment = Comment.new
+    @user = User.find(params[:user_id])
+    render cell: 'user/comment', model: @comment, options: {user: @user} # will render User::Comment::Cell with @comment as model and user options
+  end
+end
+```
+
+## Helpers
+
+Also gem provides new helpers for rails.
+
+### Flash
+
+Provide method for working with flash.
+
+```ruby
+= flash[:notice]
+```
+
+### Render partials array
+
+Method `render_each_and_join` can render array of templates and join it in one string.
+
+```ruby
+class User::Info::Cell < Rails::View
+  private
+
+  def parts_of_info
+    %w(contact_information about jobs transactions_list)
+  end
+
+  def info_body
+    render_each_and_join(parts_of_info)
+  end
+end
+
+class User::ShortInfo::Cell < User::Info::Cell
+  private
+
+  def parts_of_info
+    %w(contact_information about)
+  end
+end
+```
+
+### Options
+
+Provide `options` reader. You can have automatic readers to the options's fields by using `::option`
+
+```ruby
+class User::Comment::Cell < Rails::View
+  private
+    options :user # delegate to options[:user]
+
+    delegate :email, to: :user, prefix: true
+end
+```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/cells-helpers.
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Run the test suite and check the output (`rake`)
+4. Add tests for your feature or fix (please)
+5. Commit your changes (`git commit -am 'Add some feature'`)
+6. Push to the branch (`git push origin my-new-feature`)
+7. Create new Pull Request
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/datarockets/rails-views
 
 
 ## License

data/lib/rails/view.rb

@@ -0,0 +1,17 @@
+module Rails
+  class View < Cell::Concept
+    include ::Cell::Slim
+    include ::Cell::Builder
+    include ::Rails.application.routes.url_helpers
+    include Rails::Views::ViewHelpers
+
+    include ActionView::Helpers
+    include AbstractController::Helpers
+    include ActionDispatch::Http::Cache::Request
+    include ActionView::RecordIdentifier
+
+    def show
+      render
+    end
+  end
+end

data/lib/rails/views.rb

@@ -1,3 +1,5 @@
+require 'rails/view'
+
 require 'rails/views/version'
 require 'rails/views/view_helpers'
 require 'rails/views/railtie'

data/lib/rails/views/version.rb

@@ -1,5 +1,5 @@
 module Rails
   class Views
-    VERSION = '0.1.0'.freeze
+    VERSION = '0.2.0'.freeze
   end
 end

data/rails-views.gemspec

@@ -7,24 +7,20 @@ Gem::Specification.new do |spec|
   spec.name          = 'rails-views'
   spec.version       = Rails::Views::VERSION
   spec.authors       = ['Roman Dubrovsky']
-  spec.email         = ['roma2107946@gmail.com']
+  spec.email         = ['hello@datarockets.com']
 
-  spec.summary       = 'Datarockets cells helpers'
-  spec.description   = 'Helpers for easy working and clear code'
+  spec.summary       = 'Real view objects for Rails'
+  spec.description   = 'Real view objects for Rails'
   spec.homepage      = 'https://github.com/datarockets/rails-views'
   spec.license       = 'MIT'
 
-  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
-  # delete this section to allow pushing this gem to any host.
-  # if spec.respond_to?(:metadata)
-  #   spec.metadata['allowed_push_host'] = "'http://mygemserver.com'"
-  # else
-  #   raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
-  # end
-
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.require_paths = ['lib']
 
+  spec.add_dependency 'cells'
+  spec.add_dependency 'cells-rails'
+  spec.add_dependency 'cells-slim'
+
   spec.add_development_dependency 'bundler', '~> 1.10'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec'

metadata

@@ -1,15 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: rails-views
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Roman Dubrovsky
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-05 00:00:00.000000000 Z
+date: 2017-01-11 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: cells
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cells-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cells-slim
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -80,9 +122,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Helpers for easy working and clear code
+description: Real view objects for Rails
 email:
-- roma2107946@gmail.com
+- hello@datarockets.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -95,6 +137,7 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- lib/rails/view.rb
 - lib/rails/views.rb
 - lib/rails/views/controller_helpers.rb
 - lib/rails/views/railtie.rb
@@ -124,5 +167,5 @@ rubyforge_project:
 rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
-summary: Datarockets cells helpers
+summary: Real view objects for Rails
 test_files: []