rails_apps_pages 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ba3a1a31cdbd9801ce11a4c2f6770185edfb83b2
+  data.tar.gz: 608cfffbc48fc019767260605bf2d5e8863ce06c
+SHA512:
+  metadata.gz: c13ac0bb6597651c329ca3cedfa1e9d45faa9e7eabe3cdee228ce410aebdef5f0fc838739b3e686e2c9768541b01252053917d1118204067f82f45624bbb3422
+  data.tar.gz: 3f2f2ae34a86c319a2659785ead8aa11661d7090baf3e96d575ebced6340a137846cdc7ab5d9e57e5f19112a4582f5ee38a9fbf30a63f40f78052da613c7f906

data/.gitignore

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.DS_Store

data/.ruby-gemset

@@ -0,0 +1 @@
+rails_apps_pages

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.1.1

data/CHANGELOG.textile

@@ -0,0 +1,5 @@
+h1. CHANGELOG
+
+h3. 0.1.0 May 1, 2014
+
+* initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rails_apps_pages.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Daniel Kehoe
+
+MIT License
+
+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/README.textile

@@ -0,0 +1,153 @@
+h1. !http://railsapps.github.io/images/rails-36x36.jpg(RailsApps Page Gem)! RailsApps Pages Gem
+
+Use this gem to add pages to a Rails application, including controllers, views, and routing.
+
+RailsApps Pages is a utility gem to use during development. You can remove it after generating the pages you need. It was originally written for use by the "Rails Composer":http://railsapps.github.io/rails-composer/ tool. Use Rails Composer to build any of the "RailApps example applications":http://railsapps.github.io/ for use as starter apps.
+
+If you like the RailsApps Pages gem, you might be interested in the "RailsLayout gem":https://github.com/RailsApps/rails_layout which generates Rails application layout files for various front-end frameworks such as Bootstrap and Foundation.
+
+h4. !http://railsapps.github.io/images/join/join-railsapps.png(Join RailsApps)!:http://railsapps.github.io/
+
+h4. Support the RailsApps Project
+
+If the RailsApps Pages gem is useful to you, please accept our invitation to "join the RailsApps project":http://railsapps.github.io/. The RailsApps project provides example applications, tutorials, and starter tools, including the RailsApps Pages gem.
+
+h2. Install the Gem
+
+Add the gem to your Rails application Gemfile:
+
+<pre>
+group :development do
+  gem 'rails_apps_pages'
+end
+</pre>
+
+You don't need the RailsApps Pages gem deployed to production, so put it in the @development@ group.
+
+If you want to use a newer unreleased version from GitHub:
+
+<pre>
+group :development do
+  gem 'rails_apps_pages', github: 'RailsApps/rails_apps_pages'
+end
+</pre>
+
+h4. Use Bundler
+
+Use Bundler to install the gems:
+
+<pre>
+$ bundle install
+</pre>
+
+h2. Generate a Home Page
+
+To run the generator and create a home page:
+
+<pre>
+$ rails generate pages:home
+</pre>
+
+The generator will create:
+
+* app/views/visitors/index.html.erb
+* app/controllers/visitors_controller.rb
+
+It will add a route to the *config/routes.rb* file:
+
+<pre>
+root :to => "visitors#index"
+</pre>
+
+Why a "Visitors" controller? Why not a "Home" controller or "Welcome" controller? Those names are acceptable. But the home page often implements a user story for a persona named "visitor," so a "Visitors" controller is appropriate.
+
+h2. Generate User Pages Requiring Authentication
+
+If you have a User model and authentication with Devise, you might want to add pages to display a list of users or each user's profile, restricted to logged in users.
+
+To run the generator and create pages to accompany a User model:
+
+<pre>
+$ rails generate pages:users
+</pre>
+
+The generator will create:
+
+* app/views/visitors/index.html.erb
+* app/controllers/visitors_controller.rb
+* app/views/users/_user.html.erb
+* app/views/users/index.html.erb
+* app/views/users/show.html.erb
+* app/controllers/users_controller.rb
+
+It will add routes to the *config/routes.rb* file:
+
+<pre>
+resources :users
+root :to => "visitors#index"
+</pre>
+
+h2. Generate User Pages Requiring Authorization
+
+If you have a User model, authentication with Devise, and authorization with Pundit, you might want to add pages to display a list of users, restricted to an administrator. Each user can see his or her own profile if logged in.
+
+To run the generator and create pages to accompany a User model:
+
+<pre>
+$ rails generate pages:authorized
+</pre>
+
+The generator will create:
+
+* app/views/visitors/index.html.erb
+* app/controllers/visitors_controller.rb
+* app/views/users/_user.html.erb
+* app/views/users/index.html.erb
+* app/views/users/show.html.erb
+* app/controllers/users_controller.rb
+
+It will add routes to the *config/routes.rb* file:
+
+<pre>
+resources :users
+root :to => "visitors#index"
+</pre>
+
+All files are identical to the @rails generate pages:users@ generator, except:
+
+* app/views/users/_user.html.erb
+* app/controllers/users_controller.rb
+
+h2. Clean a Gemfile
+
+Remove commented lines and multiple blank lines from a Gemfile:
+
+<pre>
+$ rails generate clean:gemfile
+</pre>
+
+h2. Clean a Routes File
+
+Remove commented lines and multiple blank lines from the file *config/routes.rb*:
+
+<pre>
+$ rails generate clean:routes
+</pre>
+
+h2. Issues
+
+Any issues? Please create an "issue":http://github.com/RailsApps/rails_apps_pages/issues on GitHub. Reporting issues (and patching!) helps everyone.
+
+h2. Credits
+
+Daniel Kehoe maintains this gem as part of the "RailsApps project":http://railsapps.github.io/.
+
+Please see the "CHANGELOG":https://github.com/RailsApps/rails_apps_pages/blob/master/CHANGELOG.textile for a list of contributors.
+
+Is the gem useful to you? Follow the project on Twitter: "@rails_apps":http://twitter.com/rails_apps. I'd love to know you were helped out by the gem.
+
+h2. MIT License
+
+"MIT License":http://www.opensource.org/licenses/mit-license
+
+Copyright © 2014 Daniel Kehoe

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/generators/clean/gemfile_generator.rb

@@ -0,0 +1,17 @@
+require 'rails/generators'
+
+module Clean
+  module Generators
+    class GemfileGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      desc "remove commented lines and multiple blank lines from a Gemfile"
+
+      def clean_gemfile
+        gsub_file 'Gemfile', /#.*\n/, "\n"
+        gsub_file 'Gemfile', /\n^\s*\n/, "\n"
+      end
+
+    end
+  end
+end

data/lib/generators/clean/routes_generator.rb

@@ -0,0 +1,17 @@
+require 'rails/generators'
+
+module Clean
+  module Generators
+    class RoutesGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      desc "remove commented lines and multiple blank lines from config/routes.rb"
+
+      def clean_gemfile
+        gsub_file 'config/routes.rb', /  #.*\n/, "\n"
+        gsub_file 'config/routes.rb', /\n^\s*\n/, "\n"
+      end
+
+    end
+  end
+end

data/lib/generators/pages/authorized/authorized_generator.rb

@@ -0,0 +1,25 @@
+require 'rails/generators'
+
+module Pages
+  module Generators
+    class AuthorizedGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      desc "Create pages to accompany a User model when authorization is available."
+
+      def create_page
+        copy_file 'users/_user.html.erb', 'app/views/users/_user.html.erb'
+        copy_file 'users/index.html.erb', 'app/views/users/index.html.erb'
+        copy_file 'users/show.html.erb', 'app/views/users/show.html.erb'
+        copy_file 'users_controller.rb', 'app/controllers/users_controller.rb'
+        route = '  resources :users'
+        inject_into_file 'config/routes.rb', route + "\n", :before => "end"
+        copy_file 'visitors/index.html.erb', 'app/views/visitors/index.html.erb'
+        copy_file 'visitors_controller.rb', 'app/controllers/visitors_controller.rb'
+        route = '  root :to => "visitors#index"'
+        inject_into_file 'config/routes.rb', route + "\n", :after => "routes.draw do\n"
+      end
+
+    end
+  end
+end

data/lib/generators/pages/authorized/templates/users/_user.html.erb

@@ -0,0 +1,12 @@
+<td>
+  <%= link_to user.email, user %>
+</td>
+<td>
+  <%= form_for(user) do |f| %>
+    <%= f.select(:role, User.roles.keys.map {|role| [role.titleize,role]}) %>
+    <%= f.submit 'Change Role', :class => 'button-xs' %>
+  <% end %>
+</td>
+<td>
+  <%= link_to("Delete user", user_path(user), :data => { :confirm => "Are you sure?" }, :method => :delete, :class => 'button-xs') unless user == current_user %>
+</td>

data/lib/generators/pages/authorized/templates/users/index.html.erb

@@ -0,0 +1,16 @@
+<div class="container">
+  <div class="row">
+    <h3>Users</h3>
+    <div class="column">
+      <table class="table">
+        <tbody>
+          <% @users.each do |user| %>
+            <tr>
+              <%= render user %>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</div>

data/lib/generators/pages/authorized/templates/users/show.html.erb

@@ -0,0 +1,2 @@
+<h3>User</h3>
+<p>Email: <%= @user.email if @user.email %></p>

data/lib/generators/pages/authorized/templates/users_controller.rb

@@ -0,0 +1,46 @@
+class UsersController < ApplicationController
+  before_filter :authenticate_user!
+  after_action :verify_authorized, except: [:show]
+
+  def index
+    @users = User.all
+    authorize @users
+  end
+
+  def show
+    @user = User.find(params[:id])
+    unless current_user.admin?
+      unless @user == current_user
+        redirect_to root_path, :alert => "Access denied."
+      end
+    end
+  end
+
+  def update
+    @user = User.find(params[:id])
+    authorize @user
+    if @user.update_attributes(secure_params)
+      redirect_to users_path, :notice => "User updated."
+    else
+      redirect_to users_path, :alert => "Unable to update user."
+    end
+  end
+
+  def destroy
+    user = User.find(params[:id])
+    authorize user
+    unless user == current_user
+      user.destroy
+      redirect_to users_path, :notice => "User deleted."
+    else
+      redirect_to users_path, :notice => "Can't delete yourself."
+    end
+  end
+
+  private
+
+  def secure_params
+    params.require(:user).permit(:role)
+  end
+
+end

data/lib/generators/pages/authorized/templates/visitors/index.html.erb

@@ -0,0 +1,2 @@
+<h3>Welcome</h3>
+<p><%= link_to 'Users:', users_path %> <%= User.count %> registered</p>

data/lib/generators/pages/authorized/templates/visitors_controller.rb

@@ -0,0 +1,2 @@
+class VisitorsController < ApplicationController
+end

data/lib/generators/pages/home/home_generator.rb

@@ -0,0 +1,19 @@
+require 'rails/generators'
+
+module Pages
+  module Generators
+    class HomeGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      desc "Create a home page"
+
+      def create_page
+        copy_file 'index.html.erb', 'app/views/visitors/index.html.erb'
+        copy_file 'visitors_controller.rb', 'app/controllers/visitors_controller.rb'
+        route = '  root :to => "visitors#index"'
+        inject_into_file 'config/routes.rb', route + "\n", :after => "routes.draw do\n"
+      end
+
+    end
+  end
+end

data/lib/generators/pages/home/templates/index.html.erb

@@ -0,0 +1 @@
+<h3>Welcome</h3>

data/lib/generators/pages/home/templates/visitors_controller.rb

@@ -0,0 +1,2 @@
+class VisitorsController < ApplicationController
+end

data/lib/generators/pages/users/templates/users/_user.html.erb

@@ -0,0 +1,3 @@
+<td>
+  <%= link_to user.email, user %>
+</td>

data/lib/generators/pages/users/templates/users/index.html.erb

@@ -0,0 +1,16 @@
+<div class="container">
+  <div class="row">
+    <h3>Users</h3>
+    <div class="column">
+      <table class="table">
+        <tbody>
+          <% @users.each do |user| %>
+            <tr>
+              <%= render user %>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</div>

data/lib/generators/pages/users/templates/users/show.html.erb

@@ -0,0 +1,2 @@
+<h3>User</h3>
+<p>Email: <%= @user.email if @user.email %></p>

data/lib/generators/pages/users/templates/users_controller.rb

@@ -0,0 +1,12 @@
+class UsersController < ApplicationController
+  before_filter :authenticate_user!
+
+  def index
+    @users = User.all
+  end
+
+  def show
+    @user = User.find(params[:id])
+  end
+
+end

data/lib/generators/pages/users/templates/visitors/index.html.erb

@@ -0,0 +1,2 @@
+<h3>Welcome</h3>
+<p><%= link_to 'Users:', users_path %> <%= User.count %> registered</p>

data/lib/generators/pages/users/templates/visitors_controller.rb

@@ -0,0 +1,2 @@
+class VisitorsController < ApplicationController
+end

data/lib/generators/pages/users/users_generator.rb

@@ -0,0 +1,25 @@
+require 'rails/generators'
+
+module Pages
+  module Generators
+    class UsersGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      desc "Create pages to accompany a User model when authentication is available."
+
+      def create_page
+        copy_file 'users/_user.html.erb', 'app/views/users/_user.html.erb'
+        copy_file 'users/index.html.erb', 'app/views/users/index.html.erb'
+        copy_file 'users/show.html.erb', 'app/views/users/show.html.erb'
+        copy_file 'users_controller.rb', 'app/controllers/users_controller.rb'
+        route = '  resources :users'
+        inject_into_file 'config/routes.rb', route + "\n", :before => "end"
+        copy_file 'visitors/index.html.erb', 'app/views/visitors/index.html.erb'
+        copy_file 'visitors_controller.rb', 'app/controllers/visitors_controller.rb'
+        route = '  root :to => "visitors#index"'
+        inject_into_file 'config/routes.rb', route + "\n", :after => "routes.draw do\n"
+      end
+
+    end
+  end
+end

data/lib/rails_apps_pages.rb

@@ -0,0 +1,5 @@
+require "rails_apps_pages/version"
+
+module RailsAppsPages
+  # Your code goes here...
+end

data/lib/rails_apps_pages/version.rb

@@ -0,0 +1,3 @@
+module RailsAppsPages
+  VERSION = "0.1.0"
+end

data/rails_apps_pages.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rails_apps_pages/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "rails_apps_pages"
+  spec.version       = RailsAppsPages::VERSION
+  spec.authors       = ["Daniel Kehoe"]
+  spec.email         = ["daniel@danielkehoe.com"]
+  spec.summary       = %q{Add pages to a Rails application, including controllers, views, and routing.}
+  spec.description   = %q{A utility gem to use during development. Generates controllers, views, and routing.}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: rails_apps_pages
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Daniel Kehoe
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A utility gem to use during development. Generates controllers, views,
+  and routing.
+email:
+- daniel@danielkehoe.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-gemset"
+- ".ruby-version"
+- CHANGELOG.textile
+- Gemfile
+- LICENSE.txt
+- README.textile
+- Rakefile
+- lib/generators/clean/gemfile_generator.rb
+- lib/generators/clean/routes_generator.rb
+- lib/generators/pages/authorized/authorized_generator.rb
+- lib/generators/pages/authorized/templates/users/_user.html.erb
+- lib/generators/pages/authorized/templates/users/index.html.erb
+- lib/generators/pages/authorized/templates/users/show.html.erb
+- lib/generators/pages/authorized/templates/users_controller.rb
+- lib/generators/pages/authorized/templates/visitors/index.html.erb
+- lib/generators/pages/authorized/templates/visitors_controller.rb
+- lib/generators/pages/home/home_generator.rb
+- lib/generators/pages/home/templates/index.html.erb
+- lib/generators/pages/home/templates/visitors_controller.rb
+- lib/generators/pages/users/templates/users/_user.html.erb
+- lib/generators/pages/users/templates/users/index.html.erb
+- lib/generators/pages/users/templates/users/show.html.erb
+- lib/generators/pages/users/templates/users_controller.rb
+- lib/generators/pages/users/templates/visitors/index.html.erb
+- lib/generators/pages/users/templates/visitors_controller.rb
+- lib/generators/pages/users/users_generator.rb
+- lib/rails_apps_pages.rb
+- lib/rails_apps_pages/version.rb
+- rails_apps_pages.gemspec
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Add pages to a Rails application, including controllers, views, and routing.
+test_files: []