pg_saurus 2.1.1

data/lib/pg_saurus/schema_dumper/schema_methods.rb

@@ -0,0 +1,27 @@
+# Extends ActiveRecord::SchemaDumper class to dump schemas other than "public"
+# and tables from those schemas.
+module PgSaurus::SchemaDumper::SchemaMethods
+  # Dump create schema statements
+  def header_with_schemas(stream)
+    header_without_schemas(stream)
+    schemas(stream)
+    stream
+  end
+
+  # Generates code to create schemas.
+  def schemas(stream)
+    # Don't create "public" schema since it exists by default.
+    schema_names = PgSaurus::Tools.schemas - ["public", "information_schema"]
+    schema_names.each do |schema_name|
+      schema(schema_name, stream)
+    end
+    stream << "\n"
+  end
+  private :schemas
+
+  # Generates code to create schema.
+  def schema(schema_name, stream)
+    stream << "  create_schema \"#{schema_name}\"\n"
+  end
+  private :schema
+end

data/lib/pg_saurus/schema_dumper/view_methods.rb

@@ -0,0 +1,32 @@
+# Extends ActiveRecord::SchemaDumper class to dump views
+module PgSaurus::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 = PgSaurus::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}\", <<-SQL\n" \
+              "    #{view_definition}\n" \
+              "  SQL\n"
+  end
+  private :write_view_definition
+
+end

data/lib/pg_saurus/schema_dumper.rb

@@ -0,0 +1,28 @@
+# Provides methods to extend {ActiveRecord::SchemaDumper} to appropriately
+# build schema.rb file with schemas, foreign keys and comments on columns
+# and tables.
+module PgSaurus::SchemaDumper
+  extend ActiveSupport::Autoload
+  extend ActiveSupport::Concern
+
+  autoload :ExtensionMethods
+  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, :views
+    alias_method_chain :tables, :comments
+    alias_method_chain :tables, :foreign_keys
+  end
+end

data/lib/pg_saurus/tools.rb

@@ -0,0 +1,104 @@
+module PgSaurus
+  # Provides utility methods to work with PostgreSQL databases.
+  # Usage:
+  #   PgSaurus::Tools.create_schema "services"  # => create new PG schema "services"
+  #   PgSaurus::Tools.create_schema "nets"
+  #   PgSaurus::Tools.drop_schema "services"    # => remove the schema
+  #   PgSaurus::Tools.schemas                   # => ["public", "information_schema", "nets"]
+  #   PgSaurus::Tools.move_table_to_schema :computers, :nets
+  #   PgSaurus::Tools.create_view view_name, view_definition # => creates new DB view
+  #   PgSaurus::Tools.drop_view view_name       # => removes the view
+  #   PgSaurus::Tools.views                     # => ["x_view", "y_view", "z_view"]
+  module Tools
+    extend self
+
+    # Creates PostgreSQL schema
+    def create_schema(schema_name)
+      sql = %{CREATE SCHEMA "#{schema_name}"}
+      connection.execute sql
+    end
+
+    # Create a schema if it does not exist yet.
+    #
+    # @note
+    #   CREATE SCHEMA IF EXISTS appeared only in PostgreSQL 9.3
+    #   It is not used here for backward compatibility.
+    #
+    # @return [void]
+    def create_schema_if_not_exists(schema_name)
+      unless schemas.include?(schema_name.to_s)
+        create_schema(schema_name)
+      end
+    end
+
+    # Ensure schema does not exists.
+    #
+    # @return [void]
+    def drop_schema_if_exists(schema_name)
+      if schemas.include?(schema_name.to_s)
+        drop_schema(schema_name)
+      end
+    end
+
+    # Drops PostgreSQL schema
+    def drop_schema(schema_name)
+      sql = %{DROP SCHEMA "#{schema_name}"}
+      connection.execute sql
+    end
+
+    # Returns an array of existing schemas.
+    def schemas
+      sql = "SELECT nspname FROM pg_namespace WHERE nspname !~ '^pg_.*' order by nspname"
+      connection.query(sql).flatten
+    end
+
+    # Move table to another schema without loosing data, indexes or constraints.
+    # @param [String] table table name (schema prefix is allowed)
+    # @param [String] new_schema schema where table should be moved to
+    def move_table_to_schema(table, new_schema)
+      schema, table = to_schema_and_table(table)
+      sql = %{ALTER TABLE "#{schema}"."#{table}" SET SCHEMA "#{new_schema}"}
+      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
+      ActiveRecord::Base.connection
+    end
+    private :connection
+
+    # Extract schema name and table name from qualified table name
+    # @param [String, Symbol] table_name table name
+    # @return [Array[String, String]] schema and table
+    def to_schema_and_table(table_name)
+      table, schema = table_name.to_s.split(".", 2).reverse
+      schema ||= "public"
+      [schema, table]
+    end
+  end
+end

data/lib/pg_saurus/version.rb

@@ -0,0 +1,4 @@
+module PgSaurus
+  # Version of pg_saurus gem.
+  VERSION = '2.1.1'
+end

data/lib/pg_saurus.rb

@@ -0,0 +1,18 @@
+require "pg_saurus/engine"
+require "pg_saurus/errors"
+
+# Rails engine which allows to use some PostgreSQL features:
+# * Schemas.
+# * Comments on columns and tables.
+# * Foreign keys.
+# * Partial indexes.
+module PgSaurus
+  extend ActiveSupport::Autoload
+
+  autoload :Adapter
+  autoload :SchemaDumper
+  autoload :Tools
+  autoload :Migration
+  autoload :ConnectionAdapters
+  autoload :CreateIndexConcurrently
+end

data/lib/tasks/pg_saurus_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :pg_saurus do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,226 @@
+--- !ruby/object:Gem::Specification
+name: pg_saurus
+version: !ruby/object:Gem::Version
+  version: 2.1.1
+platform: ruby
+authors:
+- Potapov Sergey
+- Arthur Shagall
+- Artem Ignatyev
+- Matt Dressel
+- Bruce Burdick
+- HornsAndHooves
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pg
+  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: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  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'
+- !ruby/object:Gem::Dependency
+  name: metric_fu
+  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'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  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'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  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: ActiveRecord extensions for PostgreSQL. Provides useful tools for schema,
+  foreign_key, index, comment and extension manipulations in migrations.
+email:
+- blake131313@gmail.com
+- arthur.shagall@gmail.com
+- cryo28@gmail.com
+- matt.dressel@gmail.com
+- rubygems.org@bruceburdick.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.markdown
+files:
+- README.markdown
+- lib/colorized_text.rb
+- lib/core_ext/active_record/connection_adapters/abstract/schema_statements.rb
+- lib/core_ext/active_record/connection_adapters/postgresql_adapter.rb
+- lib/core_ext/active_record/errors.rb
+- lib/core_ext/active_record/schema_dumper.rb
+- lib/pg_saurus.rb
+- lib/pg_saurus/connection_adapters.rb
+- lib/pg_saurus/connection_adapters/abstract_adapter.rb
+- lib/pg_saurus/connection_adapters/abstract_adapter/comment_methods.rb
+- lib/pg_saurus/connection_adapters/abstract_adapter/foreigner_methods.rb
+- lib/pg_saurus/connection_adapters/abstract_adapter/index_methods.rb
+- lib/pg_saurus/connection_adapters/abstract_adapter/schema_methods.rb
+- lib/pg_saurus/connection_adapters/foreign_key_definition.rb
+- lib/pg_saurus/connection_adapters/index_definition.rb
+- lib/pg_saurus/connection_adapters/postgresql_adapter.rb
+- lib/pg_saurus/connection_adapters/postgresql_adapter/comment_methods.rb
+- lib/pg_saurus/connection_adapters/postgresql_adapter/extension_methods.rb
+- lib/pg_saurus/connection_adapters/postgresql_adapter/foreigner_methods.rb
+- lib/pg_saurus/connection_adapters/postgresql_adapter/index_methods.rb
+- lib/pg_saurus/connection_adapters/postgresql_adapter/schema_methods.rb
+- lib/pg_saurus/connection_adapters/postgresql_adapter/translate_exception.rb
+- lib/pg_saurus/connection_adapters/postgresql_adapter/view_methods.rb
+- lib/pg_saurus/connection_adapters/table.rb
+- lib/pg_saurus/connection_adapters/table/comment_methods.rb
+- lib/pg_saurus/connection_adapters/table/foreigner_methods.rb
+- lib/pg_saurus/create_index_concurrently.rb
+- lib/pg_saurus/engine.rb
+- lib/pg_saurus/errors.rb
+- lib/pg_saurus/migration.rb
+- lib/pg_saurus/migration/command_recorder.rb
+- lib/pg_saurus/migration/command_recorder/comment_methods.rb
+- lib/pg_saurus/migration/command_recorder/extension_methods.rb
+- lib/pg_saurus/migration/command_recorder/foreigner_methods.rb
+- lib/pg_saurus/migration/command_recorder/schema_methods.rb
+- lib/pg_saurus/migration/command_recorder/view_methods.rb
+- lib/pg_saurus/schema_dumper.rb
+- lib/pg_saurus/schema_dumper/comment_methods.rb
+- lib/pg_saurus/schema_dumper/extension_methods.rb
+- lib/pg_saurus/schema_dumper/foreigner_methods.rb
+- lib/pg_saurus/schema_dumper/schema_methods.rb
+- lib/pg_saurus/schema_dumper/view_methods.rb
+- lib/pg_saurus/tools.rb
+- lib/pg_saurus/version.rb
+- lib/tasks/pg_saurus_tasks.rake
+homepage: https://github.com/HornsAndHooves/pg_saurus
+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: ActiveRecord extensions for PostgreSQL.
+test_files: []