opdotenv 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 484498d0c2471d83e66fd42819feef80da6432e79c2166ceb15b1ece037b2046
-  data.tar.gz: fce7dbd63416abb37af84c4bdf78792d1172fa1bea972d467f7a871ca1d58e12
+  metadata.gz: 010e15bce13dd6d38d5c1d05871fe4a395cda0b9a68e0057045aec4f0bed6a15
+  data.tar.gz: 46bf2e43e4b2df72bf1fbb739751dc170e16262a306b6a2373f1098571e00457
 SHA512:
-  metadata.gz: 319700ee96600edbb66bc90db27dadb07cfe269cc0f10570b582ae349f8f6234ff29a5950590a57763450c48a95ab1fcd3925bf0d929a1604d2e15a5cc335b11
-  data.tar.gz: 351b895887435dabeb2dec23884d741f192a16aa3c26be083490ff9a7be8189b06d03d8c8f0e7e3373a875d3d8edda5aabc620e5b2a157f05390293fb5cfbaf9
+  metadata.gz: 9334e5fc25e01fee0fd7d9ffda74e8df98e598a6275a8ea740790e3dbabde7614eb17bc2f4afddeb37bb29ce10b65f94e63475e46e9f64552fc9699aa6309ffa
+  data.tar.gz: 57d4a520a562d583e8fff85e3d9bf3944429d3442339dbbf44e75731a5f5abad819029606179d8667627836aa730b8424eac3fe21f39ddf81060e0bf36f44e12

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG
 
+## 1.0.1 (2025-11-05)
+
+- Add configurable op CLI path support
+- Support for `OP_CLI_PATH` and `OPDOTENV_CLI_PATH` environment variables
+- Rails configuration option `config.opdotenv.cli_path`
+- Direct API support via `OpClient.new(cli_path: ...)` and `ClientFactory.create(cli_path: ...)`
+
 ## 1.0.0 (2025-11-04)
 
 - Initial stable release

data/README.md

@@ -1,11 +1,15 @@
 # opdotenv
 
-[![Gem Version](https://badge.fury.io/rb/opdotenv.svg)](https://badge.fury.io/rb/opdotenv) [![Test Status](https://github.com/amkisko/opdotenv/actions/workflows/ci.yml/badge.svg)](https://github.com/amkisko/opdotenv/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/amkisko/opdotenv/graph/badge.svg?token=YOUR_TOKEN)](https://codecov.io/gh/amkisko/opdotenv/graph/badge.svg?token=YOUR_TOKEN)
+[![Gem Version](https://badge.fury.io/rb/opdotenv.svg?v=1.0.0)](https://badge.fury.io/rb/opdotenv) [![Test Status](https://github.com/amkisko/opdotenv.rb/actions/workflows/ci.yml/badge.svg)](https://github.com/amkisko/opdotenv.rb/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/amkisko/opdotenv.rb/graph/badge.svg?token=U4FMVZGO8R)](https://codecov.io/gh/amkisko/opdotenv.rb)
 
 Load environment variables from 1Password using the `op` CLI or 1Password Connect Server API. Supports dotenv, JSON, and YAML formats.
 
 Sponsored by [Kisko Labs](https://www.kiskolabs.com).
 
+<a href="https://www.kiskolabs.com">
+  <img src="https://brand.kiskolabs.com/images/logos/Kisko_Logo_Black_Horizontal-7249a361.svg" width="200" style="display: block; background: white; border-radius: 10px;" />
+</a>
+
 ## Installation
 
 Add to your Gemfile:
@@ -18,6 +22,8 @@ gem "opdotenv"
 
 Choose one:
 - **1Password CLI** (`op`) - must be installed and authenticated (`op signin`)
+  - By default, `op` is expected to be in your `PATH`
+  - You can configure a custom path via `OP_CLI_PATH` or `OPDOTENV_CLI_PATH` environment variables, or via Rails config (see below)
 - **1Password Connect Server** - set `OP_CONNECT_URL` and `OP_CONNECT_TOKEN` environment variables
 
 Ruby 2.7+ supported.
@@ -56,6 +62,22 @@ Rails.application.configure do
 end
 ```
 
+### Configure op CLI path
+
+If your `op` CLI command is not in your `PATH` or you want to use a custom path:
+
+```ruby
+Rails.application.configure do
+  config.opdotenv.cli_path = "/usr/local/bin/op"
+end
+```
+
+Alternatively, you can set the `OP_CLI_PATH` or `OPDOTENV_CLI_PATH` environment variable:
+
+```bash
+export OP_CLI_PATH=/usr/local/bin/op
+```
+
 ### Disable automatic loading
 
 ```ruby

data/lib/opdotenv/client_factory.rb

@@ -2,7 +2,7 @@ module Opdotenv
   class ClientFactory
     # Creates appropriate client based on configuration or environment
     # Supports both op CLI and Connect API
-    def self.create(env: ENV)
+    def self.create(env: ENV, cli_path: nil)
       # Check for Connect API configuration
       connect_url = env["OP_CONNECT_URL"] || env["OPDOTENV_CONNECT_URL"]
       connect_token = env["OP_CONNECT_TOKEN"] || env["OPDOTENV_CONNECT_TOKEN"]
@@ -10,7 +10,7 @@ module Opdotenv
       if connect_url && connect_token
         ConnectApiClient.new(base_url: connect_url, access_token: connect_token, env: env)
       else
-        OpClient.new(env: env)
+        OpClient.new(env: env, cli_path: cli_path)
       end
     end
   end

data/lib/opdotenv/op_client.rb

@@ -8,18 +8,19 @@ module Opdotenv
     SECURE_NOTE_CATEGORY = "secure-note"
     LOGIN_CATEGORY = "LOGIN"
 
-    def initialize(env: ENV)
+    def initialize(env: ENV, cli_path: nil)
       @env = env
+      @cli_path = cli_path || env["OP_CLI_PATH"] || env["OPDOTENV_CLI_PATH"] || "op"
     end
 
     def read(path)
       validate_path(path)
-      out = capture(["op", "read", path])
+      out = capture([@cli_path, "read", path])
       out.strip
     end
 
     def item_get(item, vault: nil)
-      args = ["op", "item", "get", item, "--format", "json"]
+      args = [@cli_path, "item", "get", item, "--format", "json"]
       args += ["--vault", vault] if vault
       capture(args)
     end
@@ -28,7 +29,7 @@ module Opdotenv
       # Create a Secure Note with given title and notesPlain
       # Use shell escaping to prevent injection
       args = [
-        "op", "item", "create",
+        @cli_path, "item", "create",
         "--category", SECURE_NOTE_CATEGORY,
         "--title", title,
         "--vault", vault,
@@ -43,10 +44,10 @@ module Opdotenv
         fields.each do |k, v|
           # Use shell escaping to prevent injection
           field_arg = "#{k}=#{v}"
-          capture(["op", "item", "edit", item, "--vault", vault, "--set", field_arg])
+          capture([@cli_path, "item", "edit", item, "--vault", vault, "--set", field_arg])
         end
       else
-        args = ["op", "item", "create", "--title", item, "--vault", vault]
+        args = [@cli_path, "item", "create", "--title", item, "--vault", vault]
         fields.each do |k, v|
           args += ["--set", "#{k}=#{v}"]
         end
@@ -57,7 +58,7 @@ module Opdotenv
     private
 
     def item_exists?(item, vault: nil)
-      args = ["op", "item", "get", item]
+      args = [@cli_path, "item", "get", item]
       args += ["--vault", vault] if vault
       system(*args, out: File::NULL, err: File::NULL)
     end

data/lib/opdotenv/railtie.rb

@@ -10,6 +10,8 @@ module Opdotenv
     # Optional 1Password Connect settings (alternatively set via ENV)
     config.opdotenv.connect_url = nil
     config.opdotenv.connect_token = nil
+    # Optional op CLI path (defaults to "op", can also be set via OP_CLI_PATH or OPDOTENV_CLI_PATH env vars)
+    config.opdotenv.cli_path = nil
     config.opdotenv.overwrite = true
     config.opdotenv.auto_load = true
 
@@ -25,6 +27,11 @@ module Opdotenv
         ENV["OP_CONNECT_TOKEN"] = config.connect_token
       end
 
+      # Set op CLI path from Rails configuration if provided
+      if config.cli_path
+        ENV["OPDOTENV_CLI_PATH"] = config.cli_path
+      end
+
       # Load from configured sources
       # Sources can be strings (simplified format) or hashes (backward compatibility)
       (config.sources || []).each do |source|

data/lib/opdotenv/version.rb

@@ -1,3 +1,3 @@
 module Opdotenv
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opdotenv
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - amkisko
@@ -169,6 +169,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: anyway_config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: Read environment variables from 1Password fields (dotenv/json/yaml format)
   or all fields using the op CLI or 1Password Connect Server API. Export local .env
   files back to 1Password.