[rb] split out tests into separate files and let the shortcode display the whole file

Author: titusfortner

examples/ruby/spec/browsers/chrome/options/arguments_spec.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Chrome Options' do
+  it 'add arguments' do
+    options = default_chrome_options
+
+    options.args << '--start-maximized'
+
+    @driver = Selenium::WebDriver.for :chrome, options: options
+  end
+end

examples/ruby/spec/browsers/chrome/options/basic_spec.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Chrome Options' do
+  it 'start session with basic options' do
+    options = Selenium::WebDriver::Chrome::Options.new
+    @driver = Selenium::WebDriver.for :chrome, options: options
+  end
+end

examples/ruby/spec/browsers/chrome/options/binary_spec.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Chrome Options' do
+  it 'sets location of binary' do
+    options = default_chrome_options
+
+    options.binary = chrome_location
+
+    @driver = Selenium::WebDriver.for :chrome, options: options
+  end
+
+  private
+
+  def chrome_location
+    options = default_chrome_options
+    service = Selenium::WebDriver::Service.chrome
+    finder = Selenium::WebDriver::DriverFinder.new(options, service)
+    ENV['CHROMEDRIVER_BIN'] = finder.driver_path
+    ENV['CHROME_BIN'] = finder.browser_path
+  end
+end

examples/ruby/spec/browsers/chrome/options/detach_spec.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Chrome Options' do
+  it 'keeps browser open' do
+    options = default_chrome_options
+
+    options.detach = true
+
+    @driver = Selenium::WebDriver.for :chrome, options: options
+  end
+end

examples/ruby/spec/browsers/chrome/options/exclude_switches_spec.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Chrome Options' do
+  it 'excludes switches' do
+    options = default_chrome_options
+
+    options.exclude_switches << 'disable-popup-blocking'
+
+    @driver = Selenium::WebDriver.for :chrome, options: options
+  end
+end

examples/ruby/spec/browsers/chrome/options/extensions_spec.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Chrome Options' do
+  it 'add extensions' do
+    options = default_chrome_options
+
+    extension_file_path = File.expand_path('../../../spec_support/extensions/webextensions-selenium-example.crx',
+                                           __dir__)
+    options.add_extension(extension_file_path)
+
+    @driver = Selenium::WebDriver.for :chrome, options: options
+    @driver.get('https://www.selenium.dev/selenium/web/blank.html')
+    injected = @driver.find_element(:id, 'webextensions-selenium-example')
+    expect(injected.text).to eq 'Content injected by webextensions-selenium-example'
+  end
+end

website_and_docs/content/documentation/webdriver/browsers/chrome.en.md

@@ -32,7 +32,7 @@ Starting a Chrome session with basic defined options looks like this:
 {{< gh-codeblock path="/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs#L30-L31" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L10-L11" >}}
+{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome/options/basic_spec.rb#L7-L8" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/browser/chromeSpecificCaps.spec.js#L51-L55">}}
@@ -64,7 +64,7 @@ Add an argument to options:
 {{< gh-codeblock path="/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs#L39" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L17" >}}
+{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome/options/arguments_spec.rb#L9" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/browser/chromeSpecificCaps.spec.js#L9-L12">}}
@@ -92,7 +92,7 @@ Add a browser location to options:
 {{< gh-codeblock path="/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs#L49" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L25" >}}
+{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome/options/binary_spec.rb#L9" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/browser/chromeSpecificCaps.spec.js#L41-L44">}}
@@ -121,7 +121,7 @@ Add an extension to options:
 {{< gh-codeblock path="/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs#L61" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L34" >}}
+{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome/options/extensions_spec.rb#L10" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/browser/chromeSpecificCaps.spec.js#L62-L66">}}
@@ -147,7 +147,7 @@ so long as the quit command is not sent to the driver.
 **Note**: This is already the default behavior in .NET.
 {{% /tab %}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L45" >}}
+{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome/options/detach_spec.rb#L9" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/browser/chromeSpecificCaps.spec.js#L29-L32">}}
@@ -178,7 +178,7 @@ Set excluded arguments on options:
 {{< gh-codeblock path="examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs#L76" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L53" >}}
+{{< gh-codeblock path="/examples/ruby/spec/browsers/chrome/options/exclude_switches_spec.rb#L9" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/browser/chromeSpecificCaps.spec.js#L19-L22">}}

website_and_docs/layouts/shortcodes/gh-codeblock.html

@@ -21,6 +21,7 @@
 
 {{ $fullPath := .Get "path" }}
 {{ $path := index (split $fullPath "#") 0 }}
+{{ $hasFragment := in $fullPath "#" }}
 
 {{ $apiUrl := printf "%s/%s/%s/contents%s?ref=%s" $apiBaseUrl $org $repo $path $branch }}
 {{ $webUrl := printf "%s/%s/%s/blob/%s/%s" $webBaseUrl $org $repo $branch $fullPath }}
@@ -50,6 +51,13 @@
 
   {{ highlight $codeSnippet $language }}
 
+{{ if $hasFragment }}
+<details class="mt-2">
+  <summary>Show full example</summary>
+  <div class="pt-2">{{ highlight $content $language }}</div>
+</details>
+{{ end }}
+
   <div class="text-end pb-2">
     <a href="{{- $webUrl -}}" target="_blank">
       <i class="fas fa-external-link-alt pl-2"></i>
@@ -58,6 +66,4 @@
   </div>
 {{ else }}
   {{ partial "github-content.html" }}
-{{ end }}
-
-
+{{ end }}