marta 0.31831 → 0.34054

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5194e2abdec5dea63de3729eded639658cd5e4c4
-  data.tar.gz: 3c246346272294bb585cad04e824ad3f0c271887
+  metadata.gz: ebb01908a10c9def323e9ccfb970987b4486be8d
+  data.tar.gz: 5d21e110d4e26c82d70c8bc6196a338dd6ae7350
 SHA512:
-  metadata.gz: 5afbf7645596d47577731e8e3898e6c2e8a96e575900d0832798cdd0a9ced60430fc70b3afa2e284b1999d721ab150fe7f2e7ac75f4d14c51ec0b57e46b38ca3
-  data.tar.gz: 860e8de97e4f32469897609fedad639d26864b6503706532f88d2057f122a40bf8d6506f1077adb77ec1f81db00753dde0001fff444a3fab14b1c51379c4f172
+  metadata.gz: 201a5d76be951f6d680701686a954cb3ee0001ace4cf051acec597ef25ec936e1df143ff9c4ba53d8486a9ef79200f0ccf9ce5af4c91a61def61c991ce2e4c74
+  data.tar.gz: d710edc5c7ac865860ab9e8f4d68ae71c51f39d793ac13401e3257867cbe50312b4684ced457c9fd624b92b5bbe07358c135b07e4366be22b53c43918c5d30c0

data/README.md

@@ -39,8 +39,14 @@ your_page.your_element.click
 4. Take a look at the browser window: Marta will ask you to define Your_Page class. You can add variables for the class there.
 5. Add *url* variable with the url of desired page as a default value.
 6. Confirm.
+
+![Steps 4-5-6](readme_files/456steps.png)
+
 7. Then page will be opened and you will be asked about your_element.
 8. Just click the element and confirm the selection.
+
+![Step 8](readme_files/8step.png)
+
 9. Now you can run the test without LEARN parameter and it will work.
 
 **So you are `writing code in pageobject pattern` style.**
@@ -64,11 +70,22 @@ your_page.your_element.click
 
 **Q: What if I can locate element only by dynamic attributes like account_id?**
 
-*A: For example you have a pack of html elements with only one attribute that differs: account_id_attribute. First at the stage of page defining create a class variable account_id = "123". After that you can dynamically change it in your code like*
+*A: For example you want to find an element with the dynamic attribute "itemprop"*
+
+*First at the stage of page defining create a class variable itemprop = "anything".*
+
+![Dynamic attributes - 1](readme_files/itemprop.png)
+
+*After that you can dynamically change it in your code like*
 ```ruby
-your_page.account_id = "456"
+your_page.itemprop # will be "anything" by default
+your_page.itemprop = "about"
 ```
-*And when defining an element you can use it in value field of account_id_attribute like #{@account_id}. See couple examples in example_project (Ruby checkbox, item1 and 2 radio buttons)*
+*And when defining an element you can use it in value field of itemprop like #{@itemprop}.*
+
+![Dynamic attributes - 2](readme_files/itemprop2.png)
+
+*See couple examples in example_project (Ruby checkbox, item1 and 2 radio buttons)*
 
 **Q: I want to use firefox. How could I?**
 
@@ -173,6 +190,8 @@ engine.element(id: 'will_be_located_without_Marta')
 
 *A: At the stage of element defining you can see a button "Find by HTML". That button will open html code of your page in a special blue form. Find the html code of your element and click on it.*
 
+![HTML](readme_files/html.png)
+
 **Q: How can I find not just an element but a Watir::Radio for example?**
 
 *A: Marta automatically performs to_subtype for every element. So if your element is a radio button you will be able to use specific methods.*
@@ -208,6 +227,20 @@ your_page.important_element.click
 
 *A: You can click 'Set custom xpath' at element defining stage and set own xpath. In that case only that xpath will be used to find element. It is planned to add possibility to set custom css, id, name, etc.*
 
+![XPATH](readme_files/xpath.png)
+
+**Q: I cannot see the part of my page under marta's form. How to hide it?**
+
+*A: Use the hide button*
+
+![Hide](readme_files/hide.png)
+
+**Q: At the stage of element defining every click is about selecting element only. Events of the page are not working. What can I do if I want to do some actions at the page before the element selecting?**
+
+*A: There is the "Stop watching" button. It will turn Marta's scripts off until the page is reloaded or until user clicks the "Stop watching" button again.*
+
+![Stop watching button](readme_files/stop.png)
+
 **Q: Why Watir? I want to use pure Selenium Webdriver or Capybara or something!**
 
 *A: I like Watir. And I have no plans so far to implement something else.*
@@ -216,10 +249,6 @@ your_page.important_element.click
 
 *A: Yes it is working with Cucumber and Spinach. I will add some examples later.*
 
-**Q: Where is an example?**
-
-*A: See "example_project" for rspec based example*
-
 **Q: How can I design more object oriented and DRY tests using Marta**
 
 *A: Create wrapping classes. Like*
@@ -247,7 +276,7 @@ g_page.search "I am in love with selenium."
 
 **Q: What else?**
 
-*A: Nothing. Marta is under development. Her version is 0.31831 only. And I am not a professional developer. But I am training her on new tricks.*
+*A: Nothing. Marta is under development. Her version is 0.34054 only. And I am not a professional developer. But I am training her on new tricks.*
 
 ## Internal Design
 

data/lib/marta/data/element.html

@@ -3,10 +3,11 @@
     <div martaclass=marta_smthing martastyle=header>
       <h2 id=marta_main_title martaclass=marta_smthing></h2>
       <div martastyle=icons_holder martaclass=marta_smthing>
+        <input type=button martaclass=marta_smthing martastyle=icon_button id=marta_stop value=&#x1f441; />
         <input type=button martaclass=marta_smthing martastyle=icon_button id=marta_hide value=&#x21E8; />
       </div>
     </div>
-    <div martaclass=marta_smthing martastyle=hint>
+    <div martaclass=marta_smthing martastyle=hint id=marta_hint>
       <p martaclass=marta_smthing>You are about to define some element</p>
       <p martaclass=marta_smthing>CLICK to select element. Do not worry nothing will work</p>
       <p martaclass=marta_smthing>After the click select the attributes of an element and parents</p>

data/lib/marta/data/element.js

@@ -8,6 +8,19 @@ document.getElementById("marta_confirm").onclick = function() {document.marta_en
 document.getElementById("marta_set_by_hand").onclick = function() {document.marta_set_by_hand()};
 document.getElementById("marta_show_html").onclick = function() {document.marta_show_html()};
 document.getElementById("marta_hide").onclick = function() {document.marta_hide()};
+document.getElementById("marta_stop").onclick = function() {document.marta_stop()};
+
+document.marta_stop = function() {
+  if (document.getElementById("marta_magic_div").getAttribute("martastyle") == "off"){
+    document.getElementById("marta_magic_div").setAttribute("martastyle", "at_large");
+    document.getElementById("marta_stop").value = String.fromCharCode(55357)+String.fromCharCode(56385);
+    document.getElementById("marta_hint").innerHTML = "<p>Marta is watching you</p><p>Please click <b>the correct element</b> only!</p>";
+  } else {
+    document.getElementById("marta_stop").value = "--";
+    document.getElementById("marta_magic_div").setAttribute("martastyle", "off");
+    document.getElementById("marta_hint").innerHTML = "<p>Go ahead! Marta is not watching.</p><p>All your actions <b>will not</b> be counted as an element definition</p><p>It will lasts until page will not be refreshed (or new opened).</p><p>Or until you will not switch it off</p>";
+  }
+};
 
 document.marta_magic_click = function(e) {
   if (document.marta_test_xx == 0) {var xx = e.clientX} else {var xx = document.marta_test_xx};

data/lib/marta/data/style.css

@@ -157,6 +157,12 @@ div[martaclass=marta_div] {
     border: 2px solid black;
     outline: 2px solid #bbbbbb;
     background-color: lightgray;
+    position : relative;
+    z-index : 150000;
+    padding: 0;
+    margin: 0px 0px 0px 0px;
+    overflow-y: scroll;
+    max-height: 100%;
 }
 
 div div[martastyle=header] {
@@ -179,6 +185,9 @@ input[martastyle=icon_button] {
     background-color: lightgrey;
     border: 1px solid black;
     visibility: visible;
+    width: 30px;
+    height: 26px;
+    text-align: center;
 }
 
 div[martaclass=marta_div][martastyle=hidden] *:not([martastyle=icon_button]) {
@@ -189,19 +198,13 @@ div[martaclass=marta_div][martastyle=hidden]{
   height: 0px;
   outline: none;
   border: none;
+  overflow-y: initial;
 }
 
 h2#marta_main_title {
     font-size: 20px;
 }
 
-div[martaclass=marta_div] {
-  position : relative;
-  z-index : 150000;
-  padding: 0;
-  margin: 0px 0px 0px 0px;
-}
-
 div[martastyle=hint] {
     background-color: #F6F5D7;
     color: black;

data/lib/marta/options_and_paths.rb

@@ -91,8 +91,10 @@ module Marta
 
       # Marta is setting engine by pretty comlex rules
       def self.set_engine(value)
-        if (engine.class == Watir::Browser) and (value.class == Watir::Browser)
-          engine.close
+        if (engine.class == Watir::Browser) and
+           (value.class == Watir::Browser) and
+           (engine != value)
+             engine.close if engine.exists?
         end
         iframe_locate
         @@engine = parameter_set(@@engine, value, nil)

data/lib/marta/version.rb

@@ -1,4 +1,4 @@
 module Marta
-  VERSION = "0.31831"
+  VERSION = "0.34054"
   NAME = "marta"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: marta
 version: !ruby/object:Gem::Version
-  version: '0.31831'
+  version: '0.34054'
 platform: ruby
 authors:
 - Sergei Seleznev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-09-10 00:00:00.000000000 Z
+date: 2017-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -143,6 +143,14 @@ files:
 - lib/marta/version.rb
 - lib/marta/x_path.rb
 - marta.gemspec
+- readme_files/456steps.png
+- readme_files/8step.png
+- readme_files/hide.png
+- readme_files/html.png
+- readme_files/itemprop.png
+- readme_files/itemprop2.png
+- readme_files/stop.png
+- readme_files/xpath.png
 homepage: https://github.com/sseleznevqa/marta
 licenses:
 - MIT