yui_rest_client 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ea981c5b7efbf645df05748af02a42230510892162b5279634794d527d82ddbc
+  data.tar.gz: e3291d947be7d5e0d1d1257766fb4de0ccaf91891c4f53e7b049a05a90596a5d
+SHA512:
+  metadata.gz: 2aa47e95d61d4f9e4a6b7a02e81e55af1274c9d93c73bcc5f3856c6389083f482c7cd5fe125a65b0b2061704896f60777542b487a7d3ce24d5a59f69bb58f8ea
+  data.tar.gz: 2307d790e8d50ba3abf495d055f283b2ba778b3b9e1655712e0d59d00ddbe0793e41d08bcda5ba52076645e2f46207545f9c624f79e94f4f6521280e3676713c

data/.github/workflows/publish.yml

@@ -0,0 +1,33 @@
+name: Publish Gem
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    name: Publish Gem
+    steps:
+    - uses: actions/checkout@v2
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.5
+    - name: Install dependencies
+      run: bundle install
+    - name: Setup credentials
+      env:
+        RUBYGEMS_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}
+      run: |
+        cat << EOF > ~/.gem/credentials
+        ---
+        :rubygems_api_key: $RUBYGEMS_API_KEY
+        EOF
+        chmod 0600 ~/.gem/credentials
+    - name: Build gem
+      run: gem build yui_rest_client.gemspec
+    - name: Push gem
+      run: gem push yui_rest_client*.gem
+    - name: Cleanup credentials
+      if: always()
+      run: rm ~/.gem/credentials

data/.github/workflows/test.yml

@@ -0,0 +1,26 @@
+name: Test
+
+on: pull_request
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: [ '2.5', '2.6' ]
+    name: Ruby ${{ matrix.ruby }}
+    steps:
+    - uses: actions/checkout@v2
+    - name: Check version file was changed
+      run: |
+        git fetch origin master
+        git --no-pager diff --name-only FETCH_HEAD `git merge-base FETCH_HEAD master` | grep version.rb
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - name: Install dependencies
+      run: bundle install
+    - name: Run rubocop
+      run: bundle exec rubocop
+    - name: Run tests
+      run: bundle exec rspec

data/.gitignore

@@ -0,0 +1,15 @@
+*.gem
+*.rbc
+.rakeTasks
+.rspec_status
+.vendor
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/pkg/
+/spec/reports/
+/tmp/
+doc/
+Gemfile.lock
+y2signal.log

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,41 @@
+# Cops documentation: https://rubocop.readthedocs.io/en/stable/
+
+AllCops:
+  TargetRubyVersion: 2.5
+
+Layout/LineLength:
+  Max: 120
+
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+
+Lint/RaiseException:
+  Enabled: true
+
+Lint/StructNewOverride:
+  Enabled: true
+
+Lint/UriEscapeUnescape:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - "**/*_spec.rb"
+
+Style/Documentation:
+  Enabled: false
+
+Style/ExponentialNotation:
+  Enabled: true
+
+Style/HashEachMethods:
+  Enabled: true
+
+Style/HashTransformKeys:
+  Enabled: true
+
+Style/HashTransformValues:
+  Enabled: true
+
+Metrics/ModuleLength:
+  Max: 500

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in yui_rest_client.gemspec
+gemspec
+gem 'rubocop'
+gem 'webmock'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019-2020 SUSE LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,216 @@
+# YuiRestClient
+
+Ruby gem to interact with YaST applications via libyui-rest-api.
+See documentation of the [libyui-rest-api project](https://github.com/libyui/libyui-rest-api/)
+for more details about server side implementation.
+
+Usage example:
+
+```ruby
+require 'yui_rest_client'
+
+app = YuiRestClient::App.new(host: 'localhost', port: '9999')
+button = app.button(id: 'settime')
+button.click
+```
+
+## Installing yui_rest_client
+
+As soon as the gem is in development, run the following command from command line:
+
+```
+gem install yui_rest_client
+```
+
+In order to build and install locally run:
+```
+gem build yui_rest_client.gemspec
+gem install yui_rest_client-*.gem
+```
+
+Now need to require gem in order to use it.
+
+## Initialize the app under control
+
+It is assumed the application is running on `localhost:9999`.
+Then the code to initialize the application looks like:
+
+```ruby
+require 'yui_rest_client'
+
+app = YuiRestClient::App.new(host: 'localhost', port: '9999')
+```
+
+## Supported widgets
+
+yui_rest_client supports different types of widgets.
+
+Here are examples of usage:
+
+### Button
+```ruby
+app.button(id: 'test_id').click  # clicks the button with id 'test_id'
+app.button(label: 'test_label').debug_label # get 'debug_label' value with label 'test_label'
+```
+
+### Bargraph
+```ruby
+# Get list of labels in the segments:
+app.bargraph(class: YBarGraph).labels
+# Get array of hashes containing label->value pairs denoting each segment:
+app.bargraph(class: YBarGraph).segments
+# Get list of values in the segments:
+app.bargraph(class: YBarGraph).values
+```
+
+### Checkbox
+```ruby
+app.checkbox(id: 'test_id').check  # checks the checkbox with id 'test_id'
+app.checkbox(label: 'test_label', class: 'YCheckBox').checked? # gets the state of checkbox with label 'test_label'
+app.checkbox(id: 'test_id').toggle # toggles the checkbox with id 'test_id'
+app.checkbox(label: 'test_label', class: 'YCheckBoxFrame').uncheck  # unchecks the checkbox with id 'test_id'
+```
+
+### Combobox
+```ruby
+app.combobox(id: 'test_id').items  # gets all available items for combobox with id 'test_id'
+app.combobox(id: 'test_id').select  # selects the checkbox with id 'test_id'
+app.combobox(id: 'test_id').selected_item # gets the selected item in combobox with id 'test_id'
+app.combobox(label: 'cmbx', class: 'YComboBox').set # Sets custom string to the editable checkbox
+```
+
+### Datefield
+```ruby
+# Set date field to 2048-08-16
+app.datefield(class: 'YDateField').set(Date.new(2048, 8, 16))
+app.datefield(id: 'date').value  # gets value from datefield with id 'date'
+```
+
+### Label
+```ruby
+app.label(id: 'test_id').heading?  # gets if label has bold font respresentation with id 'test_id'
+app.label(id: 'test_id').text  # gets text from label with id 'test_id'
+```
+
+### Menubutton
+```ruby
+app.menubutton(id: 'test_id').click('button1')  # clicks on 'button1' of menubutton with id 'test_id'
+```
+
+### Numberbox
+```ruby
+app.numberbox(id: 'test_id').min_value  # gets min value to be set in numberbox with id 'test_id'
+app.numberbox(id: 'test_id').max_value  # gets max value to be set in numberbox with id 'test_id'
+app.numberbox(id: 'test_id').set(99)  # sets 99 to numberbox with id 'test_id'
+app.numberbox(id: 'test_id').value  # gets value from numberbox with id 'test_id'
+```
+
+### Radiobutton
+```ruby
+app.radiobutton(id: 'test_id').select  # selects the radiobutton with id 'test_id'
+app.radiobutton(id: 'test_id').selected?  # gets the state of radiobutton with id 'test_id'
+```
+
+### Richtext
+```ruby
+app.richtext(id: 'test_id').click_link('test_link')  # clicks on link "test_link" with id 'test_id'
+app.richtext(id: 'test_id').text  # gets text from richtext
+```
+
+### Tab
+```ruby
+app.tab(id: 'test_id').items  # gets items from tab with id 'test_id'
+app.tab(id: 'test_id').select(value: 'item')  # selects specific tab with id 'test_id'
+app.tab(id: 'test_id').selected_item  # gets selected tab for tab with id 'test_id'
+```
+
+### Table
+```ruby
+# checks if there is not rows in table with id 'test_id':
+app.table(id: 'test_id').empty?
+# gets rows in the table with id 'test_id':
+app.table(id: 'test_id').items
+# selects row in table with value test.item.1 and column test.header:
+app.table(id: 'test_id').select( value: 'test.item.1', column: 'test.header' )
+# selects row with number 3, numeration starts from 0 and corresponds to the order
+# in the list returned by method `items`:
+app.table(id: 'test_id').select(row: 3)
+# gets items currently selected in table with id 'test_id':
+app.table(id: 'test_id').seleted_items
+
+
+```
+### Textbox
+```ruby
+app.textbox(id: 'test_id').max_length
+app.textbox(id: 'test_id').set('Test Text')  # sets "Test Text" to textbox with id 'test_id'
+app.textbox(id: 'test_id').password? # checks password mode for textbox with id 'test_id'
+app.textbox(id: 'test_id').valid_chars # checks valid chars for textbox with id 'test_id'
+app.textbox(id: 'test_id').value  # gets value from textbox with id 'test_id'
+```
+
+### TimeField
+```ruby
+# Set TimeField to current time
+app.timefield(label: 'time', class: 'YTimeField').set(Time.now)
+app.timefield(id: 'time').value  # gets value from timefield with id 'time'
+```
+
+### Tree
+```ruby
+app.tree(id: 'test_id').items  # gets items from tree with id 'test_id'
+app.tree(id: 'test_id').select('node1|node1_2')  # selects item in tree with id 'test_id'
+app.tree(id: 'test_id').selected_item  # gets currently highlighted item from tree with id 'test_id'
+```
+
+## Filters
+
+yui_rest_client supports the same filters, as libyui-rest-api provides:
+
+  * id - widget ID serialized as string, might include special characters like backtick (\`)
+  * label - widget label as currently displayed (i.e. translated!)
+  * class - widget class
+
+Also, regex for the filters is allowed.
+
+Example:
+```ruby
+app.button(id: /.*test/).debug_label
+```
+
+## Waits
+
+### Default timeout and interval
+
+All the actions against widgets in yui_rest_client are made with default timeout and interval.
+Default timeout is 5 sec, default interval is 0.5 sec.
+That means yui_rest_client will repeat sending requests to YaST application every 0.5 seconds until 5 seconds
+timeout will be reached. This default wait is needed because widgets may not be loaded immediately while trying to
+interact with them (e.g. when navigating from one screen to another).
+
+The default timeout and interval can be changed by the following:
+
+```ruby
+YuiRestClient.timeout = 10
+YuiRestClient.interval = 1
+```
+
+### Specific waits
+
+All the widgets include Waitable module, which contains special methods to allow explicit waiting:
+`wait_until` and `wait_while`.
+These methods can be used when it is needed to wait until some property of the widget will be changed.
+
+For example, wait until button will be enabled and click on it:
+
+```ruby
+# with #to_proc syntax:
+app.button(id: 'test_id').wait_until(&:enabled?).click
+
+# without #to_proc syntax:
+app.button(id: 'test_id').wait_until{ |button| button.enabled? }.click
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
+
+task :integration do
+  RSpec::Core::RakeTask.new(:integration) do |t|
+    t.pattern = 'spec/widgets/*_spec.rb'
+  end
+end
+
+task :unit do
+  RSpec::Core::RakeTask.new(:unit) do |t|
+    t.pattern = 'spec/unit/**/*_spec.rb'
+  end
+end

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'yui_rest_client'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/yui_rest_client.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'json'
+require 'net/http'
+require 'uri'
+require 'timeout'
+require 'time'
+
+require 'yui_rest_client/version'
+require 'yui_rest_client/local_process'
+require 'yui_rest_client/widgets'
+require 'yui_rest_client/logger'
+require 'yui_rest_client/timer'
+require 'yui_rest_client/wait'
+require 'yui_rest_client/app'
+require 'yui_rest_client/http/http_client'
+require 'yui_rest_client/http/response'
+require 'yui_rest_client/http/version_controller'
+require 'yui_rest_client/http/widget_controller'
+require 'yui_rest_client/error'
+require 'yui_rest_client/actions'
+require 'yui_rest_client/filter_extractor'
+
+# Client to interact with YAST UI rest api framework for integration testing
+module YuiRestClient
+  class << self
+    attr_writer :timeout, :interval
+
+    def timeout
+      @timeout ||= 5
+    end
+
+    def interval
+      @interval ||= 0.5
+    end
+  end
+
+  def self.logger
+    @logger ||= YuiRestClient::Logger.new
+  end
+end