oracle-model-generator 0.4.1 → 0.5.0

data/README.md

@@ -0,0 +1,169 @@
+# MAINTAINER WANTED
+
+As of 2019 I haven't used Oracle or this library for many years. I would like
+to turn it over to someone who is. If you are interested please contact me,
+and we can discuss transferring the repository.
+
+## Description
+A library for generating an ActiveRecord model from an existing Oracle table.
+This will install an "omg" executable that you can use from the command line.
+
+## Synopsis
+Using the command line tool:
+
+`omg -d your_database -t locations -u some_user -p some_password`
+
+The above command results in a file called "location.rb". This is an
+ActiveRecord model declaration, with all validations, primary keys,
+table name and belongs_to relationships defined.
+
+If your LOCATIONS table looks like this:
+
+```sql
+create table locations(
+  location_id number(4,0) primary key,
+  street_address varchar2(40), 
+  postal_code varchar2(12),
+  city varchar2(30) not null
+  state_province varchar2(25),
+  country_id CHAR(2),
+  constraint "LOC_C_ID_FK" FOREIGN KEY (country_id)
+    references COUNTRIES (country_id)
+)
+```
+
+The omg library will generate this:
+
+```ruby
+class Location < ActiveRecord::Base
+  set_table_name :locations
+  set_primary_key :location_id
+
+  # Table relationships
+
+  belongs_to :countries
+
+  # Validations
+  
+  validates :location_id, :presence => true, :numericality => {
+    :less_than_or_equal_to => 9999, 
+    :greater_than_or_equal_to => -9999,
+    :only_integer => true
+  }
+
+  validates :street_address, :length => {:maximum => 40}
+  validates :postal_code, :length => {:maximum => 12}
+  validates :city, :length => {:maximum => 30}, :presence => true
+  validates :state_province, :length => {:maximum => 25}
+  validates :country_id, :length => {:maximum => 2}
+end
+```
+
+It will also generate a corresponding test file using test-unit 2 by default.
+For the above example you will see some tests like this:
+
+```ruby
+class TC_Location < Test::Unit::TestCase
+  def setup
+    @location = Location.new
+  end
+
+  test 'table name is locations' do
+    assert_equal('locations', Location.table_name)
+  end
+
+  test 'primary key is location_id' do
+    assert_equal('location_id', Location.primary_key)
+  end
+
+  test 'location_id basic functionality' do
+    assert_respond_to(@location, :location_id)
+    assert_nothing_raised{ @location.location_id }
+    assert_kind_of(Numeric, @location.location_id)
+  end
+
+  test 'location_id must be a number' do
+    @location.location_id = 'test_string'
+    assert_false(@location.valid?)
+    assert_true(@location.errors[:location_id].include?('is not a number'))
+  end
+
+  test 'location_id cannot exceed the value 9999' do
+    @location.location_id = 10000
+    assert_false(@location.valid?)
+    assert_true(@location.errors[:location_id].include?('must be less than or equal to 9999'))
+  end
+
+  # ... and so on.
+end
+```
+
+## Requirements
+* ruby-oci8
+* getopt
+
+## Running the specs
+Run `docker-compose run --rm oracle-model-generator bundle exec rspec`.
+
+You may need to use sudo. No guarantees on MacOS because of known issues
+with the Oracle instant client.
+
+## Optional Libraries
+If you want to be able to avoid specifying a username and password on the
+command line then you will need the `dbi-dbrc` library.
+
+If you want your models to support multiple primary keys, then you will
+need to install the `composite_primary_keys` library.
+
+If you want date format validations, then you will need to install the
+`validates_timeliness` library.
+
+## What this library doesn't do
+I do not attempt to set `has_many` or `has_one` relationships. There's no good
+way to determine that relationship (one or many?). Besides, in practice I
+find that most people set custom has_xxx relationships that go over and
+above what's set in the Oracle database anyway for purposes of their
+application.
+
+I also do not go out of my way to get the model name correct with regards
+to singular vs plural. I do a simple guess that covers most cases, but
+complex cases will break it. It's much easier for you to rename a class or
+file name than it is for me to get this 100% correct.
+
+As of 0.3.1 there's also the `--class` option that let's you explicitly
+set it if you like.
+
+## Author's Comments
+I chose not to patch the `legacy_data` library because I have no interest in
+supporting other vendors other than Oracle with this library. By focusing only
+on Oracle I could take advantage of ruby-oci8 features. In addition, I have no
+interest in making this a Rails plugin, and I needed the support of multiple
+primary keys.
+
+## Future Plans (originally)
+* Add support for views.
+* Add automatic test suite generation for rspec.
+* Explicitly set :foreign_key if using CPK in belongs_to relationships.
+* The output could use a little formatting love.
+
+## Acknowlegements
+Thanks go to Daniel Luna for his --class patch.
+
+## Known Issues
+None known. If you find any issues, please report them on the github project
+page at http://www.github.com/djberg96/oracle-model-generator.
+
+## Warranty
+This package is provided "as is" and without any express or
+implied warranties, including, without limitation, the implied
+warranties of merchantability and fitness for a particular purpose.
+
+## Copyright
+(C) 2010-2025 Daniel J. Berger
+All Rights Reserved
+
+## License
+Apache-2.0
+
+## Author
+Daniel J. Berger

data/Rakefile

@@ -1,16 +1,24 @@
 require 'rake'
-require 'rake/testtask'
 require 'rake/clean'
+require 'rspec/core/rake_task'
 
-CLEAN.include("**/*.gem", "**/*.rbc", "**/*.log")
+CLEAN.include("**/*.gem", "**/*.rbc", "**/*.log", "**/*.lock")
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+  t.rspec_opts = ['--format', 'documentation', '--color']
+end
+  
+desc 'Run RSpec tests'
+task :rspec => :spec
 
 namespace 'gem' do
   desc 'Create the oracle-model-generator gem'
   task :create => :clean do
     require 'rubygems/package'
-    spec = eval(IO.read('oracle-model-generator.gemspec'))
+    spec = Gem::Specification.load('oracle-model-generator.gemspec')
     spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
-    Gem::Package.build(spec, true)
+    Gem::Package.build(spec)
   end
 
   desc 'Install the oracle-model-generator gem'
@@ -20,9 +28,5 @@ namespace 'gem' do
   end
 end
 
-Rake::TestTask.new do |t|
-  t.warning = true
-  t.verbose = true
-end
-
-task :default => :test
+# Set default task to run both test suites
+task :default => [:spec]

data/certs/djberg96_pub.pem

@@ -1,21 +1,26 @@
 -----BEGIN CERTIFICATE-----
-MIIDcDCCAligAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAhkamJl
+MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
 cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
-MB4XDTE1MDkwMjIwNDkxOFoXDTE2MDkwMTIwNDkxOFowPzERMA8GA1UEAwwIZGpi
+MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
 ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
-bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMyTkvXqRp6hLs9eoJOS
-Hmi8kRYbq9Vkf15/hMxJpotYMgJVHHWrmDcC5Dye2PbnXjTkKf266Zw0PtT9h+lI
-S3ts9HO+vaCFSMwFFZmnWJSpQ3CNw2RcHxjWkk9yF7imEM8Kz9ojhiDXzBetdV6M
-gr0lV/alUr7TNVBDngbXEfTWscyXh1qd7xZ4EcOdsDktCe5G45N/o3662tPQvJsi
-FOF0CM/KuBsa/HL1/eoEmF4B3EKIRfTHrQ3hu20Kv3RJ88QM4ec2+0dd97uX693O
-zv6981fyEg+aXLkxrkViM/tz2qR2ZE0jPhHTREPYeMEgptRkTmWSKAuLVWrJEfgl
-DtkCAwEAAaN3MHUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEwe
-nn6bfJADmuIDiMSOzedOrL+xMB0GA1UdEQQWMBSBEmRqYmVyZzk2QGdtYWlsLmNv
-bTAdBgNVHRIEFjAUgRJkamJlcmc5NkBnbWFpbC5jb20wDQYJKoZIhvcNAQEFBQAD
-ggEBAHmNOCWoDVD75zHFueY0viwGDVP1BNGFC+yXcb7u2GlK+nEMCORqzURbYPf7
-tL+/hzmePIRz7i30UM//64GI1NLv9jl7nIwjhPpXpf7/lu2I9hOTsvwSumb5UiKC
-/sqBxI3sfj9pr79Wpv4MuikX1XPik7Ncb7NPsJPw06Lvyc3Hkg5X2XpPtLtS+Gr2
-wKJnmzb5rIPS1cmsqv0M9LPWflzfwoZ/SpnmhagP+g05p8bRNKjZSA2iImM/GyYZ
-EJYzxdPOrx2n6NYR3Hk+vHP0U7UBSveI6+qx+ndQYaeyCn+GRX2PKS9h66YF/Q1V
-tGSHgAmcLlkdGgan182qsE/4kKM=
+bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+/3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
 -----END CERTIFICATE-----

data/docker-compose.yml

@@ -0,0 +1,41 @@
+services:
+  # Oracle Express Edition database for testing
+  oracle-db:
+    image: gvenzl/oracle-xe:21-slim
+    environment:
+      - ORACLE_PASSWORD=oracle
+      - APP_USER=hr
+      - APP_USER_PASSWORD=hr
+    ports:
+      - "1521:1521"
+    volumes:
+      - oracle_data:/opt/oracle/oradata
+    shm_size: 1g
+    healthcheck:
+      test: ["CMD", "healthcheck.sh"]
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 60s
+
+  # Oracle Model Generator testing environment
+  oracle-model-generator:
+    build: .
+    depends_on:
+      oracle-db:
+        condition: service_healthy
+    environment:
+      - ORACLE_HOST=oracle-db
+      - ORACLE_PORT=1521
+      - ORACLE_SID=freepdb1
+      - ORACLE_USER=hr
+      - ORACLE_PASSWORD=hr
+    volumes:
+      - .:/app
+    working_dir: /app
+    stdin_open: true
+    tty: true
+    command: ["rake"]  # This will run tests with automatic setup
+
+volumes:
+  oracle_data:

data/lib/oracle/model/generator.rb

@@ -4,7 +4,7 @@ module Oracle
   module Model
     class Generator
       # The version of the oracle-model-generator library
-      VERSION = '0.4.1'
+      VERSION = '0.5.0'
 
       # The raw OCI8 connection.
       attr_reader :connection

data/oracle-model-generator.gemspec

@@ -1,23 +1,22 @@
 require 'rubygems'
 
 Gem::Specification.new do |spec|
-  spec.name       = 'oracle-model-generator'
-  spec.version    = '0.4.1'
-  spec.author     = 'Daniel J. Berger'
-  spec.license    = 'Artistic 2.0'
-  spec.email      = 'djberg96@gmail.com'
-  spec.homepage   = 'http://www.github.com/djberg96/oracle-model-generator'
-  spec.summary    = 'A Ruby interface for determining protocol information'
-  spec.test_file  = 'test/test_oracle_model_generator.rb'
-  spec.files      = Dir['**/*'].reject{ |f| f.include?('git') }
-  spec.cert_chain = spec.cert_chain = ['certs/djberg96_pub.pem']
+  spec.name        = 'oracle-model-generator'
+  spec.version     = '0.5.0'
+  spec.author      = 'Daniel J. Berger'
+  spec.license     = 'Apache-2.0'
+  spec.email       = 'djberg96@gmail.com'
+  spec.homepage    = 'http://www.github.com/djberg96/oracle-model-generator'
+  spec.summary     = 'A Ruby interface for determining protocol information'
+  spec.test_files  = Dir['spec/**/*.rb']
+  spec.files       = Dir['**/*'].reject{ |f| f.include?('git') }
+  spec.cert_chain  = spec.cert_chain = ['certs/djberg96_pub.pem']
 
   spec.executables = "omg"
-  spec.extra_rdoc_files = %w[CHANGES README MANIFEST]
 
-  spec.add_dependency('ruby-oci8')
-  spec.add_dependency('getopt')
-  spec.add_development_dependency('test-unit')
+  spec.add_dependency('ruby-oci8', '~> 2.2')
+  spec.add_dependency('getopt', '~> 1.6')
+  spec.add_development_dependency('rspec', '~> 3.12')
 
   spec.description = <<-EOF
     The oracle-model-generator library allows you to generate an ActiveRecord

data/spec/oracle_model_generator_spec.rb

@@ -0,0 +1,176 @@
+require 'spec_helper'
+require 'support/oracle_connection'
+require 'oracle/model/generator'
+
+RSpec.describe Oracle::Model::Generator do
+  include_context 'Oracle connection'
+  
+  let(:generator) { described_class.new(connection) }
+
+  describe 'class information' do
+    it 'has the correct version number' do
+      expect(Oracle::Model::Generator::VERSION).to eq('0.5.0')
+    end
+  end
+
+  describe '#initialize' do
+    it 'accepts an OCI8 connection object' do
+      expect { described_class.new(connection) }.not_to raise_error
+    end
+
+    it 'sets up instance variables correctly' do
+      expect(generator.connection).to eq(connection)
+      expect(generator.constraints).to eq([])
+      expect(generator.primary_keys).to eq([])
+      expect(generator.foreign_keys).to eq([])
+      expect(generator.dependencies).to eq([])
+      expect(generator.belongs_to).to eq([])
+      expect(generator.column_info).to eq([])
+      expect(generator.table).to be_nil
+      expect(generator.model).to be_nil
+    end
+  end
+
+  describe '#generate' do
+    it 'responds to the generate method' do
+      expect(generator).to respond_to(:generate)
+    end
+
+    it 'works with a table name' do
+      expect { generator.generate('employees') }.not_to raise_error
+    end
+
+    it 'works with a view name' do
+      expect { generator.generate('emp_details_view', true) }.not_to raise_error
+    end
+
+    context 'when generating from a table' do
+      before { generator.generate('employees') }
+
+      it 'sets the table name in uppercase' do
+        expect(generator.table).to eq('EMPLOYEES')
+      end
+
+      it 'generates a model name from the table name' do
+        expect(generator.model).to eq('Employee')
+      end
+
+      it 'sets view to false' do
+        expect(generator.view).to be false
+      end
+
+      it 'populates column information' do
+        expect(generator.column_info).to be_an(Array)
+        expect(generator.column_info).not_to be_empty
+      end
+
+      it 'finds primary keys' do
+        expect(generator.primary_keys).to be_an(Array)
+        expect(generator.primary_keys).to include('employee_id')
+      end
+
+      it 'populates constraints information' do
+        expect(generator.constraints).to be_an(Array)
+        expect(generator.constraints).not_to be_empty
+      end
+    end
+
+    context 'when generating from a view' do
+      before { generator.generate('emp_details_view', true) }
+
+      it 'sets the table name in uppercase' do
+        expect(generator.table).to eq('EMP_DETAILS_VIEW')
+      end
+
+      it 'generates the correct model name' do
+        expect(generator.model).to eq('EmpDetailsView')
+      end
+
+      it 'sets view to true' do
+        expect(generator.view).to be true
+      end
+    end
+  end
+
+  describe '#model' do
+    it 'returns the active record model name' do
+      generator.generate('emp_details_view', true)
+      expect(generator).to respond_to(:model)
+      expect(generator.model).to eq('EmpDetailsView')
+    end
+
+    it 'removes trailing s from model names' do
+      generator.generate('employees')
+      expect(generator.model).to eq('Employee')
+    end
+  end
+
+  describe '#table' do
+    it 'returns the uppercased table name' do
+      generator.generate('emp_details_view', true)
+      expect(generator).to respond_to(:table)
+      expect(generator.table).to eq('EMP_DETAILS_VIEW')
+    end
+  end
+
+  describe '#primary_keys' do
+    it 'returns an array of primary keys' do
+      generator.generate('employees')
+      expect(generator.primary_keys).to be_an(Array)
+      expect(generator.primary_keys).to include('employee_id')
+    end
+  end
+
+  describe '#column_info' do
+    it 'returns an array of column metadata' do
+      generator.generate('employees')
+      expect(generator.column_info).to be_an(Array)
+      expect(generator.column_info.length).to be > 0
+    end
+  end
+
+  describe '#constraints' do
+    it 'returns an array of constraint information' do
+      generator.generate('employees')
+      expect(generator.constraints).to be_an(Array)
+      expect(generator.constraints).not_to be_empty
+    end
+  end
+
+  describe '#foreign_keys' do
+    it 'returns an array of foreign key names' do
+      generator.generate('employees')
+      expect(generator.foreign_keys).to be_an(Array)
+    end
+  end
+
+  describe '#belongs_to' do
+    it 'returns an array of parent tables' do
+      generator.generate('employees')
+      expect(generator.belongs_to).to be_an(Array)
+    end
+  end
+
+  describe '#dependencies' do
+    it 'returns an array of dependent objects' do
+      generator.generate('employees', true)
+      expect(generator).to respond_to(:dependencies)
+      expect(generator.dependencies).to be_an(Array)
+      
+      # Only check for Hash if there are dependencies
+      if generator.dependencies.any?
+        expect(generator.dependencies.first).to be_a(Hash)
+      end
+    end
+  end
+
+  describe '#view' do
+    it 'correctly identifies tables vs views' do
+      generator.generate('employees')
+      expect(generator.view).to be false
+      
+      generator.generate('emp_details_view', true)
+      expect(generator.view).to be true
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,30 @@
+# Load the library we're testing
+require_relative '../lib/oracle-model-generator'
+
+# RSpec configuration for Oracle Model Generator
+RSpec.configure do |config|
+  # Use the expect() syntax rather than should syntax
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # Use the new mock framework syntax
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  # Enable color output
+  config.color = true
+
+  # Use documentation format for output
+  config.formatter = :documentation
+
+  # Run specs in random order to surface order dependencies
+  config.order = :random
+
+  # Allow filtering tests by tags
+  config.filter_run_when_matching :focus
+
+  # Shared context for setting up test data
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+end

data/spec/support/oracle_connection.rb

@@ -0,0 +1,126 @@
+require 'oci8'
+
+# Shared context for Oracle database connection and test data
+RSpec.shared_context 'Oracle connection' do
+  before(:context) do
+    @oracle_connection = begin
+      # In Docker environment, use the service name instead of localhost
+      host = ENV['ORACLE_HOST'] || 'localhost'
+      port = ENV['ORACLE_PORT'] || '1521'
+      sid = ENV['ORACLE_SID'] || 'freepdb1'
+      database_str = "#{host}:#{port}/#{sid}"
+      
+      OCI8.new(
+        ENV['ORACLE_USER'] || 'hr',
+        ENV['ORACLE_PASSWORD'] || 'oracle',
+        database_str
+      )
+    rescue OCIError => e
+      warn "Database connection failed: #{e.message}"
+      warn "Make sure Oracle database is running and accessible"
+      warn "Connection string: #{ENV['ORACLE_HOST'] || 'localhost'}:#{ENV['ORACLE_PORT'] || '1521'}/#{ENV['ORACLE_SID'] || 'freepdb1'}"
+      warn "User: #{ENV['ORACLE_USER'] || 'hr'}"
+      raise e
+    end
+    setup_test_data
+  end
+
+  after(:context) do
+    # Cleanup test tables and views
+    cleanup_test_data
+    
+    # Close the connection
+    @oracle_connection&.logoff
+  end
+
+  # Use a method instead of let for context-level variables
+  def connection
+    @oracle_connection
+  end
+
+  private
+
+  def setup_test_data
+    # Create test tables and views if they don't exist
+    setup_sample_data
+  end
+
+  def cleanup_test_data
+    # Drop test views first (to avoid dependency issues)
+    begin
+      @oracle_connection.exec('DROP VIEW hr.employees_by_department') rescue nil
+    rescue => e
+      # Ignore errors if views don't exist
+    end
+
+    # Note: We don't drop HR schema tables as they might be used by other tests
+  end
+
+  def setup_sample_data
+    # Check if employees table exists and has data
+    begin
+      cursor = @oracle_connection.parse('SELECT COUNT(*) FROM employees')
+      cursor.exec
+      count = cursor.fetch[0]
+      cursor.close
+
+      if count == 0
+        # Insert sample data into employees table
+        @oracle_connection.exec(<<~SQL)
+          INSERT INTO employees (employee_id, first_name, last_name, email, phone_number,
+                               hire_date, job_id, salary, commission_pct, manager_id, department_id)
+          VALUES (1, 'John', 'Doe', 'john.doe@example.com', '555-1234',
+                  DATE '2020-01-15', 'IT_PROG', 5000, NULL, NULL, 60)
+        SQL
+
+        @oracle_connection.exec(<<~SQL)
+          INSERT INTO employees (employee_id, first_name, last_name, email, phone_number,
+                               hire_date, job_id, salary, commission_pct, manager_id, department_id)
+          VALUES (2, 'Jane', 'Smith', 'jane.smith@example.com', '555-5678',
+                  DATE '2021-03-10', 'IT_PROG', 5500, NULL, 1, 60)
+        SQL
+
+        @oracle_connection.commit
+      end
+
+      # Check if departments table exists and has data
+      cursor = @oracle_connection.parse('SELECT COUNT(*) FROM departments')
+      cursor.exec
+      dept_count = cursor.fetch[0]
+      cursor.close
+
+      if dept_count == 0
+        # Insert sample data into departments table
+        @oracle_connection.exec(<<~SQL)
+          INSERT INTO departments (department_id, department_name, manager_id, location_id)
+          VALUES (60, 'IT', 1, 1700)
+        SQL
+
+        @oracle_connection.exec(<<~SQL)
+          INSERT INTO departments (department_id, department_name, manager_id, location_id)
+          VALUES (50, 'Shipping', NULL, 1500)
+        SQL
+
+        @oracle_connection.commit
+      end
+
+      # Create a test view if it doesn't exist
+      begin
+        @oracle_connection.exec(<<~SQL)
+          CREATE OR REPLACE VIEW hr.employees_by_department AS
+          SELECT e.employee_id, e.first_name, e.last_name, e.email,
+                 d.department_name, d.department_id
+          FROM employees e
+          JOIN departments d ON e.department_id = d.department_id
+        SQL
+      rescue => e
+        # View creation might fail if tables don't exist yet, that's okay
+        warn "Could not create test view: #{e.message}"
+      end
+
+    rescue => e
+      warn "Could not set up sample data: #{e.message}"
+      # Continue with tests even if sample data setup fails
+    end
+  end
+end