archivault 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18e7063c221d22627d0355b857c7bd767d14cd2312f2c04391c506cba4ba1689
-  data.tar.gz: 2b5649d48fc0eb996bc8377f7670ad1d576cfe18609363079653472f92bea66c
+  metadata.gz: eaf47c3cfc367a25c1ea685a22229738230844f458187e7094bbb1892a80c67d
+  data.tar.gz: ce10a4fa42f6c2e9b2a52938f11884e82828351ccfedb540bce4402b747334a3
 SHA512:
-  metadata.gz: 2de400dc93463d3dd8247eaecdb9a323c59001106e1ad41d145dba5b68d50f03ec8ab2bde6fb7b98b128280a2dee21439bb4340d5a068810f654b91f586b488a
-  data.tar.gz: 9a41e8bec7f152ba8ee845e5387dfabcda6f7055ba770c012d1143da1ac81454039d20448b5b74e77527859100f51a21d0582f3af685bbe6187fcd193789fac2
+  metadata.gz: ca08c17fb2a4f21a0bc2e200fe9ea931b60b5057856b38e2725fe57b2de37f424a35f2cb181052f4dda613a1f45547fd10fc08ba04ce27d3135a02c5dd404109
+  data.tar.gz: c1ab9e98d5b9ca7072d18cfe352f32d2074f6401c28b5c199cab83a9d9f076a8e186878ce63466ae823aaa87cd79142a75fcb464f358054349978403e1227e3e

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-04-10
+
+- Add PostgresqlBackup
+
 ## [0.1.0] - 2026-04-08
 
 - Initial release

data/README.md

@@ -36,6 +36,22 @@ ping_url = "https://example.com/ping" # optional parameter
 Archivault::SqliteBackup.new(database_path:, gpg_passphrase:, s3_setup:, ping_url:).call
 ```
 
+### PostgreSQL database backup
+
+```ruby
+database_url = "postgres://user:password@localhost:5432/mydb"
+gpg_passphrase = "password"
+s3_setup = { 
+  region: "region", 
+  access_key_id: "access_key_id",  
+  secret_access_key: "secret_access_key", 
+  bucket: "bucket"
+}
+ping_url = "https://example.com/ping" # optional parameter
+
+Archivault::PostgresqlBackup.new(database_url:, gpg_passphrase:, s3_setup:, ping_url:).call
+```
+
 ### Logs backup
 
 ```ruby
@@ -55,7 +71,7 @@ ping_url = "https://example.com/ping" # optional parameter
 Archivault::LogsBackup.new(log_path_or_paths:, gpg_passphrase:, s3_setup:, ping_url:).call
 ```
 
-## Rais usage
+## Rails usage
 
 ### SQLite database backup
 
@@ -75,6 +91,24 @@ params = {
 Archivault::SqliteBackup.new(**params).call
 ```
 
+### PostgreSQL database backup
+
+```ruby
+# in config/credentials.yml.enc 
+# archivault:
+#   gpg_passphrase: password
+#   s3_setup:
+#     region: region
+#     access_key_id: access_key_id
+#     secret_access_key: secret_access_key
+#     bucket: bucket
+params = {
+  database_url: ENV["DATABASE_URL"],
+  ping_url: "https://example.com/ping" # optional parameter
+}.merge(Rails.application.credentials.archivault)
+Archivault::PostgresqlBackup.new(**params).call
+```
+
 ### Logs backup
 
 ```ruby

data/lib/archivault/gpg.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# To decrypt encrypted file, use:
+# gpg --output output.txt --decrypt output.txt.gpg
 module Archivault
   class Gpg
     def initialize(file_path)

data/lib/archivault/pg_dump.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# To restore a database from a dump file, use:
+# pg_restore --no-owner -d DATABASE_URL database.dump
+module Archivault
+  class PgDump
+    def initialize(database_url:, backup_path:)
+      raise ArgumentError, "database_path is required" if database_url.nil? || database_url.to_s.empty?
+      raise ArgumentError, "backup_path is required" if backup_path.nil? || backup_path.to_s.empty?
+
+      @database_url = database_url.to_s
+      @backup_path = backup_path.to_s
+    end
+
+    def call
+      Execute.new.call("pg_dump", "-Fc", "-f", @backup_path, @database_url)
+    end
+  end
+end

data/lib/archivault/postgresql_backup.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Archivault
+  class PostgresqlBackup
+    # Parameters
+    #   - database_url: Database URL
+    #   - gpg_passphrase: GPG passphrase to encrypt the backup file
+    #   - s3_setup: Hash of S3 setup options:
+    #     - region: AWS region
+    #     - access_key_id: AWS access key ID
+    #     - secret_access_key: AWS secret access key
+    #     - bucket: S3 bucket name
+    def initialize(database_url:, gpg_passphrase:, s3_setup:, ping_url: nil)
+      @database_url = database_url.to_s
+      @gpg_passphrase = gpg_passphrase.to_s
+      @s3_setup = s3_setup
+      @ping_url = ping_url
+
+      @timestamp = Timestamp.new.timestamp
+      @tmp_path = Tmp.new.path
+      @backup_path = "#{@tmp_path}/database-#{@timestamp}.dump"
+      @tar_path = "#{@tmp_path}/database-#{@timestamp}.tgz"
+      @gpg_path = "#{@tar_path}.gpg"
+    end
+
+    def call
+      PgDump.new(database_url: @database_url, backup_path: @backup_path).call
+      Tar.new(tar_path: @tar_path, path_or_paths: @backup_path).call
+      Gpg.new(@tar_path).call(@gpg_passphrase)
+      S3.new(@gpg_path).call(**@s3_setup)
+      Ping.new(@ping_url).call if @ping_url
+    ensure
+      Clean.new([@backup_path, @tar_path, @gpg_path]).call
+    end
+  end
+end

data/lib/archivault/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Archivault
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/archivault.rb

@@ -10,8 +10,10 @@ require_relative "archivault/tmp"
 require_relative "archivault/gpg"
 require_relative "archivault/s3"
 require_relative "archivault/ping"
+require_relative "archivault/pg_dump"
 require_relative "archivault/sqlite_backup"
 require_relative "archivault/logs_backup"
+require_relative "archivault/postgresql_backup"
 
 module Archivault
   class Error < StandardError; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: archivault
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Piotr Macuk
@@ -56,7 +56,9 @@ files:
 - lib/archivault/execute.rb
 - lib/archivault/gpg.rb
 - lib/archivault/logs_backup.rb
+- lib/archivault/pg_dump.rb
 - lib/archivault/ping.rb
+- lib/archivault/postgresql_backup.rb
 - lib/archivault/s3.rb
 - lib/archivault/sqlite.rb
 - lib/archivault/sqlite_backup.rb