RubyGems - lex-tfe - Versions diffs - 0.1.0 → 0.1.1 - Mend

lex-tfe 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +6 -0
data/CLAUDE.md +102 -0
data/Gemfile.lock +171 -0
data/README.md +13 -8
data/lex-tfe.gemspec +8 -1
data/lib/legion/extensions/tfe/version.rb +1 -1
metadata +101 -1

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70b7f70e681039dbaccf9544ca6a99eba1506c8918fb3b01245e4d4c6e7e971e
-  data.tar.gz: 44fac6f7f48a727df2d5d416b62c7f2572216434817560d0db75d9d323ba4084
+  metadata.gz: 18086e141e73cf2b594633fe01dcb0090e46b6c7b4672d020c137b1e4ebcb962
+  data.tar.gz: 6ff86f6ea93d1100137e137d044810050c0a6559ae97bec15b6d3888beb62ebe
 SHA512:
-  metadata.gz: 618c76447a6b4091b56c77c85ee47c4c651239bdc242fef20d6d0eb01b60170e876ceb07c5d4d3149d5effdaebf72c9db140e883fc733936699322876dbac559
-  data.tar.gz: 8486d8c5fae9938417fbde075d0153fbb0633087f9cf1f45586039a8ed805e006de90167ba761958f78f75d31052899a63c9979efcfb9b91fbe9ada6b60eb07e
+  metadata.gz: ca61d93d4ce7875824d671986c8ad71697684ca7ce41c92065289cbc1dd6a3480b688af0bbda6c0b316268734c123635b5187f9dd45cbd9632249eeb585f0550
+  data.tar.gz: eb43b914c72ac808a4ead098e5cab34566f097ab7c59d5dd3633db13bce3c315a562c5607340d56209498ce8c4d488460baed96269aea2d6f14314937c2358f3

data/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,11 @@
 # Changelog
+## [0.1.1]
+### Changed
+- Add legion-cache, legion-crypt, legion-data, legion-json, legion-logging, legion-settings, legion-transport as runtime dependencies
+- Update spec_helper to require sub-gem helpers before loading extension
 ## [0.1.0]
 ### Added

data/CLAUDE.md ADDED Viewed

@@ -0,0 +1,102 @@
+# lex-tfe: Terraform Enterprise / HCP Terraform Integration for LegionIO
+**Repository Level 3 Documentation**
+- **Parent (Level 2)**: `/Users/miverso2/rubymine/legion/extensions/CLAUDE.md`
+- **Parent (Level 1)**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+## Purpose
+Legion Extension that connects LegionIO to Terraform Enterprise (TFE) and HCP Terraform. Provides runners for managing workspaces, runs, plans, applies, variables, variable sets, projects, organizations, state versions, and policy sets via the TFE REST API v2.
+**GitHub**: https://github.com/LegionIO/lex-tfe
+**License**: MIT
+**Version**: 0.1.0
+## Architecture
+```
+Legion::Extensions::Tfe
+├── Runners/
+│   ├── Workspaces      # list, get, create, update, delete, lock, unlock
+│   ├── Runs            # list_runs, get_run, create_run, apply_run, discard_run, cancel_run
+│   ├── Plans           # get_plan, get_plan_json_output, get_plan_log
+│   ├── Applies         # get_apply, get_apply_log
+│   ├── Variables       # list_variables, create_variable, update_variable, delete_variable
+│   ├── VariableSets    # list_variable_sets, get_variable_set, create_variable_set, update_variable_set,
+│   │                   #   delete_variable_set, list_varset_variables, add_varset_variable
+│   ├── Projects        # list_projects, get_project, create_project, update_project, delete_project
+│   ├── Organizations   # list_organizations, get_organization
+│   ├── StateVersions   # list_state_versions, get_state_version, get_current_state_version
+│   └── PolicySets      # list_policy_sets, get_policy_set, list_workspace_policy_sets
+├── Helpers/
+│   └── Client          # Faraday connection builder (Bearer token auth)
+├── Errors              # ReadOnlyError raised on write ops when read_only: true
+└── Client              # Standalone client class (includes all runners)
+```
+## Key Files
+| Path | Purpose |
+|------|---------|
+| `lib/legion/extensions/tfe.rb` | Entry point, extension registration |
+| `lib/legion/extensions/tfe/version.rb` | Version constant (0.1.0) |
+| `lib/legion/extensions/tfe/helpers/client.rb` | Faraday connection builder with Bearer token auth |
+| `lib/legion/extensions/tfe/errors.rb` | `ReadOnlyError` for read-only guard |
+| `lib/legion/extensions/tfe/client.rb` | Standalone `Client` class |
+| `lib/legion/extensions/tfe/runners/workspaces.rb` | Workspace CRUD + lock/unlock |
+| `lib/legion/extensions/tfe/runners/runs.rb` | Run lifecycle management |
+| `lib/legion/extensions/tfe/runners/plans.rb` | Plan retrieval and log streaming |
+| `lib/legion/extensions/tfe/runners/applies.rb` | Apply retrieval and log streaming |
+| `lib/legion/extensions/tfe/runners/variables.rb` | Workspace variable management |
+| `lib/legion/extensions/tfe/runners/variable_sets.rb` | Variable set management |
+| `lib/legion/extensions/tfe/runners/projects.rb` | Project CRUD |
+| `lib/legion/extensions/tfe/runners/organizations.rb` | Organization list/get |
+| `lib/legion/extensions/tfe/runners/state_versions.rb` | State version retrieval |
+| `lib/legion/extensions/tfe/runners/policy_sets.rb` | Policy set list/get |
+## Connection
+`Helpers::Client` builds a Faraday connection with `Authorization: Bearer <token>` header. The `url:` parameter accepts any TFE instance base URL (defaults to `https://app.terraform.io`). Supports both HCP Terraform SaaS and self-hosted TFE.
+Common target URLs:
+- `https://app.terraform.io` — HCP Terraform (SaaS)
+- `https://terraform.uhg.com` — UHG app team TFE cluster
+- `https://tfe-arc.uhg.com` — UHG Grid platform TFE cluster
+## Read-Only Guard
+Each runner method that performs a write operation (create, update, delete, lock, unlock, apply, discard, cancel) accepts a `read_only:` boolean kwarg and raises `Legion::Extensions::Tfe::ReadOnlyError` before making any API call when it is `true`. The standalone `Client` class stores `read_only:` in `@opts` and forwards it automatically to all runner methods via `connection(**override)`.
+## Settings Reference
+```json
+{
+  "extensions": {
+    "tfe": {
+      "url": "https://app.terraform.io",
+      "token": "vault://secret/tfe/api_token#value",
+      "read_only": false
+    }
+  }
+}
+```
+## Dependencies
+| Gem | Purpose |
+|-----|---------|
+| `faraday` (>= 2.0) | HTTP client for TFE REST API v2 |
+## Testing
+72 specs across 5 spec files.
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+---
+**Maintained By**: Matthew Iverson (@Esity)

data/Gemfile.lock ADDED Viewed

@@ -0,0 +1,171 @@
+PATH
+  remote: .
+  specs:
+    lex-tfe (0.1.1)
+      faraday (>= 2.0)
+      legion-cache (>= 1.3.11)
+      legion-crypt (>= 1.4.9)
+      legion-data (>= 1.4.17)
+      legion-json (>= 1.2.1)
+      legion-logging (>= 1.3.2)
+      legion-settings (>= 1.3.14)
+      legion-transport (>= 1.3.9)
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.9)
+      public_suffix (>= 2.0.2, < 8.0)
+    amq-protocol (2.5.1)
+    ast (2.4.3)
+    aws-eventstream (1.4.0)
+    aws-sigv4 (1.12.1)
+      aws-eventstream (~> 1, >= 1.0.2)
+    base64 (0.3.0)
+    bigdecimal (4.0.1)
+    bunny (2.24.0)
+      amq-protocol (~> 2.3)
+      sorted_set (~> 1, >= 1.0.2)
+    concurrent-ruby (1.3.6)
+    connection_pool (2.5.5)
+    dalli (5.0.2)
+      logger
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    ed25519 (1.4.0)
+    faraday (2.14.1)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    json (2.19.1)
+    json-schema (6.2.0)
+      addressable (~> 2.8)
+      bigdecimal (>= 3.1, < 5)
+    json_pure (2.8.1)
+    jwt (3.1.2)
+      base64
+    language_server-protocol (3.17.0.5)
+    legion-cache (1.3.11)
+      connection_pool (>= 2.4)
+      dalli (>= 3.0)
+      legion-logging (>= 1.2.8)
+      legion-settings (>= 1.3.12)
+      redis (>= 5.0)
+    legion-crypt (1.4.9)
+      ed25519 (~> 1.3)
+      jwt (>= 2.7)
+      vault (>= 0.17)
+    legion-data (1.4.17)
+      legion-logging (>= 1.2.8)
+      legion-settings (>= 1.3.12)
+      sequel (>= 5.70)
+      sqlite3 (>= 2.0)
+    legion-json (1.2.1)
+      json_pure
+      multi_json
+    legion-logging (1.3.2)
+      logger
+      rainbow (~> 3)
+    legion-settings (1.3.14)
+      legion-json (>= 1.2.0)
+    legion-transport (1.3.9)
+      bunny (>= 2.23)
+      concurrent-ruby (>= 1.2)
+      legion-json (>= 1.2.0)
+      legion-settings (>= 1.3.12)
+      logger
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    mcp (0.8.0)
+      json-schema (>= 4.1)
+    mini_portile2 (2.8.9)
+    multi_json (1.19.1)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    net-http-persistent (4.0.8)
+      connection_pool (>= 2.2.4, < 4)
+    parallel (1.27.0)
+    parser (3.3.10.2)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    public_suffix (7.0.5)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    rbtree (0.4.6)
+    redis (5.4.1)
+      redis-client (>= 0.22.0)
+    redis-client (0.28.0)
+      connection_pool
+    regexp_parser (2.11.3)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rspec_junit_formatter (0.6.0)
+      rspec-core (>= 2, < 4, != 2.12.0)
+    rubocop (1.85.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      mcp (~> 0.6)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    sequel (5.102.0)
+      bigdecimal
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    sorted_set (1.1.0)
+      rbtree
+    sqlite3 (2.9.2)
+      mini_portile2 (~> 2.8.0)
+    sqlite3 (2.9.2-arm64-darwin)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    vault (0.20.0)
+      aws-sigv4
+      base64
+      connection_pool (~> 2.4)
+      net-http-persistent (~> 4.0, >= 4.0.2)
+PLATFORMS
+  arm64-darwin-25
+  ruby
+DEPENDENCIES
+  lex-tfe!
+  rake
+  rspec
+  rspec_junit_formatter
+  rubocop
+  simplecov
+BUNDLED WITH
+   2.6.9

data/README.md CHANGED Viewed

@@ -35,7 +35,7 @@ Supported base URLs:
 ## Standalone Client Usage
 ```ruby
-require 'lex-tfe'
+require 'legion/extensions/tfe'
 client = Legion::Extensions::Tfe::Client.new(
   url:       'https://terraform.uhg.com',
@@ -69,6 +69,8 @@ client.create_variable(
 ### Read-only mode
+Pass `read_only: true` to `Client.new`. The flag is stored in `@opts` and forwarded automatically to every runner method — no need to pass it per call.
 ```ruby
 client = Legion::Extensions::Tfe::Client.new(
   url:       'https://terraform.uhg.com',
@@ -80,7 +82,7 @@ client = Legion::Extensions::Tfe::Client.new(
 client.list(organization: 'my-org')
 # Raises Legion::Extensions::Tfe::ReadOnlyError
-client.create(organization: 'my-org', name: 'ws', read_only: client.opts[:read_only])
+client.create(organization: 'my-org', name: 'ws')
 ```
 ## Runners
@@ -177,10 +179,13 @@ client.create(organization: 'my-org', name: 'ws', read_only: client.opts[:read_o
 | `get_policy_set`            | Get a policy set by ID                      |
 | `list_workspace_policy_sets`| List policy sets attached to a workspace    |
-## Development
+## Requirements
-```bash
-bundle install
-bundle exec rspec
-bundle exec rubocop
-```
+- Ruby >= 3.4
+- [LegionIO](https://github.com/LegionIO/LegionIO) framework (optional for standalone client usage)
+- Terraform Enterprise or HCP Terraform API token
+- `faraday` >= 2.0
+## License
+MIT

data/lex-tfe.gemspec CHANGED Viewed

@@ -26,5 +26,12 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ['lib']
-  spec.add_dependency 'faraday', '>= 2.0'
+  spec.add_dependency 'faraday',            '>= 2.0'
+  spec.add_dependency 'legion-cache',       '>= 1.3.11'
+  spec.add_dependency 'legion-crypt',       '>= 1.4.9'
+  spec.add_dependency 'legion-data',        '>= 1.4.17'
+  spec.add_dependency 'legion-json',        '>= 1.2.1'
+  spec.add_dependency 'legion-logging',     '>= 1.3.2'
+  spec.add_dependency 'legion-settings',    '>= 1.3.14'
+  spec.add_dependency 'legion-transport',   '>= 1.3.9'
 end

data/lib/legion/extensions/tfe/version.rb CHANGED Viewed

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Tfe
-      VERSION = '0.1.0'
+      VERSION = '0.1.1'
     end
   end
 end

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-tfe
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Matthew Iverson
@@ -23,6 +23,104 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: legion-cache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+- !ruby/object:Gem::Dependency
+  name: legion-crypt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+- !ruby/object:Gem::Dependency
+  name: legion-data
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+- !ruby/object:Gem::Dependency
+  name: legion-json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: legion-logging
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+- !ruby/object:Gem::Dependency
+  name: legion-settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+- !ruby/object:Gem::Dependency
+  name: legion-transport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
 description: Connects LegionIO to Terraform Enterprise / HCP Terraform
 email:
 - matthewdiverson@gmail.com
@@ -34,7 +132,9 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
+- CLAUDE.md
 - Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
 - lex-tfe.gemspec