train-juniper 0.6.0 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 691c9e5fe38bb5e1b021f1a79a933ffdf4c53e4a451e5524060761d009f16c20
-  data.tar.gz: 7147093352b9ef32703242f7c8f2bad3eb25db4e91dabd843bb10dbecae904ee
+  metadata.gz: 4428bf34013845866814e344ce4f67460a6af1a70fc33f33641a9412fee9dccb
+  data.tar.gz: 40f7a51485657e5616c744fa379283c8c0dfc1dbaa6d3a307ac4e9c909884d0d
 SHA512:
-  metadata.gz: 5253fca20205c39cdcca5defb6424f03e68178f902bfe3b8d223327f5ca1534b168f9bedbb5d9b26d9a4f48bc7727da9a725121e41ed49a99a0568f74b75dfb9
-  data.tar.gz: dc11e4ca30b48cba807051426c12ac1120d8c9297bca9af0bcce22bb129badb4ad1f009550502d57b141255ae723ec47633c278661caf3630d8db6e500e15fd8
+  metadata.gz: 31d2993f5e85a04ff1c1940644242df90e1c19066339eb8be395ec1378767fce53958278318f58e1fea7a51c0ea5f0923f5447f8f204f5b374e4e8ca6e4d91bd
+  data.tar.gz: f0da0acd3ea9398723a62cbb5a5f73a9af010c440218a7a01f62ba2f4071eb33833d7d284b5e4b55d166f0e61c3b47988bd85cd3854dad6eb00f2155551b1dd0

data/CHANGELOG.md

@@ -5,6 +5,32 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.2] - 2025-06-18
+
+### Fixed
+
+- Fix Windows installation issue by relaxing FFI dependency to match InSpec 7 (>= 1.15.5, < 1.17.0) (#2)
+- Fix mock mode platform detection to correctly show JunOS version instead of gem version
+- Update release workflow to use trusted publishing with OIDC authentication
+- Update workflows to use Ruby 3.3 for improved trusted publishing support
+
+### Added
+
+- Add `mock?` method to properly support mock mode in platform detection
+- Add comprehensive mock mode documentation to README
+
+### Changed
+
+- Update release process documentation to reflect trusted publishing setup
+
+## [0.6.1] - 2025-06-18
+
+### Fixed
+
+- Simplify release workflow to use API key directly
+
+## [0.6.0] - 2025-06-18
+
 ## [0.5.8] - 2025-06-18
 
 ### Fixed

data/README.md

@@ -303,6 +303,40 @@ ping device.internal  # From bastion host
 telnet device.internal 22  # Test SSH port
 ```
 
+## Mock Mode (Testing Without Hardware)
+
+The train-juniper plugin includes a comprehensive mock mode for testing profiles without requiring physical Juniper hardware:
+
+```bash
+# Use mock mode with InSpec detect
+inspec detect -t "juniper://admin@mock-device?mock=true"
+
+# Output shows mocked JunOS platform:
+# Name:      juniper
+# Families:  bsd
+# Release:   12.1X47-D15.4
+```
+
+For programmatic usage in tests:
+```ruby
+require 'train'
+connection = Train.create('juniper', 
+  host: 'test-device',
+  user: 'admin',
+  mock: true
+)
+
+# Mock mode returns predefined responses
+result = connection.run_command('show version')
+# => Returns mock JunOS version output
+```
+
+Mock mode provides:
+- ✅ Realistic JunOS command outputs
+- ✅ Platform detection (JunOS 12.1X47-D15.4)
+- ✅ Error simulation for negative testing
+- ✅ Fast execution for CI/CD pipelines
+
 ## Development
 
 ### Requirements

data/lib/train-juniper/connection.rb

@@ -66,9 +66,9 @@ module TrainPlugins
 
         super(@options)
 
-        # Establish SSH connection to Juniper device (unless in mock mode)
+        # Establish SSH connection to Juniper device (unless in mock mode or skip_connect)
         @logger.debug('Attempting to connect to Juniper device...')
-        connect unless @options[:mock]
+        connect unless @options[:mock] || @options[:skip_connect]
       end
 
       # Secure string representation (never expose credentials)
@@ -226,11 +226,18 @@ module TrainPlugins
 
       # Check if SSH connection is active
       def connected?
+        return true if @options[:mock]
+
         !@ssh_session.nil?
       rescue StandardError
         false
       end
 
+      # Check if running in mock mode
+      def mock?
+        @options[:mock] == true
+      end
+
       # Test connection and configure JunOS session
       def test_and_configure_session
         @logger.debug('Testing SSH connection and configuring JunOS session')

data/lib/train-juniper/platform.rb

@@ -52,16 +52,28 @@ module TrainPlugins::Juniper
       return @detected_junos_version if defined?(@detected_junos_version)
 
       # Only try version detection if we have an active connection
-      return @detected_junos_version = nil unless respond_to?(:run_command_via_connection)
-      return @detected_junos_version = nil if @options&.dig(:mock) # Skip in mock mode
+      unless respond_to?(:run_command_via_connection)
+        logger&.debug('run_command_via_connection not available yet')
+        return @detected_junos_version = nil
+      end
+
+      logger&.debug("Mock mode: #{@options&.dig(:mock)}, Connected: #{connected?}")
 
       begin
         # Check if connection is ready before running commands
-        return @detected_junos_version = nil unless connected?
+        unless connected?
+          logger&.debug('Not connected, skipping version detection')
+          return @detected_junos_version = nil
+        end
 
         # Execute 'show version' command to get JunOS information
+        logger&.debug("Running 'show version' command")
         result = run_command_via_connection('show version')
-        return @detected_junos_version = nil unless result&.exit_status&.zero?
+
+        unless result&.exit_status&.zero?
+          logger&.debug("Command failed with exit status: #{result&.exit_status}")
+          return @detected_junos_version = nil
+        end
 
         # Cache the result for architecture detection to avoid duplicate calls
         @cached_show_version_result = result
@@ -112,7 +124,6 @@ module TrainPlugins::Juniper
 
       # Only try architecture detection if we have an active connection
       return @detected_junos_architecture = nil unless respond_to?(:run_command_via_connection)
-      return @detected_junos_architecture = nil if @options&.dig(:mock) # Skip in mock mode
 
       begin
         # Check if connection is ready before running commands

data/lib/train-juniper/version.rb

@@ -7,6 +7,6 @@
 
 module TrainPlugins
   module Juniper
-    VERSION = '0.6.0'
+    VERSION = '0.6.2'
   end
 end

data/train-juniper.gemspec

@@ -67,6 +67,7 @@ Gem::Specification.new do |spec|
   # SSH connectivity dependencies - match train-core's exact version range
   spec.add_dependency 'net-ssh', '>= 2.9', '< 8.0'
 
-  # Force compatible FFI version to avoid conflicts with InSpec
-  spec.add_dependency 'ffi', '~> 1.16.0'
+  # FFI dependency - required by train-core
+  # Match InSpec 7's FFI version range for compatibility
+  spec.add_dependency 'ffi', '>= 1.15.5', '< 1.17.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: train-juniper
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.2
 platform: ruby
 authors:
 - MITRE Corporation
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-18 00:00:00.000000000 Z
+date: 2025-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: train-core
@@ -48,16 +48,22 @@ dependencies:
   name: ffi
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.15.5
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 1.16.0
+        version: 1.17.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.15.5
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 1.16.0
+        version: 1.17.0
 description: Provides SSH connectivity to Juniper Networks devices running JunOS for
   InSpec compliance testing and infrastructure inspection. Supports platform detection,
   command execution, and configuration file access.
@@ -108,7 +114,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Train transport for Juniper Networks JunOS devices