sqlpkg 0.1.0-arm64-darwin → 0.1.1-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71c34670ae2f95a4e086684b141916e6fd6c454448cb05a7428d9e497a5d8e17
-  data.tar.gz: 90f8e64d5a2f15aebc350e7766048736675221d267c03063b72acbb9148bb90e
+  metadata.gz: 73667f21ad1cb0d3eda1089fd9c690cee13013d5c3477018fbf377c15597b129
+  data.tar.gz: 9cf3b36a153fc2b9ac2efd038f0fdfa4618a1a7c807add60a79f13deb4cbce73
 SHA512:
-  metadata.gz: e0623af2192f7d6362e2d18eb78f7decd64ab9a81a59da616e0a4631a5f9aa492c3f51709024e8a083935a9fbca68655fb79f8a67ff27e231a0b7e55a2c008db
-  data.tar.gz: aed5bc4743d91467d9bf80aa39607cfc0faa4b2172218f10b1544e640eecdbb8274a10ca0d9a8ab3cccdfabe749c009c0eda4dfe0b22756943f44387b91912dc
+  metadata.gz: 842b1b4d97e02d773386a2f770c5f1d11a350720f33763f7581f9b997f2af42ed586d2ea363e906a84361b80bfd95818a734c53aaa0e8441f0c75726a46f6491
+  data.tar.gz: 55230daa05e08a82090384d643064a19005d17db9ecca483a83be3ed9e941ac3e5d84d79c1ae8e5591e8398448b6440dacb6913dc9a992d585bde7ffc9969f4a

data/README.md

@@ -1,24 +1,62 @@
 # sqlpkg-ruby
 
-TODO: Delete this and the text below, and describe your gem
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/sqlpkg`. To experiment with that code, run `bin/console` for an interactive prompt.
+[sqlpkg](https://sqlpkg.org/) is the (unofficial) SQLite package registry. This gem provides a Ruby interface to [its CLI](https://github.com/nalgeon/sqlpkg-cli).
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
-
 Install the gem and add to the application's Gemfile by executing:
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+    $ bundle add sqlpkg
 
 If bundler is not being used to manage dependencies, install the gem by executing:
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+    $ gem install sqlpkg
+
+This gem wraps the standalone executable version of the [sqlpkg-cli](https://github.com/nalgeon/sqlpkg-cli#download-and-install-preferred-method). These executables are platform specific, so there are actually separate underlying gems per platform, but the correct gem will automatically be picked for your platform.
+
+Supported platforms are:
+
+* arm64-darwin (macos-arm64)
+* x86_64-darwin (macos-x64)
+* arm64-linux (linux-arm64)
+* x86_64-linux (linux-x64)
+
+### Using a local installation of `sqlpkg`
+
+If you are not able to use the vendored standalone executables (for example, if you're on an unsupported platform), you can use a local installation of the `sqlpkg` executable by setting an environment variable named `SQLPKG_INSTALL_DIR` to the directory containing the executable.
+
+For example, if you've installed `sqlpkg` so that the executable is found at `/usr/local/bin/sqlpkg`, then you should set your environment variable like so:
+
+``` sh
+SQLPKG_INSTALL_DIR=/usr/local/bin
+```
+
+This also works with relative paths. If you've installed into your app's directory at `./.bin/sqlpkg`:
+
+``` sh
+SQLPKG_INSTALL_DIR=.bin
+```
 
 ## Usage
 
-TODO: Write usage instructions here
+```shell
+$ bundle exec sqlpkg help
+┌────────────────────────────────────────────────┐
+│ sqlpkg is an SQLite package manager.           │
+│ Use it to install or update SQLite extensions. │
+│                                                │
+│ Commands:                                      │
+│ help       Display help                        │
+│ info       Display package information         │
+│ init       Init project scope                  │
+│ install    Install packages                    │
+│ list       List installed packages             │
+│ uninstall  Uninstall package                   │
+│ update     Update installed packages           │
+│ version    Display version                     │
+│ which      Display path to extension file      │
+└────────────────────────────────────────────────┘
+```
 
 ## Development
 

data/exe/sqlpkg

@@ -1,13 +1,13 @@
 #! /usr/bin/env ruby
 # because rubygems shims assume a gem's executables are Ruby
 
-require "litestream/commands"
+require "sqlpkg/commands"
 
 begin
-  command = [Litestream::Commands.executable, *ARGV]
+  command = [Sqlpkg::Commands.executable, *ARGV]
   puts command.inspect
   exec(*command)
-rescue Litestream::Commands::UnsupportedPlatformException, Litestream::Commands::ExecutableNotFoundException => e
+rescue Sqlpkg::Commands::UnsupportedPlatformException, Sqlpkg::Commands::ExecutableNotFoundException => e
   warn("ERROR: " + e.message)
   exit 1
 end

data/lib/sqlpkg/version.rb

@@ -1,3 +1,3 @@
 module Sqlpkg
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sqlpkg
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: arm64-darwin
 authors:
 - Stephen Margheim
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-12-20 00:00:00.000000000 Z
+date: 2023-12-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubyzip