schema-evolution-manager 0.9.24

data/scripts/20130318-105434.sql

@@ -0,0 +1,64 @@
+-- This script initializes the schema_evolution_manager schema and the scripts and
+-- the bootstrap_scripts tables
+
+create schema schema_evolution_manager;
+
+SET search_path TO schema_evolution_manager;
+
+create or replace function table_exists(p_schema_name character varying, p_table_name character varying) returns boolean
+    language plpgsql
+    as $$
+begin
+  perform 1 from information_schema.tables where table_schema = p_schema_name and table_name=p_table_name and table_type='BASE TABLE';
+  return found;
+end;
+$$;
+
+create or replace function create_tables() returns void
+    language plpgsql
+    as $$
+begin
+  if not table_exists('schema_evolution_manager', 'scripts') then
+
+    create table schema_evolution_manager.scripts (
+      id           bigserial,
+      filename     varchar(100) not null,
+      created_at   timestamp with time zone default now() not null
+    );
+
+    alter table schema_evolution_manager.scripts add constraint scripts_id_pk primary key(id);
+    alter table schema_evolution_manager.scripts add constraint scripts_filename_un unique(filename);
+
+    comment on table schema_evolution_manager.scripts is '
+      When a script is applied to this database, the script is recorded
+      here. This table is the used to ensure scripts are applied at most
+      once to this database.
+    ';
+
+  end if;
+
+  if not table_exists('schema_evolution_manager', 'bootstrap_scripts') then
+
+    create table schema_evolution_manager.bootstrap_scripts (
+      id           bigserial,
+      filename     varchar(100) not null,
+      created_at   timestamp with time zone default now() not null
+    );
+
+    alter table schema_evolution_manager.bootstrap_scripts add constraint bootstrap_scripts_id_pk primary key(id);
+    alter table schema_evolution_manager.bootstrap_scripts add constraint bootstrap_scripts_filename_un unique(filename);
+
+    comment on table schema_evolution_manager.bootstrap_scripts is '
+      Internal list of schema_evolution_manager sql scripts applied. Used only for upgrades
+      to schema_evolution_manager itself.
+    ';
+
+  end if;
+
+end;
+$$;
+
+select create_tables();
+
+drop function create_tables();
+drop function table_exists(character varying, character varying);

data/scripts/20130318-105456.sql

@@ -0,0 +1,135 @@
+-- library of common utility functions
+set search_path to schema_evolution_manager;
+
+CREATE OR REPLACE FUNCTION create_basic_audit_data(p_schema_name character varying, p_table_name character varying) RETURNS void
+    LANGUAGE plpgsql
+    AS $$
+begin
+  perform schema_evolution_manager.create_basic_created_audit_data(p_schema_name, p_table_name);
+  perform schema_evolution_manager.create_basic_updated_audit_data(p_schema_name, p_table_name);
+  perform schema_evolution_manager.create_basic_deleted_audit_data(p_schema_name, p_table_name);
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION create_basic_created_audit_data(p_schema_name character varying, p_table_name character varying) RETURNS void
+    LANGUAGE plpgsql
+    AS $$
+begin
+  execute 'alter table ' || p_schema_name || '.' || p_table_name || ' add created_by_guid uuid not null';
+  execute 'alter table ' || p_schema_name || '.' || p_table_name || ' add created_at timestamp with time zone default now() not null';
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION create_basic_deleted_audit_data(p_schema_name character varying, p_table_name character varying) RETURNS void
+    LANGUAGE plpgsql
+    AS $$
+begin
+  execute 'alter table ' || p_schema_name || '.' || p_table_name || ' add deleted_by_guid uuid';
+  execute 'alter table ' || p_schema_name || '.' || p_table_name || ' add deleted_at timestamp with time zone';
+  execute 'alter table ' || p_schema_name || '.' || p_table_name || ' add constraint ' || p_table_name || '_deleted_ck ' ||
+          'check ( (deleted_at is null and deleted_by_guid is null) OR (deleted_at is not null and deleted_by_guid is not null) )';
+  perform schema_evolution_manager.create_prevent_immediate_delete_trigger(p_schema_name, p_table_name);
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION create_basic_updated_audit_data(p_schema_name character varying, p_table_name character varying) RETURNS void
+    LANGUAGE plpgsql
+    AS $$
+begin
+  execute 'alter table ' || p_schema_name || '.' || p_table_name || ' add updated_by_guid uuid not null';
+  execute 'alter table ' || p_schema_name || '.' || p_table_name || ' add updated_at timestamp with time zone default now() not null';
+  perform schema_evolution_manager.create_updated_at_trigger(p_schema_name, p_table_name);
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION prevent_delete() RETURNS trigger
+    LANGUAGE plpgsql
+    AS $$
+begin
+  raise exception 'Physical deletes are not allowed on this table';
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION prevent_immediate_delete() RETURNS trigger
+    LANGUAGE plpgsql
+    AS $$
+begin
+  if old.deleted_at is null then
+    raise exception 'You must set the deleted_at column for this table';
+  end if;
+
+  if old.deleted_at > now() - interval '1 months' then
+    raise exception 'Physical deletes on this table can occur only after 1 month of deleting the records';
+  end if;
+
+  return old;
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION create_updated_at_trigger(p_schema_name character varying, p_table_name character varying) RETURNS character varying
+    LANGUAGE plpgsql
+    AS $$
+declare
+  v_name varchar;
+begin
+  v_name = p_table_name || '_updated_at_trigger';
+  execute 'drop trigger if exists ' || v_name || ' on ' || p_schema_name || '.' || p_table_name;
+  execute 'create trigger ' || v_name || ' before update on ' || p_schema_name || '.' || p_table_name || ' for each row execute procedure schema_evolution_manager.set_updated_at_trigger_function()';
+  return v_name;
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION set_updated_at_trigger_function() RETURNS trigger
+    LANGUAGE plpgsql
+    AS $$
+begin
+  if (new.updated_at = old.updated_at) then
+    new.updated_at = timezone('utc', now())::timestamptz;
+  end if;
+  return new;
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION create_prevent_immediate_delete_trigger(p_schema_name character varying, p_table_name character varying) RETURNS character varying
+    LANGUAGE plpgsql
+    AS $$
+declare
+  v_name varchar;
+begin
+  v_name = p_table_name || '_prevent_immediate_delete_trigger';
+  execute 'create trigger ' || v_name || ' before delete on ' || p_schema_name || '.' || p_table_name || ' for each row execute procedure schema_evolution_manager.prevent_immediate_delete()';
+  return v_name;
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION create_prevent_update_trigger(p_schema_name character varying, p_table_name character varying) RETURNS character varying
+    LANGUAGE plpgsql
+    AS $$
+declare
+  v_name varchar;
+begin
+  v_name = p_table_name || '_prevent_update_trigger';
+  execute 'create trigger ' || v_name || ' after update on ' || p_schema_name || '.' || p_table_name || ' for each row execute procedure schema_evolution_manager.prevent_update()';
+  return v_name;
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION create_prevent_delete_trigger(p_schema_name character varying, p_table_name character varying) RETURNS character varying
+    LANGUAGE plpgsql
+    AS $$
+declare
+  v_name varchar;
+begin
+  v_name = p_table_name || '_prevent_delete_trigger';
+  execute 'create trigger ' || v_name || ' after delete on ' || p_schema_name || '.' || p_table_name || ' for each row execute procedure schema_evolution_manager.prevent_delete()';
+  return v_name;
+end;
+$$;
+
+CREATE OR REPLACE FUNCTION prevent_update() RETURNS trigger
+    LANGUAGE plpgsql
+    AS $$
+begin
+  raise exception 'Physical updates are not allowed on this table';
+end;
+$$;

data/template/README.md

@@ -0,0 +1,28 @@
+To add a new database migration script:
+
+  1. Make sure you have head of master:
+     git checkout master
+     git fetch
+     git rebase origin/master
+
+  2. Create a local branch for your change
+     git checkout -b tmp
+
+  3. Create a file containing your upgrade script - e.g. new.sql
+
+  4. Add your upgrade script
+     %%add_script_path%% ./new.sql
+     git commit -m 'Add upgrade script to ...' scripts
+
+  5. Push change
+
+To upgrade your local postgresql database:
+
+  sem-apply --host localhost --name sample --user postgres
+
+or use the wrapper script:
+
+  ./dev.rb
+
+For more information on the schema evolution manager tools, look at
+schema-evolution-manager/README.md

data/template/dev.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+# == Wrapper script to update a local postgrseql database
+#
+# == Usage
+#  ./dev.rb
+#
+
+Dir.chdir(File.dirname($0)) {
+  command = "sem-apply --url %%url%%"
+  puts command
+  exec(command)
+}

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: schema-evolution-manager
+version: !ruby/object:Gem::Version
+  version: 0.9.24
+platform: ruby
+authors:
+- Michael Bryzek
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-02-28 00:00:00.000000000 Z
+dependencies: []
+description: '["Michael Bryzek"]'
+email: mbryzek@alum.mit.edu
+executables:
+- sem-add
+- sem-apply
+- sem-baseline
+- sem-config
+- sem-dist
+- sem-info
+- sem-init
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/sem-add
+- bin/sem-apply
+- bin/sem-baseline
+- bin/sem-config
+- bin/sem-dist
+- bin/sem-info
+- bin/sem-init
+- lib/schema-evolution-manager/apply_util.rb
+- lib/schema-evolution-manager/args.rb
+- lib/schema-evolution-manager/ask.rb
+- lib/schema-evolution-manager/baseline_util.rb
+- lib/schema-evolution-manager/db.rb
+- lib/schema-evolution-manager/install_template.rb
+- lib/schema-evolution-manager/library.rb
+- lib/schema-evolution-manager/migration_file.rb
+- lib/schema-evolution-manager/preconditions.rb
+- lib/schema-evolution-manager/rdoc_usage.rb
+- lib/schema-evolution-manager/script_error.rb
+- lib/schema-evolution-manager/scripts.rb
+- lib/schema-evolution-manager/sem_info.rb
+- lib/schema-evolution-manager/sem_version.rb
+- lib/schema-evolution-manager/template.rb
+- lib/schema-evolution-manager/version.rb
+- lib/schema-evolution-manager.rb
+- scripts/20130318-105434.sql
+- scripts/20130318-105456.sql
+- template/dev.rb
+- template/README.md
+homepage: https://github.com/gilt/schema-evolution-manager
+licenses:
+- Apache 2.0
+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.0.14
+signing_key: 
+specification_version: 4
+summary: Schema evolution manager is a simple schema migration tool for postgresql
+  databases.
+test_files: []