pg_power 1.5.0 → 1.6.0

data/README.markdown

@@ -235,6 +235,17 @@ Unload extension module:
   drop_extension "fuzzystrmatch"
 ```
 
+## Views
+
+Version 1.6.0 introduces experimental support for creating views. This API should only be used with the understanding
+that it is preliminary 'alpha' at best.
+
+### Example
+
+```ruby
+  create_view "demography.citizens_view", "select * from demography.citizens"
+```
+
 ## Tools
 
 PgPower::Tools provides number of useful methods:

data/lib/pg_power/connection_adapters/postgresql_adapter.rb

@@ -11,6 +11,7 @@ module PgPower::ConnectionAdapters::PostgreSQLAdapter
   autoload :ForeignerMethods,   'pg_power/connection_adapters/postgresql_adapter/foreigner_methods'
   autoload :IndexMethods,       'pg_power/connection_adapters/postgresql_adapter/index_methods'
   autoload :TranslateException, 'pg_power/connection_adapters/postgresql_adapter/translate_exception'
+  autoload :ViewMethods,        'pg_power/connection_adapters/postgresql_adapter/view_methods'
 
   include ExtensionMethods
   include SchemaMethods
@@ -18,4 +19,5 @@ module PgPower::ConnectionAdapters::PostgreSQLAdapter
   include ForeignerMethods
   include IndexMethods
   include TranslateException
+  include ViewMethods
 end

data/lib/pg_power/connection_adapters/postgresql_adapter/view_methods.rb

@@ -0,0 +1,17 @@
+# Provides methods to extend {ActiveRecord::ConnectionAdapters::PostgreSQLAdapter}
+# to support views feature.
+module PgPower::ConnectionAdapters::PostgreSQLAdapter::ViewMethods
+  # Creates new view in DB.
+  # @param [String, Symbol] view_name
+  # @param [String] view_definition
+  def create_view(view_name, view_definition)
+    ::PgPower::Tools.create_view(view_name, view_definition)
+  end
+
+  # Drops view in DB.
+  # @param [String, Symbol] view_name
+  def drop_view(view_name)
+    ::PgPower::Tools.drop_view(view_name)
+  end
+
+end

data/lib/pg_power/migration/command_recorder.rb

@@ -7,9 +7,11 @@ module PgPower::Migration::CommandRecorder
   autoload :SchemaMethods
   autoload :CommentMethods
   autoload :ForeignerMethods
+  autoload :ViewMethods
 
   include ExtensionMethods
   include SchemaMethods
   include CommentMethods
   include ForeignerMethods
+  include ViewMethods
 end

data/lib/pg_power/migration/command_recorder/view_methods.rb

@@ -0,0 +1,24 @@
+# Provides methods to extend {ActiveRecord::Migration::CommandRecorder} to
+# support view feature.
+module  PgPower::Migration::CommandRecorder::ViewMethods
+  
+  # Creates PostgreSQL view
+  # @param [String, Symbol] view_name
+  # @param [String] view_definition
+  def create_view(*args)
+    record(:create_view, args)
+  end
+
+  # Drops view in DB.
+  # @param [String, Symbol] view_name
+  def drop_view(*args)
+    record(:drop_view, args)
+  end
+
+  # Inverts creation of a view in DB.
+  # @param [String, Symbol] view_name
+  def invert_create_view(args)
+    [:drop_view, [args.first]]
+  end
+  
+end

data/lib/pg_power/schema_dumper.rb

@@ -9,17 +9,20 @@ module PgPower::SchemaDumper
   autoload :CommentMethods
   autoload :SchemaMethods
   autoload :ForeignerMethods
+  autoload :ViewMethods
 
   include ExtensionMethods
   include CommentMethods
   include SchemaMethods
   include ForeignerMethods
+  include ViewMethods
 
   included do
     alias_method_chain :header, :schemas
     alias_method_chain :header, :extensions
 
     alias_method_chain :tables, :schemas
+    alias_method_chain :tables, :views
     alias_method_chain :tables, :comments
     alias_method_chain :tables, :foreign_keys
   end

data/lib/pg_power/schema_dumper/view_methods.rb

@@ -0,0 +1,27 @@
+# Extends ActiveRecord::SchemaDumper class to dump views
+module PgPower::SchemaDumper::ViewMethods
+  # Dump create view statements
+  def tables_with_views(stream)
+    tables_without_views(stream)
+    views(stream)
+    stream
+  end
+  
+  # Generates code to create views.
+  def views(stream)
+    # Don't create "system" views.
+    view_names = PgPower::Tools.views
+    view_names.each do |options|
+      write_view_definition(stream, options["table_schema"], options["table_name"], options["view_definition"])
+    end
+    stream << "\n"
+  end
+  private :views
+
+  # Generates code to create view.
+  def write_view_definition(stream, table_schema, table_name, view_definition)
+    stream << "  create_view \"#{table_schema}.#{table_name}\", \"#{view_definition}\"\n"
+  end
+  private :write_view_definition
+
+end

data/lib/pg_power/tools.rb

@@ -6,6 +6,9 @@ module PgPower
   #   PgPower::Tools.drop_schema "services"    # => remove the schema
   #   PgPower::Tools.schemas                   # => ["public", "information_schema", "nets"]
   #   PgPower::Tools.move_table_to_schema :computers, :nets
+  #   PgPower::Tools.create_view view_name, view_definition # => creates new DB view
+  #   PgPower::Tools.drop_view view_name       # => removes the view
+  #   PgPower::Tools.views                     # => ["x_view", "y_view", "z_view"]
   module Tools
     extend self
 
@@ -36,7 +39,30 @@ module PgPower
       connection.execute sql
     end
 
-
+    # Creates PostgreSQL view
+    # @param [String, Symbol] view_name
+    # @param [String] view_definition
+    def create_view(view_name, view_definition)
+      sql = "CREATE VIEW #{view_name} AS #{view_definition}"
+      connection.execute sql
+    end
+    
+    # Drops PostgreSQL view
+    # @param [String, Symbol] view_name
+    def drop_view(view_name)
+      sql = "DROP VIEW #{view_name}"
+      connection.execute sql
+    end
+    
+    # Returns an array of existing, non system views.
+    def views
+      sql = <<-SQL
+      SELECT table_schema, table_name, view_definition
+      FROM INFORMATION_SCHEMA.views
+      WHERE table_schema NOT IN ('pg_catalog','information_schema')
+      SQL
+      connection.execute sql
+    end
 
     # Return database connections
     def connection

data/lib/pg_power/version.rb

@@ -1,4 +1,4 @@
 module PgPower
   # Version of pg_power gem.
-  VERSION = "1.5.0"
+  VERSION = '1.6.0'
 end

metadata

@@ -1,15 +1,10 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: pg_power
-version: !ruby/object:Gem::Version 
-  hash: 3
+version: !ruby/object:Gem::Version
+  version: 1.6.0
   prerelease: 
-  segments: 
-  - 1
-  - 5
-  - 0
-  version: 1.5.0
 platform: ruby
-authors: 
+authors:
 - Potapov Sergey
 - Arthur Shagall
 - Artem Ignatyev
@@ -17,132 +12,129 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-05-14 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id001
+date: 2013-06-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: pg
-  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-- !ruby/object:Gem::Dependency 
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id002
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: rspec-rails
-  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-- !ruby/object:Gem::Dependency 
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 5
-        segments: 
-        - 3
-        - 1
-        version: "3.1"
-  version_requirements: *id003
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: rails
-  prerelease: false
-  type: :runtime
-- !ruby/object:Gem::Dependency 
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id004
-  name: rcov
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
   prerelease: false
-  type: :development
-- !ruby/object:Gem::Dependency 
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id005
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
   name: yard
-  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-- !ruby/object:Gem::Dependency 
-  requirement: &id006 !ruby/object:Gem::Requirement 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id006
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: metrical
-  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-- !ruby/object:Gem::Dependency 
-  requirement: &id007 !ruby/object:Gem::Requirement 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id007
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: jeweler
-  prerelease: false
-  type: :development
-- !ruby/object:Gem::Dependency 
-  requirement: &id008 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id008
-  name: ruby-debug
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
   prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-debug19
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-description: ActiveRecord extensions for PostgreSQL. Provides useful tools for schema, foreign_key, index, comment and extensios manipulations in migrations.
-email: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ActiveRecord extensions for PostgreSQL. Provides useful tools for schema,
+  foreign_key, index, comment and extensios manipulations in migrations.
+email:
 - rubygems@tmxcredit.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - README.markdown
-files: 
+files:
 - README.markdown
 - lib/core_ext/active_record/connection_adapters/abstract/schema_statements.rb
 - lib/core_ext/active_record/connection_adapters/postgresql_adapter.rb
@@ -164,6 +156,7 @@ files:
 - lib/pg_power/connection_adapters/postgresql_adapter/index_methods.rb
 - lib/pg_power/connection_adapters/postgresql_adapter/schema_methods.rb
 - lib/pg_power/connection_adapters/postgresql_adapter/translate_exception.rb
+- lib/pg_power/connection_adapters/postgresql_adapter/view_methods.rb
 - lib/pg_power/connection_adapters/table.rb
 - lib/pg_power/connection_adapters/table/comment_methods.rb
 - lib/pg_power/connection_adapters/table/foreigner_methods.rb
@@ -176,46 +169,39 @@ files:
 - lib/pg_power/migration/command_recorder/extension_methods.rb
 - lib/pg_power/migration/command_recorder/foreigner_methods.rb
 - lib/pg_power/migration/command_recorder/schema_methods.rb
+- lib/pg_power/migration/command_recorder/view_methods.rb
 - lib/pg_power/schema_dumper.rb
 - lib/pg_power/schema_dumper/comment_methods.rb
 - lib/pg_power/schema_dumper/extension_methods.rb
 - lib/pg_power/schema_dumper/foreigner_methods.rb
 - lib/pg_power/schema_dumper/schema_methods.rb
+- lib/pg_power/schema_dumper/view_methods.rb
 - lib/pg_power/tools.rb
 - lib/pg_power/version.rb
 - lib/tasks/pg_power_tasks.rake
 homepage: https://github.com/TMXCredit/pg_power
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: ActiveRecord extensions for PostgreSQL.
 test_files: []
-
+has_rdoc: