pgslice 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f56f37e43ecc30fd145316bde2bd20478b360c077f928323fdee982379433b8
-  data.tar.gz: 594dc56e38e2d5902df435ddc514cdbb15004432f4b2b0d5d95ae37c7f8b00a5
+  metadata.gz: 325b5cd0c6ec6dfa7a98db88a06bb47ed4f8ee327c6c21dddfd897ec13f54533
+  data.tar.gz: aabbfee0e2bced3b7e93f4d9f0db218db060779a3b75b14ac7056867901bae26
 SHA512:
-  metadata.gz: 4cda3774db98a20ba3d13e1655baa7bcd3f294f810457d1c1a2a6ff7b3da1e861814d26638a95fcfa8f9fcad3280b0a6e419fead798cf83fb76e30108bd8b567
-  data.tar.gz: 62b2bc217e0fc0e822e4852159790b5d0e7d5e20a8d27216890362975de7100253183834c383b618c2d7ed1623891fbd41f76d44145e3274d6f7b0e1a1a7a225
+  metadata.gz: ba7310102950041d8247779282b6b252d40d7c824bd03b07d08ed7e400534cbf44eb31161595004ff782ccdaa9eacd0d6698797068ea06109ef974eebab8439b
+  data.tar.gz: 50faa245fb1ac68b6b685af8529277f23a46146477fd37e9ec52a6984222daa3392ca49e9d5276f03177f755ccec5c94989d4f6f25e182f3013ed9b24a8a7250

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 0.7.0 (2025-05-26)
+
+- Dropped support for Ruby < 3
+- Dropped support for Postgres < 13
+
+## 0.6.1 (2023-04-26)
+
+- Fixed `uninitialized constant` error
+
 ## 0.6.0 (2023-04-22)
 
 - Added support for generated columns

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016-2023 Andrew Kane
+Copyright (c) 2016-2025 Andrew Kane
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -4,7 +4,7 @@ Postgres partitioning as easy as pie. Works great for both new and existing tabl
 
 :tangerine: Battle-tested at [Instacart](https://www.instacart.com/opensource)
 
-[![Build Status](https://github.com/ankane/pgslice/workflows/build/badge.svg?branch=master)](https://github.com/ankane/pgslice/actions)
+[![Build Status](https://github.com/ankane/pgslice/actions/workflows/build.yml/badge.svg)](https://github.com/ankane/pgslice/actions)
 
 ## Install
 
@@ -92,11 +92,11 @@ pgslice prep visits created_at month
 ```sql
 BEGIN;
 
-CREATE TABLE "public"."visits_intermediate" (LIKE "public"."visits" INCLUDING DEFAULTS INCLUDING CONSTRAINTS INCLUDING STORAGE INCLUDING COMMENTS) PARTITION BY RANGE ("created_at");
+CREATE TABLE "public"."visits_intermediate" (LIKE "public"."visits" INCLUDING DEFAULTS INCLUDING CONSTRAINTS INCLUDING STORAGE INCLUDING COMMENTS INCLUDING STATISTICS INCLUDING GENERATED INCLUDING COMPRESSION) PARTITION BY RANGE ("created_at");
 
 CREATE INDEX ON "public"."visits_intermediate" USING btree ("created_at");
 
-COMMENT ON TABLE "public"."visits_intermediate" is 'column:createdAt,period:day,cast:date,version:3';
+COMMENT ON TABLE "public"."visits_intermediate" is 'column:created_at,period:month,cast:date,version:3';
 
 COMMIT;
 ```
@@ -108,17 +108,17 @@ pgslice add_partitions visits --intermediate --past 1 --future 1
 ```sql
 BEGIN;
 
-CREATE TABLE "public"."visits_202208" PARTITION OF "public"."visits_intermediate" FOR VALUES FROM ('2022-08-01') TO ('2022-09-01');
+CREATE TABLE "public"."visits_202408" PARTITION OF "public"."visits_intermediate" FOR VALUES FROM ('2024-08-01') TO ('2024-09-01');
 
-ALTER TABLE "public"."visits_202208" ADD PRIMARY KEY ("id");
+ALTER TABLE "public"."visits_202408" ADD PRIMARY KEY ("id");
 
-CREATE TABLE "public"."visits_202209" PARTITION OF "public"."visits_intermediate" FOR VALUES FROM ('2022-09-01') TO ('2022-10-01');
+CREATE TABLE "public"."visits_202409" PARTITION OF "public"."visits_intermediate" FOR VALUES FROM ('2024-09-01') TO ('2024-10-01');
 
-ALTER TABLE "public"."visits_202209" ADD PRIMARY KEY ("id");
+ALTER TABLE "public"."visits_202409" ADD PRIMARY KEY ("id");
 
-CREATE TABLE "public"."visits_202210" PARTITION OF "public"."visits_intermediate" FOR VALUES FROM ('2022-10-01') TO ('2022-11-01');
+CREATE TABLE "public"."visits_202410" PARTITION OF "public"."visits_intermediate" FOR VALUES FROM ('2024-10-01') TO ('2024-11-01');
 
-ALTER TABLE "public"."visits_202210" ADD PRIMARY KEY ("id");
+ALTER TABLE "public"."visits_202410" ADD PRIMARY KEY ("id");
 
 COMMIT;
 ```
@@ -131,17 +131,17 @@ pgslice fill visits
 /* 1 of 3 */
 INSERT INTO "public"."visits_intermediate" ("id", "user_id", "ip", "created_at")
     SELECT "id", "user_id", "ip", "created_at" FROM "public"."visits"
-    WHERE "id" > 0 AND "id" <= 10000 AND "created_at" >= '2022-08-01'::date AND "created_at" < '2022-11-01'::date
+    WHERE "id" > 0 AND "id" <= 10000 AND "created_at" >= '2024-08-01'::date AND "created_at" < '2024-11-01'::date
 
 /* 2 of 3 */
 INSERT INTO "public"."visits_intermediate" ("id", "user_id", "ip", "created_at")
     SELECT "id", "user_id", "ip", "created_at" FROM "public"."visits"
-    WHERE "id" > 10000 AND "id" <= 20000 AND "created_at" >= '2022-08-01'::date AND "created_at" < '2022-11-01'::date
+    WHERE "id" > 10000 AND "id" <= 20000 AND "created_at" >= '2024-08-01'::date AND "created_at" < '2024-11-01'::date
 
 /* 3 of 3 */
 INSERT INTO "public"."visits_intermediate" ("id", "user_id", "ip", "created_at")
     SELECT "id", "user_id", "ip", "created_at" FROM "public"."visits"
-    WHERE "id" > 20000 AND "id" <= 30000 AND "created_at" >= '2022-08-01'::date AND "created_at" < '2022-11-01'::date
+    WHERE "id" > 20000 AND "id" <= 30000 AND "created_at" >= '2024-08-01'::date AND "created_at" < '2024-11-01'::date
 ```
 
 ```sh
@@ -149,11 +149,11 @@ pgslice analyze visits
 ```
 
 ```sql
-ANALYZE VERBOSE "public"."visits_202208";
+ANALYZE VERBOSE "public"."visits_202408";
 
-ANALYZE VERBOSE "public"."visits_202209";
+ANALYZE VERBOSE "public"."visits_202409";
 
-ANALYZE VERBOSE "public"."visits_202210";
+ANALYZE VERBOSE "public"."visits_202410";
 
 ANALYZE VERBOSE "public"."visits_intermediate";
 ```
@@ -217,14 +217,14 @@ WHERE
 Back up and drop older partitions each day, month, or year.
 
 ```sh
-pg_dump -c -Fc -t <table>_202209 $PGSLICE_URL > <table>_202209.dump
-psql -c "DROP TABLE <table>_202209" $PGSLICE_URL
+pg_dump -c -Fc -t <table>_202409 $PGSLICE_URL > <table>_202409.dump
+psql -c "DROP TABLE <table>_202409" $PGSLICE_URL
 ```
 
 If you use [Amazon S3](https://aws.amazon.com/s3/) for backups, [s3cmd](https://github.com/s3tools/s3cmd) is a nice tool.
 
 ```sh
-s3cmd put <table>_202209.dump s3://<s3-bucket>/<table>_202209.dump
+s3cmd put <table>_202409.dump s3://<s3-bucket>/<table>_202409.dump
 ```
 
 ## Schema Updates
@@ -267,7 +267,7 @@ SELECT * FROM
 WHERE
     user_id = 123 AND
     -- for performance
-    created_at >= '2022-09-01' AND created_at < '2022-09-02'
+    created_at >= '2024-09-01' AND created_at < '2024-09-02'
 ```
 
 For this to be effective, ensure `constraint_exclusion` is set to `partition` (the default value) or `on`.
@@ -365,7 +365,6 @@ gem specific_install https://github.com/ankane/pgslice.git
 ## Reference
 
 - [PostgreSQL Manual](https://www.postgresql.org/docs/current/static/ddl-partitioning.html)
-- [PostgreSQL Wiki](https://wiki.postgresql.org/wiki/Table_partitioning)
 
 ## Related Projects
 
@@ -375,6 +374,10 @@ Also check out:
 - [PgHero](https://github.com/ankane/pghero) - A performance dashboard for Postgres
 - [pgsync](https://github.com/ankane/pgsync) - Sync Postgres data to your local machine
 
+## History
+
+View the [changelog](https://github.com/ankane/pgslice/blob/master/CHANGELOG.md)
+
 ## Contributing
 
 Everyone is encouraged to help improve this project. Here are a few ways you can help:
@@ -397,8 +400,8 @@ bundle exec rake test
 To test against different versions of Postgres with Docker, use:
 
 ```sh
-docker run -p=8000:5432 postgres:10
+docker run -p=8000:5432 postgres:16
 TZ=Etc/UTC PGSLICE_URL=postgres://postgres@localhost:8000/postgres bundle exec rake
 ```
 
-On Mac, you must use [Docker for Mac](https://www.docker.com/docker-mac) for the port mapping to localhost to work.
+On Mac, you must use [Docker Desktop](https://www.docker.com/products/docker-desktop/) for the port mapping to localhost to work.

data/lib/pgslice/cli/prep.rb

@@ -4,7 +4,7 @@ module PgSlice
     option :partition, type: :boolean, default: true, desc: "Partition the table"
     option :trigger_based, type: :boolean, default: false, desc: "Use trigger-based partitioning"
     option :test_version, type: :numeric, hide: true
-    def prep(table, column=nil, period=nil)
+    def prep(table, column = nil, period = nil)
       table = create_table(table)
       intermediate_table = table.intermediate_table
       trigger_name = table.trigger_name

data/lib/pgslice/helpers.rb

@@ -41,8 +41,8 @@ module PgSlice
           say message
         end
         @server_version_num = conn.exec("SHOW server_version_num")[0]["server_version_num"].to_i
-        if @server_version_num < 110000
-          abort "This version of pgslice requires Postgres 11+"
+        if @server_version_num < 130000
+          abort "This version of pgslice requires Postgres 13+"
         end
         conn
       end

data/lib/pgslice/table.rb

@@ -16,7 +16,7 @@ module PgSlice
     end
 
     def columns
-      execute("SELECT column_name FROM information_schema.columns WHERE table_schema = $1 AND table_name = $2 AND is_generated = 'NEVER'", [schema, name]).map{ |r| r["column_name"] }
+      execute("SELECT column_name FROM information_schema.columns WHERE table_schema = $1 AND table_name = $2 AND is_generated = 'NEVER'", [schema, name]).map { |r| r["column_name"] }
     end
 
     # http://www.dbforums.com/showthread.php?1667561-How-to-list-sequences-and-the-columns-by-SQL

data/lib/pgslice/version.rb

@@ -1,3 +1,3 @@
 module PgSlice
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

data/lib/pgslice.rb

@@ -5,6 +5,7 @@ require "thor"
 # stdlib
 require "cgi"
 require "time"
+require "uri"
 
 # modules
 require_relative "pgslice/helpers"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pgslice
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Andrew Kane
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-04-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg
@@ -38,7 +37,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
 email: andrew@ankane.org
 executables:
 - pgslice
@@ -65,7 +63,6 @@ homepage: https://github.com/ankane/pgslice
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -73,15 +70,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Postgres partitioning as easy as pie
 test_files: []