scenic 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a764a03ca4024bdd13deea0c9a18251b91e664e1
-  data.tar.gz: be3c32867baca5e7c3887372d25f3a40d1f93dd3
+  metadata.gz: 12cc4c93551c150598dd616a1174245760aac19e
+  data.tar.gz: b108ebf2b5d3b3e4d2d3e70410233773ce09481d
 SHA512:
-  metadata.gz: 9afab6aedec2d7167737a4879e8a7f79f3511dc10d0d0b980790cd827035ccec6697c0fb61c401305190f353e72d21543ad2699552ea5eafe7ae0e33877bff68
-  data.tar.gz: da72e6957c563eca8c01601ac99a1876d7b48f1767d55d327b5c60ae8acf53853cda13a4b6b1c8d99af72ec9864fa2d90425afc71e41cd5bdb481cebbe251cc9
+  metadata.gz: be0ede1893de56e1b53309b4cb8bdb035e9e03b573252390214a448c85a6d8bb6e9cd3b0f85a3b0bb8438442497dd24c29a959e6429e74e7fe9e0a272cefc09d
+  data.tar.gz: c4753f41f39bb769246e6793e426a63e899bc0873f74b685dd6644755a6fabc4e6ab4edfe996bd1c631e3735d44c4ab5826daa73b73073191a73091a6a2867e0

data/NEWS.md

@@ -1,8 +1,6 @@
-* Teach view generator to update existing views [683361d](https://github.com/thoughtbot/scenic/commit/683361d59410f46aba508a3ceb850161dd0be027)
-
-
-  *Caleb Thompson*
+New in 0.2.1
+* View generator will now create `db/views` directory if necessary
 
+New in 0.2.0
+* Teach view generator to update existing views [683361d](https://github.com/thoughtbot/scenic/commit/683361d59410f46aba508a3ceb850161dd0be027)
 * Raise an error if view definition is empty. [PR #38](https://github.com/thoughtbot/scenic/issues/38)
-
-  *Caleb Thompson*

data/README.md

@@ -2,6 +2,10 @@
 
 ![Boston cityscape - it's scenic](http://www.california-tour.com/blog/wp-content/uploads/2011/11/skyline-boats-shutterstock-superreduced.jpg)
 
+**Scenic (v0.2.0) is in an early stage of development. While it hasn't been
+tested in an actual application, we are relatively confident in its readiness
+and value, and stand ready to help resolve any issues it may have**
+
 ## Description
 
 Scenic adds methods to ActiveRecord::Migration to create and manage database
@@ -16,7 +20,7 @@ get full SQL syntax highlighting support in the editor of your choice.
 ## Great, how do I create a view?
 
 You've got this great idea for a view you'd like to call `searches`. Create a
-definition file at `db/views/searches_v1.sql` which contains the query you'd
+definition file at `db/views/searches_v01.sql` which contains the query you'd
 like to build your view with. Perhaps that looks something like this:
 
 ```sql
@@ -49,7 +53,7 @@ reversible and it will be dumped into your `schema.rb` file.
 
 ## Cool, but what if I need to change that view?
 
-Add the new query to `db/views/searches_v2.sql` and generate a new migration with
+Add the new query to `db/views/searches_v02.sql` and generate a new migration with
 the following `change` method:
 
 ```ruby
@@ -77,6 +81,44 @@ class Search < ActiveRecord::Base
 end
 ```
 
+## Can you make this easier?
+
+Sure thing. How about some generators?
+
+### Model generator
+
+The `scenic:model` generator builds you a model, view, and migration from
+scratch. `db/views/[model]_v01.sql` wil be an empty file that you fill in only
+the [query] portion of the view with.
+
+[query]: http://www.postgresql.org/docs/current/static/sql-createview.html
+
+```
+$ rails generate scenic:model search
+      create  app/models/search.rb
+      create  db/views/searches_v01.sql
+      create  db/migrate/[TIMESTAMP]_create_searches.rb
+```
+
+### View generator
+
+The `scenic:view` generator is functionally equivalent to `scenic:model` except
+that it doesn't create the model. Convenient.
+
+```
+$ rails generate scenic:view search
+      create  db/views/searches_v01.sql
+      create  db/migrate/[TIMESTAMP]_create_searches.rb
+```
+
+Subsequent invocations will create updated view versions and update migrations:
+
+```
+rails generate scenic:view search
+      create  db/views/searches_v02.sql
+      create  db/migrate/[TIMESTAMP]_update_searches_to_version_2.rb
+```
+
 ## I don't need this view anymore. Make it go away.
 
 We give you `drop_view` too:
@@ -86,11 +128,3 @@ def change
   drop_view :searches, revert_to_version: 2
 end
 ```
-
-## Can you make this easier?
-
-Yeah, we're working on it. We're going to provide some generators that will take
-some of the busy work of file creation away. We'll create the SQL file, the
-migration, and optionally the model for you.
-
-Check out the issue tracker for our other plans.

data/lib/generators/scenic/view/view_generator.rb

@@ -7,6 +7,12 @@ module Scenic
       include Rails::Generators::Migration
       source_root File.expand_path("../templates", __FILE__)
 
+      def create_views_directory
+        unless views_directory_path.exist?
+          empty_directory(views_directory_path)
+        end
+      end
+
       def create_view_definition
         create_file definition.path
       end
@@ -32,7 +38,7 @@ module Scenic
       no_tasks do
         def previous_version
           @previous_version ||=
-            Dir.entries(Rails.root.join(*%w(db views)))
+            Dir.entries(views_directory_path)
               .map { |name| version_regex.match(name).try(:[], "version").to_i }
               .max
         end
@@ -52,6 +58,10 @@ module Scenic
 
       private
 
+      def views_directory_path
+        @views_directory_path ||= Rails.root.join(*%w(db views))
+      end
+
       def version_regex
         /\A#{plural_file_name}_v(?<version>\d+)\.sql\z/
       end

data/lib/scenic/version.rb

@@ -1,3 +1,3 @@
 module Scenic
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/spec/support/generator_spec_setup.rb

@@ -1,5 +1,6 @@
 require "ammeter/rspec/generator/example.rb"
 require "ammeter/rspec/generator/matchers.rb"
+require "ammeter/init"
 
 RSpec.configure do |config|
   config.before(:example, :generator) do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: scenic
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Derek Prior
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-11 00:00:00.000000000 Z
+date: 2015-01-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -186,7 +186,6 @@ files:
 - spec/dummy/config/environments/development.rb
 - spec/dummy/config/environments/test.rb
 - spec/dummy/db/migrate/.keep
-- spec/dummy/db/views/.keep
 - spec/generators/scenic/model/model_generator_spec.rb
 - spec/generators/scenic/view/view_generator_spec.rb
 - spec/integration/revert_spec.rb
@@ -220,7 +219,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: Support for database views in Rails migrations
@@ -238,7 +237,6 @@ test_files:
 - spec/dummy/config/environments/development.rb
 - spec/dummy/config/environments/test.rb
 - spec/dummy/db/migrate/.keep
-- spec/dummy/db/views/.keep
 - spec/generators/scenic/model/model_generator_spec.rb
 - spec/generators/scenic/view/view_generator_spec.rb
 - spec/integration/revert_spec.rb