The root package of Shakespeare contains all classes needed to implement the basic Screenplay
+ concepts:
+
+
+ Actor,
+ Ability,
+ Task, and
+ Question.
The reporting package contains classes and interfaces for reporting what an Actor does:
+
+
+ Reporter is the main interface,
+ LoggingReporter is the interface for reporters
+ that generate logs,
+ Slf4jReporter is its default implementation,
+ FileReporter can be extended to generate report
+ files.
+Starting from the Overview page, you can browse the documentation using the links in each page, and in the navigation bar at the top of each page. The Index and Search box allow you to navigate to specific declarations and summary pages, including: All Packages, All Classes and Interfaces
+
+
Search
+
You can search for definitions of modules, packages, types, fields, methods, system properties and other terms defined in the API, using some or all of the name, optionally using "camelCase" abbreviations. For example:
+
+
j.l.obj will match "java.lang.Object"
+
InpStr will match "java.io.InputStream"
+
HM.cK will match "java.util.HashMap.containsKey(Object)"
+The following sections describe the different kinds of pages in this collection.
+
+
Overview
+
The Overview page is the front page of this API document and provides a list of all packages with a summary for each. This page can also contain an overall description of the set of packages.
+
+
+
Package
+
Each package has a page that contains a list of its classes and interfaces, with a summary for each. These pages may contain the following categories:
+
+
Interfaces
+
Classes
+
Enum Classes
+
Exceptions
+
Errors
+
Annotation Interfaces
+
+
+
+
Class or Interface
+
Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a declaration and description, member summary tables, and detailed member descriptions. Entries in each of these sections are omitted if they are empty or not applicable.
+
+
Class Inheritance Diagram
+
Direct Subclasses
+
All Known Subinterfaces
+
All Known Implementing Classes
+
Class or Interface Declaration
+
Class or Interface Description
+
+
+
+
Nested Class Summary
+
Enum Constant Summary
+
Field Summary
+
Property Summary
+
Constructor Summary
+
Method Summary
+
Required Element Summary
+
Optional Element Summary
+
+
+
+
Enum Constant Details
+
Field Details
+
Property Details
+
Constructor Details
+
Method Details
+
Element Details
+
+
Note: Annotation interfaces have required and optional elements, but not methods. Only enum classes have enum constants. The components of a record class are displayed as part of the declaration of the record class. Properties are a feature of JavaFX.
+
The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.
+
+
+
Other Files
+
Packages and modules may contain pages with additional information related to the declarations nearby.
+
+
+
Tree (Class Hierarchy)
+
There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. Classes are organized by inheritance structure starting with java.lang.Object. Interfaces do not inherit from java.lang.Object.
+
+
When viewing the Overview page, clicking on TREE displays the hierarchy for all packages.
+
When viewing a particular package, class or interface page, clicking on TREE displays the hierarchy for only that package.
+
+
+
+
Serialized Form
+
Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to those who implement rather than use the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking "Serialized Form" in the "See Also" section of the class description.
+
+
+
All Packages
+
The All Packages page contains an alphabetic index of all packages contained in the documentation.
+
+
+
All Classes and Interfaces
+
The All Classes and Interfaces page contains an alphabetic index of all classes and interfaces contained in the documentation, including annotation interfaces, enum classes, and record classes.
+
+
+
Index
+
The Index contains an alphabetic index of all classes, interfaces, constructors, methods, and fields in the documentation, as well as summary pages such as All Packages, All Classes and Interfaces.
+
+
+
+This help file applies to API documentation generated by the standard doclet.
+
The root package of Shakespeare contains all classes needed to implement the basic Screenplay
+ concepts:
+
+
+ Actor,
+ Ability,
+ Task, and
+ Question.
The reporting package contains classes and interfaces for reporting what an Actor does:
+
+
+ Reporter is the main interface,
+ LoggingReporter is the interface for reporters
+ that generate logs,
+ Slf4jReporter is its default implementation,
+ FileReporter can be extended to generate report
+ files.
The root package of Shakespeare contains all classes needed to implement the basic Screenplay
+ concepts:
+
+
+ Actor,
+ Ability,
+ Task, and
+ Question.
The reporting package contains classes and interfaces for reporting what an Actor does:
+
+
+ Reporter is the main interface,
+ LoggingReporter is the interface for reporters
+ that generate logs,
+ Slf4jReporter is its default implementation,
+ FileReporter can be extended to generate report
+ files.
+
+
+
+
+
+
+
+
diff --git a/docs/v0.8.2/javadoc/core/jquery-ui.overrides.css b/docs/v0.8.2/javadoc/core/jquery-ui.overrides.css
new file mode 100644
index 00000000..facf852c
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/jquery-ui.overrides.css
@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2020, 2022, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+.ui-state-active,
+.ui-widget-content .ui-state-active,
+.ui-widget-header .ui-state-active,
+a.ui-button:active,
+.ui-button:active,
+.ui-button.ui-state-active:hover {
+ /* Overrides the color of selection used in jQuery UI */
+ background: #F8981D;
+ border: 1px solid #F8981D;
+}
diff --git a/docs/v0.8.2/javadoc/core/legal/ADDITIONAL_LICENSE_INFO b/docs/v0.8.2/javadoc/core/legal/ADDITIONAL_LICENSE_INFO
new file mode 100644
index 00000000..ff700cd0
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/legal/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1,37 @@
+ ADDITIONAL INFORMATION ABOUT LICENSING
+
+Certain files distributed by Oracle America, Inc. and/or its affiliates are
+subject to the following clarification and special exception to the GPLv2,
+based on the GNU Project exception for its Classpath libraries, known as the
+GNU Classpath Exception.
+
+Note that Oracle includes multiple, independent programs in this software
+package. Some of those programs are provided under licenses deemed
+incompatible with the GPLv2 by the Free Software Foundation and others.
+For example, the package includes programs licensed under the Apache
+License, Version 2.0 and may include FreeType. Such programs are licensed
+to you under their original licenses.
+
+Oracle facilitates your further distribution of this package by adding the
+Classpath Exception to the necessary parts of its GPLv2 code, which permits
+you to use that code in combination with other independent modules not
+licensed under the GPLv2. However, note that this would not permit you to
+commingle code under an incompatible license with Oracle's GPLv2 licensed
+code by, for example, cutting and pasting such code into a file also
+containing Oracle's GPLv2 licensed code and then distributing the result.
+
+Additionally, if you were to remove the Classpath Exception from any of the
+files to which it applies and distribute the result, you would likely be
+required to license some or all of the other code in that distribution under
+the GPLv2 as well, and since the GPLv2 is incompatible with the license terms
+of some items included in the distribution by Oracle, removing the Classpath
+Exception could therefore effectively compromise your ability to further
+distribute the package.
+
+Failing to distribute notices associated with some files may also create
+unexpected legal consequences.
+
+Proceed with caution and we recommend that you obtain the advice of a lawyer
+skilled in open source matters before removing the Classpath Exception or
+making modifications to this package which may subsequently be redistributed
+and/or involve the use of third party software.
diff --git a/docs/v0.8.2/javadoc/core/legal/ASSEMBLY_EXCEPTION b/docs/v0.8.2/javadoc/core/legal/ASSEMBLY_EXCEPTION
new file mode 100644
index 00000000..065b8d90
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/legal/ASSEMBLY_EXCEPTION
@@ -0,0 +1,27 @@
+
+OPENJDK ASSEMBLY EXCEPTION
+
+The OpenJDK source code made available by Oracle America, Inc. (Oracle) at
+openjdk.java.net ("OpenJDK Code") is distributed under the terms of the GNU
+General Public License version 2
+only ("GPL2"), with the following clarification and special exception.
+
+ Linking this OpenJDK Code statically or dynamically with other code
+ is making a combined work based on this library. Thus, the terms
+ and conditions of GPL2 cover the whole combination.
+
+ As a special exception, Oracle gives you permission to link this
+ OpenJDK Code with certain code licensed by Oracle as indicated at
+ http://openjdk.java.net/legal/exception-modules-2007-05-08.html
+ ("Designated Exception Modules") to produce an executable,
+ regardless of the license terms of the Designated Exception Modules,
+ and to copy and distribute the resulting executable under GPL2,
+ provided that the Designated Exception Modules continue to be
+ governed by the licenses under which they were offered by Oracle.
+
+As such, it allows licensees and sublicensees of Oracle's GPL2 OpenJDK Code
+to build an executable that includes those portions of necessary code that
+Oracle could not provide under GPL2 (or that Oracle has provided under GPL2
+with the Classpath exception). If you modify or add to the OpenJDK code,
+that new GPL2 code may still be combined with Designated Exception Modules
+if the new code is made subject to this exception by its copyright holder.
diff --git a/docs/v0.8.2/javadoc/core/legal/LICENSE b/docs/v0.8.2/javadoc/core/legal/LICENSE
new file mode 100644
index 00000000..8b400c7a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/legal/LICENSE
@@ -0,0 +1,347 @@
+The GNU General Public License (GPL)
+
+Version 2, June 1991
+
+Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+Everyone is permitted to copy and distribute verbatim copies of this license
+document, but changing it is not allowed.
+
+Preamble
+
+The licenses for most software are designed to take away your freedom to share
+and change it. By contrast, the GNU General Public License is intended to
+guarantee your freedom to share and change free software--to make sure the
+software is free for all its users. This General Public License applies to
+most of the Free Software Foundation's software and to any other program whose
+authors commit to using it. (Some other Free Software Foundation software is
+covered by the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our
+General Public Licenses are designed to make sure that you have the freedom to
+distribute copies of free software (and charge for this service if you wish),
+that you receive source code or can get it if you want it, that you can change
+the software or use pieces of it in new free programs; and that you know you
+can do these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny
+you these rights or to ask you to surrender the rights. These restrictions
+translate to certain responsibilities for you if you distribute copies of the
+software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for
+a fee, you must give the recipients all the rights that you have. You must
+make sure that they, too, receive or can get the source code. And you must
+show them these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2)
+offer you this license which gives you legal permission to copy, distribute
+and/or modify the software.
+
+Also, for each author's protection and ours, we want to make certain that
+everyone understands that there is no warranty for this free software. If the
+software is modified by someone else and passed on, we want its recipients to
+know that what they have is not the original, so that any problems introduced
+by others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We
+wish to avoid the danger that redistributors of a free program will
+individually obtain patent licenses, in effect making the program proprietary.
+To prevent this, we have made it clear that any patent must be licensed for
+everyone's free use or not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification
+follow.
+
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+0. This License applies to any program or other work which contains a notice
+placed by the copyright holder saying it may be distributed under the terms of
+this General Public License. The "Program", below, refers to any such program
+or work, and a "work based on the Program" means either the Program or any
+derivative work under copyright law: that is to say, a work containing the
+Program or a portion of it, either verbatim or with modifications and/or
+translated into another language. (Hereinafter, translation is included
+without limitation in the term "modification".) Each licensee is addressed as
+"you".
+
+Activities other than copying, distribution and modification are not covered by
+this License; they are outside its scope. The act of running the Program is
+not restricted, and the output from the Program is covered only if its contents
+constitute a work based on the Program (independent of having been made by
+running the Program). Whether that is true depends on what the Program does.
+
+1. You may copy and distribute verbatim copies of the Program's source code as
+you receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice and
+disclaimer of warranty; keep intact all the notices that refer to this License
+and to the absence of any warranty; and give any other recipients of the
+Program a copy of this License along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and you may
+at your option offer warranty protection in exchange for a fee.
+
+2. You may modify your copy or copies of the Program or any portion of it, thus
+forming a work based on the Program, and copy and distribute such modifications
+or work under the terms of Section 1 above, provided that you also meet all of
+these conditions:
+
+ a) You must cause the modified files to carry prominent notices stating
+ that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in whole or
+ in part contains or is derived from the Program or any part thereof, to be
+ licensed as a whole at no charge to all third parties under the terms of
+ this License.
+
+ c) If the modified program normally reads commands interactively when run,
+ you must cause it, when started running for such interactive use in the
+ most ordinary way, to print or display an announcement including an
+ appropriate copyright notice and a notice that there is no warranty (or
+ else, saying that you provide a warranty) and that users may redistribute
+ the program under these conditions, and telling the user how to view a copy
+ of this License. (Exception: if the Program itself is interactive but does
+ not normally print such an announcement, your work based on the Program is
+ not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If identifiable
+sections of that work are not derived from the Program, and can be reasonably
+considered independent and separate works in themselves, then this License, and
+its terms, do not apply to those sections when you distribute them as separate
+works. But when you distribute the same sections as part of a whole which is a
+work based on the Program, the distribution of the whole must be on the terms
+of this License, whose permissions for other licensees extend to the entire
+whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest your
+rights to work written entirely by you; rather, the intent is to exercise the
+right to control the distribution of derivative or collective works based on
+the Program.
+
+In addition, mere aggregation of another work not based on the Program with the
+Program (or with a work based on the Program) on a volume of a storage or
+distribution medium does not bring the other work under the scope of this
+License.
+
+3. You may copy and distribute the Program (or a work based on it, under
+Section 2) in object code or executable form under the terms of Sections 1 and
+2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable source
+ code, which must be distributed under the terms of Sections 1 and 2 above
+ on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three years, to
+ give any third party, for a charge no more than your cost of physically
+ performing source distribution, a complete machine-readable copy of the
+ corresponding source code, to be distributed under the terms of Sections 1
+ and 2 above on a medium customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer to
+ distribute corresponding source code. (This alternative is allowed only
+ for noncommercial distribution and only if you received the program in
+ object code or executable form with such an offer, in accord with
+ Subsection b above.)
+
+The source code for a work means the preferred form of the work for making
+modifications to it. For an executable work, complete source code means all
+the source code for all modules it contains, plus any associated interface
+definition files, plus the scripts used to control compilation and installation
+of the executable. However, as a special exception, the source code
+distributed need not include anything that is normally distributed (in either
+source or binary form) with the major components (compiler, kernel, and so on)
+of the operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the source
+code from the same place counts as distribution of the source code, even though
+third parties are not compelled to copy the source along with the object code.
+
+4. You may not copy, modify, sublicense, or distribute the Program except as
+expressly provided under this License. Any attempt otherwise to copy, modify,
+sublicense or distribute the Program is void, and will automatically terminate
+your rights under this License. However, parties who have received copies, or
+rights, from you under this License will not have their licenses terminated so
+long as such parties remain in full compliance.
+
+5. You are not required to accept this License, since you have not signed it.
+However, nothing else grants you permission to modify or distribute the Program
+or its derivative works. These actions are prohibited by law if you do not
+accept this License. Therefore, by modifying or distributing the Program (or
+any work based on the Program), you indicate your acceptance of this License to
+do so, and all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+6. Each time you redistribute the Program (or any work based on the Program),
+the recipient automatically receives a license from the original licensor to
+copy, distribute or modify the Program subject to these terms and conditions.
+You may not impose any further restrictions on the recipients' exercise of the
+rights granted herein. You are not responsible for enforcing compliance by
+third parties to this License.
+
+7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues), conditions
+are imposed on you (whether by court order, agreement or otherwise) that
+contradict the conditions of this License, they do not excuse you from the
+conditions of this License. If you cannot distribute so as to satisfy
+simultaneously your obligations under this License and any other pertinent
+obligations, then as a consequence you may not distribute the Program at all.
+For example, if a patent license would not permit royalty-free redistribution
+of the Program by all those who receive copies directly or indirectly through
+you, then the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply and
+the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any patents or
+other property right claims or to contest validity of any such claims; this
+section has the sole purpose of protecting the integrity of the free software
+distribution system, which is implemented by public license practices. Many
+people have made generous contributions to the wide range of software
+distributed through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing to
+distribute software through any other system and a licensee cannot impose that
+choice.
+
+This section is intended to make thoroughly clear what is believed to be a
+consequence of the rest of this License.
+
+8. If the distribution and/or use of the Program is restricted in certain
+countries either by patents or by copyrighted interfaces, the original
+copyright holder who places the Program under this License may add an explicit
+geographical distribution limitation excluding those countries, so that
+distribution is permitted only in or among countries not thus excluded. In
+such case, this License incorporates the limitation as if written in the body
+of this License.
+
+9. The Free Software Foundation may publish revised and/or new versions of the
+General Public License from time to time. Such new versions will be similar in
+spirit to the present version, but may differ in detail to address new problems
+or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any later
+version", you have the option of following the terms and conditions either of
+that version or of any later version published by the Free Software Foundation.
+If the Program does not specify a version number of this License, you may
+choose any version ever published by the Free Software Foundation.
+
+10. If you wish to incorporate parts of the Program into other free programs
+whose distribution conditions are different, write to the author to ask for
+permission. For software which is copyrighted by the Free Software Foundation,
+write to the Free Software Foundation; we sometimes make exceptions for this.
+Our decision will be guided by the two goals of preserving the free status of
+all derivatives of our free software and of promoting the sharing and reuse of
+software generally.
+
+NO WARRANTY
+
+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
+THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE
+STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE
+PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
+YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
+ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE
+PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
+INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
+BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER
+OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible
+use to the public, the best way to achieve this is to make it free software
+which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach
+them to the start of each source file to most effectively convey the exclusion
+of warranty; and each file should have at least the "copyright" line and a
+pointer to where the full notice is found.
+
+ One line to give the program's name and a brief idea of what it does.
+
+ Copyright (C)
+
+ This program is free software; you can redistribute it and/or modify it
+ under the terms of the GNU General Public License as published by the Free
+ Software Foundation; either version 2 of the License, or (at your option)
+ any later version.
+
+ This program is distributed in the hope that it will be useful, but WITHOUT
+ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ more details.
+
+ You should have received a copy of the GNU General Public License along
+ with this program; if not, write to the Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this when it
+starts in an interactive mode:
+
+ Gnomovision version 69, Copyright (C) year name of author Gnomovision comes
+ with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free
+ software, and you are welcome to redistribute it under certain conditions;
+ type 'show c' for details.
+
+The hypothetical commands 'show w' and 'show c' should show the appropriate
+parts of the General Public License. Of course, the commands you use may be
+called something other than 'show w' and 'show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your school,
+if any, to sign a "copyright disclaimer" for the program, if necessary. Here
+is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+ 'Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+ signature of Ty Coon, 1 April 1989
+
+ Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Library General Public
+License instead of this License.
+
+
+"CLASSPATH" EXCEPTION TO THE GPL
+
+Certain source files distributed by Oracle America and/or its affiliates are
+subject to the following clarification and special exception to the GPL, but
+only where Oracle has expressly included in the particular source file's header
+the words "Oracle designates this particular file as subject to the "Classpath"
+exception as provided by Oracle in the LICENSE file that accompanied this code."
+
+ Linking this library statically or dynamically with other modules is making
+ a combined work based on this library. Thus, the terms and conditions of
+ the GNU General Public License cover the whole combination.
+
+ As a special exception, the copyright holders of this library give you
+ permission to link this library with independent modules to produce an
+ executable, regardless of the license terms of these independent modules,
+ and to copy and distribute the resulting executable under terms of your
+ choice, provided that you also meet, for each linked independent module,
+ the terms and conditions of the license of that module. An independent
+ module is a module which is not derived from or based on this library. If
+ you modify this library, you may extend this exception to your version of
+ the library, but you are not obligated to do so. If you do not wish to do
+ so, delete this exception statement from your version.
diff --git a/docs/v0.8.2/javadoc/core/legal/jquery.md b/docs/v0.8.2/javadoc/core/legal/jquery.md
new file mode 100644
index 00000000..a763ec6f
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/legal/jquery.md
@@ -0,0 +1,26 @@
+## jQuery v3.7.1
+
+### jQuery License
+```
+jQuery v 3.7.1
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
+
+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.
+```
diff --git a/docs/v0.8.2/javadoc/core/legal/jqueryUI.md b/docs/v0.8.2/javadoc/core/legal/jqueryUI.md
new file mode 100644
index 00000000..8bda9d7a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/legal/jqueryUI.md
@@ -0,0 +1,49 @@
+## jQuery UI v1.13.2
+
+### jQuery UI License
+```
+Copyright jQuery Foundation and other contributors, https://jquery.org/
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/jquery/jquery-ui
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+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.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code contained within the demos directory.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+All files located in the node_modules and external directories are
+externally maintained libraries used by this software which have their
+own licenses; we recommend you read them, as their terms may differ from
+the terms above.
+
+```
diff --git a/docs/v0.8.2/javadoc/core/member-search-index.js b/docs/v0.8.2/javadoc/core/member-search-index.js
new file mode 100644
index 00000000..a856029a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/member-search-index.js
@@ -0,0 +1 @@
+memberSearchIndex = [{"p":"org.shakespeareframework","c":"RetryableQuestion","l":"acceptable(A)"},{"p":"org.shakespeareframework","c":"Actor","l":"Actor()","u":"%3Cinit%3E()"},{"p":"org.shakespeareframework","c":"Actor","l":"Actor(String)","u":"%3Cinit%3E(java.lang.String)"},{"p":"org.shakespeareframework","c":"Question","l":"answerAs(Actor)","u":"answerAs(org.shakespeareframework.Actor)"},{"p":"org.shakespeareframework","c":"Actor","l":"can(Ability...)","u":"can(org.shakespeareframework.Ability...)"},{"p":"org.shakespeareframework","c":"Actor","l":"checks(Question)","u":"checks(org.shakespeareframework.Question)"},{"p":"org.shakespeareframework","c":"Actor","l":"checks(RetryableQuestion)","u":"checks(org.shakespeareframework.RetryableQuestion)"},{"p":"org.shakespeareframework","c":"Retryable","l":"DEFAULT_TIMEOUT"},{"p":"org.shakespeareframework","c":"Actor","l":"does(RetryableTask)","u":"does(org.shakespeareframework.RetryableTask)"},{"p":"org.shakespeareframework","c":"Actor","l":"does(Task)","u":"does(org.shakespeareframework.Task)"},{"p":"org.shakespeareframework","c":"Actor","l":"equals(Object)","u":"equals(java.lang.Object)"},{"p":"org.shakespeareframework.reporting","c":"FileReporter.ReportType","l":"FAILURE"},{"p":"org.shakespeareframework.reporting","c":"QuestionReporter","l":"failure(Actor, Question, Exception)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Question,java.lang.Exception)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"failure(Actor, Question, Exception)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Question,java.lang.Exception)"},{"p":"org.shakespeareframework.reporting","c":"QuestionReporter","l":"failure(Actor, Question, A)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Question,A)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"failure(Actor, Question, A)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Question,A)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"failure(Actor, Task, Exception)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Task,java.lang.Exception)"},{"p":"org.shakespeareframework.reporting","c":"TaskReporter","l":"failure(Actor, Task, Exception)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Task,java.lang.Exception)"},{"p":"org.shakespeareframework.reporting","c":"FileReporter","l":"FileReporter(Path)","u":"%3Cinit%3E(java.nio.file.Path)"},{"p":"org.shakespeareframework","c":"RetryableTask","l":"getAcknowledgedExceptions()"},{"p":"org.shakespeareframework","c":"RetryableQuestion","l":"getIgnoredExceptions()"},{"p":"org.shakespeareframework","c":"Retryable","l":"getInterval()"},{"p":"org.shakespeareframework","c":"Actor","l":"getName()"},{"p":"org.shakespeareframework","c":"Retryable","l":"getTimeout()"},{"p":"org.shakespeareframework","c":"Actor","l":"hashCode()"},{"p":"org.shakespeareframework","c":"Actor","l":"informs(Reporter...)","u":"informs(org.shakespeareframework.reporting.Reporter...)"},{"p":"org.shakespeareframework","c":"RetryableTask","l":"isAcknowledgedException(Exception)","u":"isAcknowledgedException(java.lang.Exception)"},{"p":"org.shakespeareframework","c":"RetryableQuestion","l":"isIgnoredException(Exception)","u":"isIgnoredException(java.lang.Exception)"},{"p":"org.shakespeareframework","c":"Actor","l":"learns(Fact...)","u":"learns(org.shakespeareframework.Fact...)"},{"p":"org.shakespeareframework","c":"MissingAbilityException","l":"MissingAbilityException(Actor, Class)","u":"%3Cinit%3E(org.shakespeareframework.Actor,java.lang.Class)"},{"p":"org.shakespeareframework","c":"MissingFactException","l":"MissingFactException(Actor, Class)","u":"%3Cinit%3E(org.shakespeareframework.Actor,java.lang.Class)"},{"p":"org.shakespeareframework","c":"Task","l":"performAs(Actor)","u":"performAs(org.shakespeareframework.Actor)"},{"p":"org.shakespeareframework","c":"Actor","l":"remembers(Class)","u":"remembers(java.lang.Class)"},{"p":"org.shakespeareframework.reporting","c":"FileReporter.ReportType","l":"RETRY"},{"p":"org.shakespeareframework.reporting","c":"QuestionReporter","l":"retry(Actor, RetryableQuestion, Exception)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableQuestion,java.lang.Exception)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"retry(Actor, RetryableQuestion, Exception)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableQuestion,java.lang.Exception)"},{"p":"org.shakespeareframework.reporting","c":"QuestionReporter","l":"retry(Actor, RetryableQuestion, A)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableQuestion,A)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"retry(Actor, RetryableQuestion, A)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableQuestion,A)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"retry(Actor, RetryableTask, Exception)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableTask,java.lang.Exception)"},{"p":"org.shakespeareframework.reporting","c":"TaskReporter","l":"retry(Actor, RetryableTask, Exception)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableTask,java.lang.Exception)"},{"p":"org.shakespeareframework","c":"RetryInterruptedException","l":"RetryInterruptedException(Actor, Retryable, InterruptedException)","u":"%3Cinit%3E(org.shakespeareframework.Actor,org.shakespeareframework.Retryable,java.lang.InterruptedException)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"Slf4jReporter()","u":"%3Cinit%3E()"},{"p":"org.shakespeareframework.reporting","c":"FileReporter.ReportType","l":"START"},{"p":"org.shakespeareframework.reporting","c":"QuestionReporter","l":"start(Actor, Question)","u":"start(org.shakespeareframework.Actor,org.shakespeareframework.Question)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"start(Actor, Question)","u":"start(org.shakespeareframework.Actor,org.shakespeareframework.Question)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"start(Actor, Task)","u":"start(org.shakespeareframework.Actor,org.shakespeareframework.Task)"},{"p":"org.shakespeareframework.reporting","c":"TaskReporter","l":"start(Actor, Task)","u":"start(org.shakespeareframework.Actor,org.shakespeareframework.Task)"},{"p":"org.shakespeareframework.reporting","c":"FileReporter.ReportType","l":"SUCCESS"},{"p":"org.shakespeareframework.reporting","c":"QuestionReporter","l":"success(Actor, Question, A)","u":"success(org.shakespeareframework.Actor,org.shakespeareframework.Question,A)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"success(Actor, Question, A)","u":"success(org.shakespeareframework.Actor,org.shakespeareframework.Question,A)"},{"p":"org.shakespeareframework.reporting","c":"Slf4jReporter","l":"success(Actor, Task)","u":"success(org.shakespeareframework.Actor,org.shakespeareframework.Task)"},{"p":"org.shakespeareframework.reporting","c":"TaskReporter","l":"success(Actor, Task)","u":"success(org.shakespeareframework.Actor,org.shakespeareframework.Task)"},{"p":"org.shakespeareframework","c":"TimeoutException","l":"TimeoutException(Actor, Retryable, Throwable)","u":"%3Cinit%3E(org.shakespeareframework.Actor,org.shakespeareframework.Retryable,java.lang.Throwable)"},{"p":"org.shakespeareframework","c":"Actor","l":"toString()"},{"p":"org.shakespeareframework.reporting","c":"FileReporter.ReportType","l":"toString()"},{"p":"org.shakespeareframework","c":"Actor","l":"uses(Class)","u":"uses(java.lang.Class)"},{"p":"org.shakespeareframework.reporting","c":"FileReporter.ReportType","l":"valueOf(String)","u":"valueOf(java.lang.String)"},{"p":"org.shakespeareframework.reporting","c":"FileReporter.ReportType","l":"values()"},{"p":"org.shakespeareframework.reporting","c":"FileReporter","l":"writeReport(Actor, FileReporter.ReportType, Object, String, byte[])","u":"writeReport(org.shakespeareframework.Actor,org.shakespeareframework.reporting.FileReporter.ReportType,java.lang.Object,java.lang.String,byte[])"},{"p":"org.shakespeareframework.reporting","c":"WriteReportFileException","l":"WriteReportFileException(String, IOException)","u":"%3Cinit%3E(java.lang.String,java.io.IOException)"}];updateSearchResults();
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/core/module-search-index.js b/docs/v0.8.2/javadoc/core/module-search-index.js
new file mode 100644
index 00000000..0d59754f
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/module-search-index.js
@@ -0,0 +1 @@
+moduleSearchIndex = [];updateSearchResults();
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/core/org/shakespeareframework/Ability.html b/docs/v0.8.2/javadoc/core/org/shakespeareframework/Ability.html
new file mode 100644
index 00000000..22b3799e
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/org/shakespeareframework/Ability.html
@@ -0,0 +1,79 @@
+
+
+
+
+Ability (core 0.8.2 API)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
The reporting package contains classes and interfaces for reporting what an Actor does:
+
+
+ Reporter is the main interface,
+ LoggingReporter is the interface for reporters
+ that generate logs,
+ Slf4jReporter is its default implementation,
+ FileReporter can be extended to generate report
+ files.
Returns the enum constant of this class with the specified name.
+The string must match exactly an identifier used to declare an
+enum constant in this class. (Extraneous whitespace characters are
+not permitted.)
+
+
Parameters:
+
name - the name of the enum constant to be returned.
@NullMarked
+public abstract class FileReporter
+extends Object
+implements Reporter
+
Reporter providing a method to write report files. Files will be placed under the reportsPath and named counter-actor-reportType-
+ task|question.fileNameExtension. E.g.: 003-regina-retry-is_logged_in.png.
The root package of Shakespeare contains all classes needed to implement the basic Screenplay
+ concepts:
+
+
+ Actor,
+ Ability,
+ Task, and
+ Question.
").text(e.label)).appendTo(t)},_move:function(t,e){if(this.menu.element.is(":visible"))return this.menu.isFirstItem()&&/^previous/.test(t)||this.menu.isLastItem()&&/^next/.test(t)?(this.isMultiLine||this._value(this.term),void this.menu.blur()):void this.menu[t](e);this.search(null,e)},widget:function(){return this.menu.element},_value:function(){return this.valueMethod.apply(this.element,arguments)},_keyEvent:function(t,e){this.isMultiLine&&!this.menu.element.is(":visible")||(this._move(t,e),e.preventDefault())},_isContentEditable:function(t){if(!t.length)return!1;var e=t.prop("contentEditable");return"inherit"===e?this._isContentEditable(t.parent()):"true"===e}}),x.extend(x.ui.autocomplete,{escapeRegex:function(t){return t.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&")},filter:function(t,e){var i=new RegExp(x.ui.autocomplete.escapeRegex(e),"i");return x.grep(t,function(t){return i.test(t.label||t.value||t)})}}),x.widget("ui.autocomplete",x.ui.autocomplete,{options:{messages:{noResults:"No search results.",results:function(t){return t+(1").text(e))},100))}});x.ui.autocomplete});
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/core/script.js b/docs/v0.8.2/javadoc/core/script.js
new file mode 100644
index 00000000..73cd8faa
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/script.js
@@ -0,0 +1,132 @@
+/*
+ * Copyright (c) 2013, 2020, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+var moduleSearchIndex;
+var packageSearchIndex;
+var typeSearchIndex;
+var memberSearchIndex;
+var tagSearchIndex;
+function loadScripts(doc, tag) {
+ createElem(doc, tag, 'search.js');
+
+ createElem(doc, tag, 'module-search-index.js');
+ createElem(doc, tag, 'package-search-index.js');
+ createElem(doc, tag, 'type-search-index.js');
+ createElem(doc, tag, 'member-search-index.js');
+ createElem(doc, tag, 'tag-search-index.js');
+}
+
+function createElem(doc, tag, path) {
+ var script = doc.createElement(tag);
+ var scriptElement = doc.getElementsByTagName(tag)[0];
+ script.src = pathtoroot + path;
+ scriptElement.parentNode.insertBefore(script, scriptElement);
+}
+
+function show(tableId, selected, columns) {
+ if (tableId !== selected) {
+ document.querySelectorAll('div.' + tableId + ':not(.' + selected + ')')
+ .forEach(function(elem) {
+ elem.style.display = 'none';
+ });
+ }
+ document.querySelectorAll('div.' + selected)
+ .forEach(function(elem, index) {
+ elem.style.display = '';
+ var isEvenRow = index % (columns * 2) < columns;
+ elem.classList.remove(isEvenRow ? oddRowColor : evenRowColor);
+ elem.classList.add(isEvenRow ? evenRowColor : oddRowColor);
+ });
+ updateTabs(tableId, selected);
+}
+
+function updateTabs(tableId, selected) {
+ document.getElementById(tableId + '.tabpanel')
+ .setAttribute('aria-labelledby', selected);
+ document.querySelectorAll('button[id^="' + tableId + '"]')
+ .forEach(function(tab, index) {
+ if (selected === tab.id || (tableId === selected && index === 0)) {
+ tab.className = activeTableTab;
+ tab.setAttribute('aria-selected', true);
+ tab.setAttribute('tabindex',0);
+ } else {
+ tab.className = tableTab;
+ tab.setAttribute('aria-selected', false);
+ tab.setAttribute('tabindex',-1);
+ }
+ });
+}
+
+function switchTab(e) {
+ var selected = document.querySelector('[aria-selected=true]');
+ if (selected) {
+ if ((e.keyCode === 37 || e.keyCode === 38) && selected.previousSibling) {
+ // left or up arrow key pressed: move focus to previous tab
+ selected.previousSibling.click();
+ selected.previousSibling.focus();
+ e.preventDefault();
+ } else if ((e.keyCode === 39 || e.keyCode === 40) && selected.nextSibling) {
+ // right or down arrow key pressed: move focus to next tab
+ selected.nextSibling.click();
+ selected.nextSibling.focus();
+ e.preventDefault();
+ }
+ }
+}
+
+var updateSearchResults = function() {};
+
+function indexFilesLoaded() {
+ return moduleSearchIndex
+ && packageSearchIndex
+ && typeSearchIndex
+ && memberSearchIndex
+ && tagSearchIndex;
+}
+
+// Workaround for scroll position not being included in browser history (8249133)
+document.addEventListener("DOMContentLoaded", function(e) {
+ var contentDiv = document.querySelector("div.flex-content");
+ window.addEventListener("popstate", function(e) {
+ if (e.state !== null) {
+ contentDiv.scrollTop = e.state;
+ }
+ });
+ window.addEventListener("hashchange", function(e) {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ });
+ contentDiv.addEventListener("scroll", function(e) {
+ var timeoutID;
+ if (!timeoutID) {
+ timeoutID = setTimeout(function() {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ timeoutID = null;
+ }, 100);
+ }
+ });
+ if (!location.hash) {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ }
+});
diff --git a/docs/v0.8.2/javadoc/core/search.js b/docs/v0.8.2/javadoc/core/search.js
new file mode 100644
index 00000000..db3b2f4a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/core/search.js
@@ -0,0 +1,354 @@
+/*
+ * Copyright (c) 2015, 2020, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+var noResult = {l: "No results found"};
+var loading = {l: "Loading search index..."};
+var catModules = "Modules";
+var catPackages = "Packages";
+var catTypes = "Classes and Interfaces";
+var catMembers = "Members";
+var catSearchTags = "Search Tags";
+var highlight = "$&";
+var searchPattern = "";
+var fallbackPattern = "";
+var RANKING_THRESHOLD = 2;
+var NO_MATCH = 0xffff;
+var MIN_RESULTS = 3;
+var MAX_RESULTS = 500;
+var UNNAMED = "";
+function escapeHtml(str) {
+ return str.replace(//g, ">");
+}
+function getHighlightedText(item, matcher, fallbackMatcher) {
+ var escapedItem = escapeHtml(item);
+ var highlighted = escapedItem.replace(matcher, highlight);
+ if (highlighted === escapedItem) {
+ highlighted = escapedItem.replace(fallbackMatcher, highlight)
+ }
+ return highlighted;
+}
+function getURLPrefix(ui) {
+ var urlPrefix="";
+ var slash = "/";
+ if (ui.item.category === catModules) {
+ return ui.item.l + slash;
+ } else if (ui.item.category === catPackages && ui.item.m) {
+ return ui.item.m + slash;
+ } else if (ui.item.category === catTypes || ui.item.category === catMembers) {
+ if (ui.item.m) {
+ urlPrefix = ui.item.m + slash;
+ } else {
+ $.each(packageSearchIndex, function(index, item) {
+ if (item.m && ui.item.p === item.l) {
+ urlPrefix = item.m + slash;
+ }
+ });
+ }
+ }
+ return urlPrefix;
+}
+function createSearchPattern(term) {
+ var pattern = "";
+ var isWordToken = false;
+ term.replace(/,\s*/g, ", ").trim().split(/\s+/).forEach(function(w, index) {
+ if (index > 0) {
+ // whitespace between identifiers is significant
+ pattern += (isWordToken && /^\w/.test(w)) ? "\\s+" : "\\s*";
+ }
+ var tokens = w.split(/(?=[A-Z,.()<>[\/])/);
+ for (var i = 0; i < tokens.length; i++) {
+ var s = tokens[i];
+ if (s === "") {
+ continue;
+ }
+ pattern += $.ui.autocomplete.escapeRegex(s);
+ isWordToken = /\w$/.test(s);
+ if (isWordToken) {
+ pattern += "([a-z0-9_$<>\\[\\]]*?)";
+ }
+ }
+ });
+ return pattern;
+}
+function createMatcher(pattern, flags) {
+ var isCamelCase = /[A-Z]/.test(pattern);
+ return new RegExp(pattern, flags + (isCamelCase ? "" : "i"));
+}
+var watermark = 'Search';
+$(function() {
+ var search = $("#search-input");
+ var reset = $("#reset-button");
+ search.val('');
+ search.prop("disabled", false);
+ reset.prop("disabled", false);
+ search.val(watermark).addClass('watermark');
+ search.blur(function() {
+ if ($(this).val().length === 0) {
+ $(this).val(watermark).addClass('watermark');
+ }
+ });
+ search.on('click keydown paste', function() {
+ if ($(this).val() === watermark) {
+ $(this).val('').removeClass('watermark');
+ }
+ });
+ reset.click(function() {
+ search.val('').focus();
+ });
+ search.focus()[0].setSelectionRange(0, 0);
+});
+$.widget("custom.catcomplete", $.ui.autocomplete, {
+ _create: function() {
+ this._super();
+ this.widget().menu("option", "items", "> :not(.ui-autocomplete-category)");
+ },
+ _renderMenu: function(ul, items) {
+ var rMenu = this;
+ var currentCategory = "";
+ rMenu.menu.bindings = $();
+ $.each(items, function(index, item) {
+ var li;
+ if (item.category && item.category !== currentCategory) {
+ ul.append("
+Starting from the Overview page, you can browse the documentation using the links in each page, and in the navigation bar at the top of each page. The Index and Search box allow you to navigate to specific declarations and summary pages, including: All Packages, All Classes and Interfaces
+
+
Search
+
You can search for definitions of modules, packages, types, fields, methods, system properties and other terms defined in the API, using some or all of the name, optionally using "camelCase" abbreviations. For example:
+
+
j.l.obj will match "java.lang.Object"
+
InpStr will match "java.io.InputStream"
+
HM.cK will match "java.util.HashMap.containsKey(Object)"
+The following sections describe the different kinds of pages in this collection.
+
+
Overview
+
The Overview page is the front page of this API document and provides a list of all packages with a summary for each. This page can also contain an overall description of the set of packages.
+
+
+
Package
+
Each package has a page that contains a list of its classes and interfaces, with a summary for each. These pages may contain the following categories:
+
+
Interfaces
+
Classes
+
Enum Classes
+
Exceptions
+
Errors
+
Annotation Interfaces
+
+
+
+
Class or Interface
+
Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a declaration and description, member summary tables, and detailed member descriptions. Entries in each of these sections are omitted if they are empty or not applicable.
+
+
Class Inheritance Diagram
+
Direct Subclasses
+
All Known Subinterfaces
+
All Known Implementing Classes
+
Class or Interface Declaration
+
Class or Interface Description
+
+
+
+
Nested Class Summary
+
Enum Constant Summary
+
Field Summary
+
Property Summary
+
Constructor Summary
+
Method Summary
+
Required Element Summary
+
Optional Element Summary
+
+
+
+
Enum Constant Details
+
Field Details
+
Property Details
+
Constructor Details
+
Method Details
+
Element Details
+
+
Note: Annotation interfaces have required and optional elements, but not methods. Only enum classes have enum constants. The components of a record class are displayed as part of the declaration of the record class. Properties are a feature of JavaFX.
+
The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.
+
+
+
Other Files
+
Packages and modules may contain pages with additional information related to the declarations nearby.
+
+
+
Tree (Class Hierarchy)
+
There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. Classes are organized by inheritance structure starting with java.lang.Object. Interfaces do not inherit from java.lang.Object.
+
+
When viewing the Overview page, clicking on TREE displays the hierarchy for all packages.
+
When viewing a particular package, class or interface page, clicking on TREE displays the hierarchy for only that package.
+
+
+
+
Serialized Form
+
Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to those who implement rather than use the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking "Serialized Form" in the "See Also" section of the class description.
+
+
+
All Packages
+
The All Packages page contains an alphabetic index of all packages contained in the documentation.
+
+
+
All Classes and Interfaces
+
The All Classes and Interfaces page contains an alphabetic index of all classes and interfaces contained in the documentation, including annotation interfaces, enum classes, and record classes.
+
+
+
Index
+
The Index contains an alphabetic index of all classes, interfaces, constructors, methods, and fields in the documentation, as well as summary pages such as All Packages, All Classes and Interfaces.
+
+
+
+This help file applies to API documentation generated by the standard doclet.
+
+
+
diff --git a/docs/v0.8.2/javadoc/retrofit/jquery-ui.overrides.css b/docs/v0.8.2/javadoc/retrofit/jquery-ui.overrides.css
new file mode 100644
index 00000000..facf852c
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/jquery-ui.overrides.css
@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2020, 2022, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+.ui-state-active,
+.ui-widget-content .ui-state-active,
+.ui-widget-header .ui-state-active,
+a.ui-button:active,
+.ui-button:active,
+.ui-button.ui-state-active:hover {
+ /* Overrides the color of selection used in jQuery UI */
+ background: #F8981D;
+ border: 1px solid #F8981D;
+}
diff --git a/docs/v0.8.2/javadoc/retrofit/legal/ADDITIONAL_LICENSE_INFO b/docs/v0.8.2/javadoc/retrofit/legal/ADDITIONAL_LICENSE_INFO
new file mode 100644
index 00000000..ff700cd0
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/legal/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1,37 @@
+ ADDITIONAL INFORMATION ABOUT LICENSING
+
+Certain files distributed by Oracle America, Inc. and/or its affiliates are
+subject to the following clarification and special exception to the GPLv2,
+based on the GNU Project exception for its Classpath libraries, known as the
+GNU Classpath Exception.
+
+Note that Oracle includes multiple, independent programs in this software
+package. Some of those programs are provided under licenses deemed
+incompatible with the GPLv2 by the Free Software Foundation and others.
+For example, the package includes programs licensed under the Apache
+License, Version 2.0 and may include FreeType. Such programs are licensed
+to you under their original licenses.
+
+Oracle facilitates your further distribution of this package by adding the
+Classpath Exception to the necessary parts of its GPLv2 code, which permits
+you to use that code in combination with other independent modules not
+licensed under the GPLv2. However, note that this would not permit you to
+commingle code under an incompatible license with Oracle's GPLv2 licensed
+code by, for example, cutting and pasting such code into a file also
+containing Oracle's GPLv2 licensed code and then distributing the result.
+
+Additionally, if you were to remove the Classpath Exception from any of the
+files to which it applies and distribute the result, you would likely be
+required to license some or all of the other code in that distribution under
+the GPLv2 as well, and since the GPLv2 is incompatible with the license terms
+of some items included in the distribution by Oracle, removing the Classpath
+Exception could therefore effectively compromise your ability to further
+distribute the package.
+
+Failing to distribute notices associated with some files may also create
+unexpected legal consequences.
+
+Proceed with caution and we recommend that you obtain the advice of a lawyer
+skilled in open source matters before removing the Classpath Exception or
+making modifications to this package which may subsequently be redistributed
+and/or involve the use of third party software.
diff --git a/docs/v0.8.2/javadoc/retrofit/legal/ASSEMBLY_EXCEPTION b/docs/v0.8.2/javadoc/retrofit/legal/ASSEMBLY_EXCEPTION
new file mode 100644
index 00000000..065b8d90
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/legal/ASSEMBLY_EXCEPTION
@@ -0,0 +1,27 @@
+
+OPENJDK ASSEMBLY EXCEPTION
+
+The OpenJDK source code made available by Oracle America, Inc. (Oracle) at
+openjdk.java.net ("OpenJDK Code") is distributed under the terms of the GNU
+General Public License version 2
+only ("GPL2"), with the following clarification and special exception.
+
+ Linking this OpenJDK Code statically or dynamically with other code
+ is making a combined work based on this library. Thus, the terms
+ and conditions of GPL2 cover the whole combination.
+
+ As a special exception, Oracle gives you permission to link this
+ OpenJDK Code with certain code licensed by Oracle as indicated at
+ http://openjdk.java.net/legal/exception-modules-2007-05-08.html
+ ("Designated Exception Modules") to produce an executable,
+ regardless of the license terms of the Designated Exception Modules,
+ and to copy and distribute the resulting executable under GPL2,
+ provided that the Designated Exception Modules continue to be
+ governed by the licenses under which they were offered by Oracle.
+
+As such, it allows licensees and sublicensees of Oracle's GPL2 OpenJDK Code
+to build an executable that includes those portions of necessary code that
+Oracle could not provide under GPL2 (or that Oracle has provided under GPL2
+with the Classpath exception). If you modify or add to the OpenJDK code,
+that new GPL2 code may still be combined with Designated Exception Modules
+if the new code is made subject to this exception by its copyright holder.
diff --git a/docs/v0.8.2/javadoc/retrofit/legal/LICENSE b/docs/v0.8.2/javadoc/retrofit/legal/LICENSE
new file mode 100644
index 00000000..8b400c7a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/legal/LICENSE
@@ -0,0 +1,347 @@
+The GNU General Public License (GPL)
+
+Version 2, June 1991
+
+Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+Everyone is permitted to copy and distribute verbatim copies of this license
+document, but changing it is not allowed.
+
+Preamble
+
+The licenses for most software are designed to take away your freedom to share
+and change it. By contrast, the GNU General Public License is intended to
+guarantee your freedom to share and change free software--to make sure the
+software is free for all its users. This General Public License applies to
+most of the Free Software Foundation's software and to any other program whose
+authors commit to using it. (Some other Free Software Foundation software is
+covered by the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our
+General Public Licenses are designed to make sure that you have the freedom to
+distribute copies of free software (and charge for this service if you wish),
+that you receive source code or can get it if you want it, that you can change
+the software or use pieces of it in new free programs; and that you know you
+can do these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny
+you these rights or to ask you to surrender the rights. These restrictions
+translate to certain responsibilities for you if you distribute copies of the
+software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for
+a fee, you must give the recipients all the rights that you have. You must
+make sure that they, too, receive or can get the source code. And you must
+show them these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2)
+offer you this license which gives you legal permission to copy, distribute
+and/or modify the software.
+
+Also, for each author's protection and ours, we want to make certain that
+everyone understands that there is no warranty for this free software. If the
+software is modified by someone else and passed on, we want its recipients to
+know that what they have is not the original, so that any problems introduced
+by others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We
+wish to avoid the danger that redistributors of a free program will
+individually obtain patent licenses, in effect making the program proprietary.
+To prevent this, we have made it clear that any patent must be licensed for
+everyone's free use or not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification
+follow.
+
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+0. This License applies to any program or other work which contains a notice
+placed by the copyright holder saying it may be distributed under the terms of
+this General Public License. The "Program", below, refers to any such program
+or work, and a "work based on the Program" means either the Program or any
+derivative work under copyright law: that is to say, a work containing the
+Program or a portion of it, either verbatim or with modifications and/or
+translated into another language. (Hereinafter, translation is included
+without limitation in the term "modification".) Each licensee is addressed as
+"you".
+
+Activities other than copying, distribution and modification are not covered by
+this License; they are outside its scope. The act of running the Program is
+not restricted, and the output from the Program is covered only if its contents
+constitute a work based on the Program (independent of having been made by
+running the Program). Whether that is true depends on what the Program does.
+
+1. You may copy and distribute verbatim copies of the Program's source code as
+you receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice and
+disclaimer of warranty; keep intact all the notices that refer to this License
+and to the absence of any warranty; and give any other recipients of the
+Program a copy of this License along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and you may
+at your option offer warranty protection in exchange for a fee.
+
+2. You may modify your copy or copies of the Program or any portion of it, thus
+forming a work based on the Program, and copy and distribute such modifications
+or work under the terms of Section 1 above, provided that you also meet all of
+these conditions:
+
+ a) You must cause the modified files to carry prominent notices stating
+ that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in whole or
+ in part contains or is derived from the Program or any part thereof, to be
+ licensed as a whole at no charge to all third parties under the terms of
+ this License.
+
+ c) If the modified program normally reads commands interactively when run,
+ you must cause it, when started running for such interactive use in the
+ most ordinary way, to print or display an announcement including an
+ appropriate copyright notice and a notice that there is no warranty (or
+ else, saying that you provide a warranty) and that users may redistribute
+ the program under these conditions, and telling the user how to view a copy
+ of this License. (Exception: if the Program itself is interactive but does
+ not normally print such an announcement, your work based on the Program is
+ not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If identifiable
+sections of that work are not derived from the Program, and can be reasonably
+considered independent and separate works in themselves, then this License, and
+its terms, do not apply to those sections when you distribute them as separate
+works. But when you distribute the same sections as part of a whole which is a
+work based on the Program, the distribution of the whole must be on the terms
+of this License, whose permissions for other licensees extend to the entire
+whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest your
+rights to work written entirely by you; rather, the intent is to exercise the
+right to control the distribution of derivative or collective works based on
+the Program.
+
+In addition, mere aggregation of another work not based on the Program with the
+Program (or with a work based on the Program) on a volume of a storage or
+distribution medium does not bring the other work under the scope of this
+License.
+
+3. You may copy and distribute the Program (or a work based on it, under
+Section 2) in object code or executable form under the terms of Sections 1 and
+2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable source
+ code, which must be distributed under the terms of Sections 1 and 2 above
+ on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three years, to
+ give any third party, for a charge no more than your cost of physically
+ performing source distribution, a complete machine-readable copy of the
+ corresponding source code, to be distributed under the terms of Sections 1
+ and 2 above on a medium customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer to
+ distribute corresponding source code. (This alternative is allowed only
+ for noncommercial distribution and only if you received the program in
+ object code or executable form with such an offer, in accord with
+ Subsection b above.)
+
+The source code for a work means the preferred form of the work for making
+modifications to it. For an executable work, complete source code means all
+the source code for all modules it contains, plus any associated interface
+definition files, plus the scripts used to control compilation and installation
+of the executable. However, as a special exception, the source code
+distributed need not include anything that is normally distributed (in either
+source or binary form) with the major components (compiler, kernel, and so on)
+of the operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the source
+code from the same place counts as distribution of the source code, even though
+third parties are not compelled to copy the source along with the object code.
+
+4. You may not copy, modify, sublicense, or distribute the Program except as
+expressly provided under this License. Any attempt otherwise to copy, modify,
+sublicense or distribute the Program is void, and will automatically terminate
+your rights under this License. However, parties who have received copies, or
+rights, from you under this License will not have their licenses terminated so
+long as such parties remain in full compliance.
+
+5. You are not required to accept this License, since you have not signed it.
+However, nothing else grants you permission to modify or distribute the Program
+or its derivative works. These actions are prohibited by law if you do not
+accept this License. Therefore, by modifying or distributing the Program (or
+any work based on the Program), you indicate your acceptance of this License to
+do so, and all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+6. Each time you redistribute the Program (or any work based on the Program),
+the recipient automatically receives a license from the original licensor to
+copy, distribute or modify the Program subject to these terms and conditions.
+You may not impose any further restrictions on the recipients' exercise of the
+rights granted herein. You are not responsible for enforcing compliance by
+third parties to this License.
+
+7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues), conditions
+are imposed on you (whether by court order, agreement or otherwise) that
+contradict the conditions of this License, they do not excuse you from the
+conditions of this License. If you cannot distribute so as to satisfy
+simultaneously your obligations under this License and any other pertinent
+obligations, then as a consequence you may not distribute the Program at all.
+For example, if a patent license would not permit royalty-free redistribution
+of the Program by all those who receive copies directly or indirectly through
+you, then the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply and
+the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any patents or
+other property right claims or to contest validity of any such claims; this
+section has the sole purpose of protecting the integrity of the free software
+distribution system, which is implemented by public license practices. Many
+people have made generous contributions to the wide range of software
+distributed through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing to
+distribute software through any other system and a licensee cannot impose that
+choice.
+
+This section is intended to make thoroughly clear what is believed to be a
+consequence of the rest of this License.
+
+8. If the distribution and/or use of the Program is restricted in certain
+countries either by patents or by copyrighted interfaces, the original
+copyright holder who places the Program under this License may add an explicit
+geographical distribution limitation excluding those countries, so that
+distribution is permitted only in or among countries not thus excluded. In
+such case, this License incorporates the limitation as if written in the body
+of this License.
+
+9. The Free Software Foundation may publish revised and/or new versions of the
+General Public License from time to time. Such new versions will be similar in
+spirit to the present version, but may differ in detail to address new problems
+or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any later
+version", you have the option of following the terms and conditions either of
+that version or of any later version published by the Free Software Foundation.
+If the Program does not specify a version number of this License, you may
+choose any version ever published by the Free Software Foundation.
+
+10. If you wish to incorporate parts of the Program into other free programs
+whose distribution conditions are different, write to the author to ask for
+permission. For software which is copyrighted by the Free Software Foundation,
+write to the Free Software Foundation; we sometimes make exceptions for this.
+Our decision will be guided by the two goals of preserving the free status of
+all derivatives of our free software and of promoting the sharing and reuse of
+software generally.
+
+NO WARRANTY
+
+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
+THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE
+STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE
+PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
+YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
+ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE
+PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
+INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
+BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER
+OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible
+use to the public, the best way to achieve this is to make it free software
+which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach
+them to the start of each source file to most effectively convey the exclusion
+of warranty; and each file should have at least the "copyright" line and a
+pointer to where the full notice is found.
+
+ One line to give the program's name and a brief idea of what it does.
+
+ Copyright (C)
+
+ This program is free software; you can redistribute it and/or modify it
+ under the terms of the GNU General Public License as published by the Free
+ Software Foundation; either version 2 of the License, or (at your option)
+ any later version.
+
+ This program is distributed in the hope that it will be useful, but WITHOUT
+ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ more details.
+
+ You should have received a copy of the GNU General Public License along
+ with this program; if not, write to the Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this when it
+starts in an interactive mode:
+
+ Gnomovision version 69, Copyright (C) year name of author Gnomovision comes
+ with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free
+ software, and you are welcome to redistribute it under certain conditions;
+ type 'show c' for details.
+
+The hypothetical commands 'show w' and 'show c' should show the appropriate
+parts of the General Public License. Of course, the commands you use may be
+called something other than 'show w' and 'show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your school,
+if any, to sign a "copyright disclaimer" for the program, if necessary. Here
+is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+ 'Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+ signature of Ty Coon, 1 April 1989
+
+ Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Library General Public
+License instead of this License.
+
+
+"CLASSPATH" EXCEPTION TO THE GPL
+
+Certain source files distributed by Oracle America and/or its affiliates are
+subject to the following clarification and special exception to the GPL, but
+only where Oracle has expressly included in the particular source file's header
+the words "Oracle designates this particular file as subject to the "Classpath"
+exception as provided by Oracle in the LICENSE file that accompanied this code."
+
+ Linking this library statically or dynamically with other modules is making
+ a combined work based on this library. Thus, the terms and conditions of
+ the GNU General Public License cover the whole combination.
+
+ As a special exception, the copyright holders of this library give you
+ permission to link this library with independent modules to produce an
+ executable, regardless of the license terms of these independent modules,
+ and to copy and distribute the resulting executable under terms of your
+ choice, provided that you also meet, for each linked independent module,
+ the terms and conditions of the license of that module. An independent
+ module is a module which is not derived from or based on this library. If
+ you modify this library, you may extend this exception to your version of
+ the library, but you are not obligated to do so. If you do not wish to do
+ so, delete this exception statement from your version.
diff --git a/docs/v0.8.2/javadoc/retrofit/legal/jquery.md b/docs/v0.8.2/javadoc/retrofit/legal/jquery.md
new file mode 100644
index 00000000..a763ec6f
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/legal/jquery.md
@@ -0,0 +1,26 @@
+## jQuery v3.7.1
+
+### jQuery License
+```
+jQuery v 3.7.1
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
+
+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.
+```
diff --git a/docs/v0.8.2/javadoc/retrofit/legal/jqueryUI.md b/docs/v0.8.2/javadoc/retrofit/legal/jqueryUI.md
new file mode 100644
index 00000000..8bda9d7a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/legal/jqueryUI.md
@@ -0,0 +1,49 @@
+## jQuery UI v1.13.2
+
+### jQuery UI License
+```
+Copyright jQuery Foundation and other contributors, https://jquery.org/
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/jquery/jquery-ui
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+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.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code contained within the demos directory.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+All files located in the node_modules and external directories are
+externally maintained libraries used by this software which have their
+own licenses; we recommend you read them, as their terms may differ from
+the terms above.
+
+```
diff --git a/docs/v0.8.2/javadoc/retrofit/member-search-index.js b/docs/v0.8.2/javadoc/retrofit/member-search-index.js
new file mode 100644
index 00000000..bc8f9c3d
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/member-search-index.js
@@ -0,0 +1 @@
+memberSearchIndex = [{"p":"org.shakespeareframework.retrofit","c":"HeaderInterceptor","l":"add(String, String)","u":"add(java.lang.String,java.lang.String)"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis.Builder","l":"addConverterFactory(Converter.Factory)","u":"addConverterFactory(retrofit2.Converter.Factory)"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis.Builder","l":"addInterceptor(Interceptor)","u":"addInterceptor(okhttp3.Interceptor)"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis.Builder","l":"addJacksonConverterFactory()"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis.Builder","l":"addJacksonConverterFactory(ObjectMapper)","u":"addJacksonConverterFactory(com.fasterxml.jackson.databind.ObjectMapper)"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis.Builder","l":"addScalarsConverterFactory()"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"RetryingTokenAuthenticator","l":"authenticate(Route, Response)","u":"authenticate(okhttp3.Route,okhttp3.Response)"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis.Builder","l":"authenticator(Authenticator)","u":"authenticator(okhttp3.Authenticator)"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis.Builder","l":"baseUrl(String)","u":"baseUrl(java.lang.String)"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis.Builder","l":"build(Class)","u":"build(java.lang.Class)"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis","l":"buildClient()"},{"p":"org.shakespeareframework.retrofit","c":"CallHttpApis","l":"CallHttpApis()","u":"%3Cinit%3E()"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"Oauth2Token","l":"getAccessToken()"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"ResourceOwnerPasswordTokenAuthenticator","l":"getToken()"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"RetryingTokenAuthenticator","l":"getToken()"},{"p":"org.shakespeareframework.retrofit","c":"HeaderInterceptor","l":"HeaderInterceptor()","u":"%3Cinit%3E()"},{"p":"org.shakespeareframework.retrofit","c":"HeaderInterceptor","l":"intercept(Interceptor.Chain)","u":"intercept(okhttp3.Interceptor.Chain)"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"Oauth2Token","l":"isExpired()"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"RetryingTokenAuthenticator","l":"oauth2Api"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"Oauth2AuthenticationFailedException","l":"Oauth2AuthenticationFailedException()","u":"%3Cinit%3E()"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"Oauth2Token","l":"Oauth2Token(String, Integer)","u":"%3Cinit%3E(java.lang.String,java.lang.Integer)"},{"p":"org.shakespeareframework.retrofit","c":"HeaderInterceptor","l":"remove(String)","u":"remove(java.lang.String)"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"ResourceOwnerPasswordTokenAuthenticator","l":"ResourceOwnerPasswordTokenAuthenticator(String, String, String, String, String, String)","u":"%3Cinit%3E(java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String)"},{"p":"org.shakespeareframework.retrofit.oauth2","c":"RetryingTokenAuthenticator","l":"RetryingTokenAuthenticator(String, int)","u":"%3Cinit%3E(java.lang.String,int)"}];updateSearchResults();
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/retrofit/module-search-index.js b/docs/v0.8.2/javadoc/retrofit/module-search-index.js
new file mode 100644
index 00000000..0d59754f
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/module-search-index.js
@@ -0,0 +1 @@
+moduleSearchIndex = [];updateSearchResults();
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/retrofit/org/shakespeareframework/retrofit/CallHttpApis.Builder.html b/docs/v0.8.2/javadoc/retrofit/org/shakespeareframework/retrofit/CallHttpApis.Builder.html
new file mode 100644
index 00000000..556eaa97
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/org/shakespeareframework/retrofit/CallHttpApis.Builder.html
@@ -0,0 +1,322 @@
+
+
+
+
+CallHttpApis.Builder (retrofit 0.8.2 API)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
").text(e.label)).appendTo(t)},_move:function(t,e){if(this.menu.element.is(":visible"))return this.menu.isFirstItem()&&/^previous/.test(t)||this.menu.isLastItem()&&/^next/.test(t)?(this.isMultiLine||this._value(this.term),void this.menu.blur()):void this.menu[t](e);this.search(null,e)},widget:function(){return this.menu.element},_value:function(){return this.valueMethod.apply(this.element,arguments)},_keyEvent:function(t,e){this.isMultiLine&&!this.menu.element.is(":visible")||(this._move(t,e),e.preventDefault())},_isContentEditable:function(t){if(!t.length)return!1;var e=t.prop("contentEditable");return"inherit"===e?this._isContentEditable(t.parent()):"true"===e}}),x.extend(x.ui.autocomplete,{escapeRegex:function(t){return t.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&")},filter:function(t,e){var i=new RegExp(x.ui.autocomplete.escapeRegex(e),"i");return x.grep(t,function(t){return i.test(t.label||t.value||t)})}}),x.widget("ui.autocomplete",x.ui.autocomplete,{options:{messages:{noResults:"No search results.",results:function(t){return t+(1").text(e))},100))}});x.ui.autocomplete});
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/retrofit/script.js b/docs/v0.8.2/javadoc/retrofit/script.js
new file mode 100644
index 00000000..73cd8faa
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/script.js
@@ -0,0 +1,132 @@
+/*
+ * Copyright (c) 2013, 2020, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+var moduleSearchIndex;
+var packageSearchIndex;
+var typeSearchIndex;
+var memberSearchIndex;
+var tagSearchIndex;
+function loadScripts(doc, tag) {
+ createElem(doc, tag, 'search.js');
+
+ createElem(doc, tag, 'module-search-index.js');
+ createElem(doc, tag, 'package-search-index.js');
+ createElem(doc, tag, 'type-search-index.js');
+ createElem(doc, tag, 'member-search-index.js');
+ createElem(doc, tag, 'tag-search-index.js');
+}
+
+function createElem(doc, tag, path) {
+ var script = doc.createElement(tag);
+ var scriptElement = doc.getElementsByTagName(tag)[0];
+ script.src = pathtoroot + path;
+ scriptElement.parentNode.insertBefore(script, scriptElement);
+}
+
+function show(tableId, selected, columns) {
+ if (tableId !== selected) {
+ document.querySelectorAll('div.' + tableId + ':not(.' + selected + ')')
+ .forEach(function(elem) {
+ elem.style.display = 'none';
+ });
+ }
+ document.querySelectorAll('div.' + selected)
+ .forEach(function(elem, index) {
+ elem.style.display = '';
+ var isEvenRow = index % (columns * 2) < columns;
+ elem.classList.remove(isEvenRow ? oddRowColor : evenRowColor);
+ elem.classList.add(isEvenRow ? evenRowColor : oddRowColor);
+ });
+ updateTabs(tableId, selected);
+}
+
+function updateTabs(tableId, selected) {
+ document.getElementById(tableId + '.tabpanel')
+ .setAttribute('aria-labelledby', selected);
+ document.querySelectorAll('button[id^="' + tableId + '"]')
+ .forEach(function(tab, index) {
+ if (selected === tab.id || (tableId === selected && index === 0)) {
+ tab.className = activeTableTab;
+ tab.setAttribute('aria-selected', true);
+ tab.setAttribute('tabindex',0);
+ } else {
+ tab.className = tableTab;
+ tab.setAttribute('aria-selected', false);
+ tab.setAttribute('tabindex',-1);
+ }
+ });
+}
+
+function switchTab(e) {
+ var selected = document.querySelector('[aria-selected=true]');
+ if (selected) {
+ if ((e.keyCode === 37 || e.keyCode === 38) && selected.previousSibling) {
+ // left or up arrow key pressed: move focus to previous tab
+ selected.previousSibling.click();
+ selected.previousSibling.focus();
+ e.preventDefault();
+ } else if ((e.keyCode === 39 || e.keyCode === 40) && selected.nextSibling) {
+ // right or down arrow key pressed: move focus to next tab
+ selected.nextSibling.click();
+ selected.nextSibling.focus();
+ e.preventDefault();
+ }
+ }
+}
+
+var updateSearchResults = function() {};
+
+function indexFilesLoaded() {
+ return moduleSearchIndex
+ && packageSearchIndex
+ && typeSearchIndex
+ && memberSearchIndex
+ && tagSearchIndex;
+}
+
+// Workaround for scroll position not being included in browser history (8249133)
+document.addEventListener("DOMContentLoaded", function(e) {
+ var contentDiv = document.querySelector("div.flex-content");
+ window.addEventListener("popstate", function(e) {
+ if (e.state !== null) {
+ contentDiv.scrollTop = e.state;
+ }
+ });
+ window.addEventListener("hashchange", function(e) {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ });
+ contentDiv.addEventListener("scroll", function(e) {
+ var timeoutID;
+ if (!timeoutID) {
+ timeoutID = setTimeout(function() {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ timeoutID = null;
+ }, 100);
+ }
+ });
+ if (!location.hash) {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ }
+});
diff --git a/docs/v0.8.2/javadoc/retrofit/search.js b/docs/v0.8.2/javadoc/retrofit/search.js
new file mode 100644
index 00000000..db3b2f4a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/retrofit/search.js
@@ -0,0 +1,354 @@
+/*
+ * Copyright (c) 2015, 2020, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+var noResult = {l: "No results found"};
+var loading = {l: "Loading search index..."};
+var catModules = "Modules";
+var catPackages = "Packages";
+var catTypes = "Classes and Interfaces";
+var catMembers = "Members";
+var catSearchTags = "Search Tags";
+var highlight = "$&";
+var searchPattern = "";
+var fallbackPattern = "";
+var RANKING_THRESHOLD = 2;
+var NO_MATCH = 0xffff;
+var MIN_RESULTS = 3;
+var MAX_RESULTS = 500;
+var UNNAMED = "";
+function escapeHtml(str) {
+ return str.replace(//g, ">");
+}
+function getHighlightedText(item, matcher, fallbackMatcher) {
+ var escapedItem = escapeHtml(item);
+ var highlighted = escapedItem.replace(matcher, highlight);
+ if (highlighted === escapedItem) {
+ highlighted = escapedItem.replace(fallbackMatcher, highlight)
+ }
+ return highlighted;
+}
+function getURLPrefix(ui) {
+ var urlPrefix="";
+ var slash = "/";
+ if (ui.item.category === catModules) {
+ return ui.item.l + slash;
+ } else if (ui.item.category === catPackages && ui.item.m) {
+ return ui.item.m + slash;
+ } else if (ui.item.category === catTypes || ui.item.category === catMembers) {
+ if (ui.item.m) {
+ urlPrefix = ui.item.m + slash;
+ } else {
+ $.each(packageSearchIndex, function(index, item) {
+ if (item.m && ui.item.p === item.l) {
+ urlPrefix = item.m + slash;
+ }
+ });
+ }
+ }
+ return urlPrefix;
+}
+function createSearchPattern(term) {
+ var pattern = "";
+ var isWordToken = false;
+ term.replace(/,\s*/g, ", ").trim().split(/\s+/).forEach(function(w, index) {
+ if (index > 0) {
+ // whitespace between identifiers is significant
+ pattern += (isWordToken && /^\w/.test(w)) ? "\\s+" : "\\s*";
+ }
+ var tokens = w.split(/(?=[A-Z,.()<>[\/])/);
+ for (var i = 0; i < tokens.length; i++) {
+ var s = tokens[i];
+ if (s === "") {
+ continue;
+ }
+ pattern += $.ui.autocomplete.escapeRegex(s);
+ isWordToken = /\w$/.test(s);
+ if (isWordToken) {
+ pattern += "([a-z0-9_$<>\\[\\]]*?)";
+ }
+ }
+ });
+ return pattern;
+}
+function createMatcher(pattern, flags) {
+ var isCamelCase = /[A-Z]/.test(pattern);
+ return new RegExp(pattern, flags + (isCamelCase ? "" : "i"));
+}
+var watermark = 'Search';
+$(function() {
+ var search = $("#search-input");
+ var reset = $("#reset-button");
+ search.val('');
+ search.prop("disabled", false);
+ reset.prop("disabled", false);
+ search.val(watermark).addClass('watermark');
+ search.blur(function() {
+ if ($(this).val().length === 0) {
+ $(this).val(watermark).addClass('watermark');
+ }
+ });
+ search.on('click keydown paste', function() {
+ if ($(this).val() === watermark) {
+ $(this).val('').removeClass('watermark');
+ }
+ });
+ reset.click(function() {
+ search.val('').focus();
+ });
+ search.focus()[0].setSelectionRange(0, 0);
+});
+$.widget("custom.catcomplete", $.ui.autocomplete, {
+ _create: function() {
+ this._super();
+ this.widget().menu("option", "items", "> :not(.ui-autocomplete-category)");
+ },
+ _renderMenu: function(ul, items) {
+ var rMenu = this;
+ var currentCategory = "";
+ rMenu.menu.bindings = $();
+ $.each(items, function(index, item) {
+ var li;
+ if (item.category && item.category !== currentCategory) {
+ ul.append("
+Starting from the Overview page, you can browse the documentation using the links in each page, and in the navigation bar at the top of each page. The Index and Search box allow you to navigate to specific declarations and summary pages, including: All Packages, All Classes and Interfaces
+
+
Search
+
You can search for definitions of modules, packages, types, fields, methods, system properties and other terms defined in the API, using some or all of the name, optionally using "camelCase" abbreviations. For example:
+
+
j.l.obj will match "java.lang.Object"
+
InpStr will match "java.io.InputStream"
+
HM.cK will match "java.util.HashMap.containsKey(Object)"
+The following sections describe the different kinds of pages in this collection.
+
+
Package
+
Each package has a page that contains a list of its classes and interfaces, with a summary for each. These pages may contain the following categories:
+
+
Interfaces
+
Classes
+
Enum Classes
+
Exceptions
+
Errors
+
Annotation Interfaces
+
+
+
+
Class or Interface
+
Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a declaration and description, member summary tables, and detailed member descriptions. Entries in each of these sections are omitted if they are empty or not applicable.
+
+
Class Inheritance Diagram
+
Direct Subclasses
+
All Known Subinterfaces
+
All Known Implementing Classes
+
Class or Interface Declaration
+
Class or Interface Description
+
+
+
+
Nested Class Summary
+
Enum Constant Summary
+
Field Summary
+
Property Summary
+
Constructor Summary
+
Method Summary
+
Required Element Summary
+
Optional Element Summary
+
+
+
+
Enum Constant Details
+
Field Details
+
Property Details
+
Constructor Details
+
Method Details
+
Element Details
+
+
Note: Annotation interfaces have required and optional elements, but not methods. Only enum classes have enum constants. The components of a record class are displayed as part of the declaration of the record class. Properties are a feature of JavaFX.
+
The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.
+
+
+
Other Files
+
Packages and modules may contain pages with additional information related to the declarations nearby.
+
+
+
Tree (Class Hierarchy)
+
There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. Classes are organized by inheritance structure starting with java.lang.Object. Interfaces do not inherit from java.lang.Object.
+
+
When viewing the Overview page, clicking on TREE displays the hierarchy for all packages.
+
When viewing a particular package, class or interface page, clicking on TREE displays the hierarchy for only that package.
+
+
+
+
Serialized Form
+
Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to those who implement rather than use the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking "Serialized Form" in the "See Also" section of the class description.
+
+
+
All Packages
+
The All Packages page contains an alphabetic index of all packages contained in the documentation.
+
+
+
All Classes and Interfaces
+
The All Classes and Interfaces page contains an alphabetic index of all classes and interfaces contained in the documentation, including annotation interfaces, enum classes, and record classes.
+
+
+
Index
+
The Index contains an alphabetic index of all classes, interfaces, constructors, methods, and fields in the documentation, as well as summary pages such as All Packages, All Classes and Interfaces.
+
+
+
+This help file applies to API documentation generated by the standard doclet.
+
+
+
+
diff --git a/docs/v0.8.2/javadoc/selenium/jquery-ui.overrides.css b/docs/v0.8.2/javadoc/selenium/jquery-ui.overrides.css
new file mode 100644
index 00000000..facf852c
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/jquery-ui.overrides.css
@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2020, 2022, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+.ui-state-active,
+.ui-widget-content .ui-state-active,
+.ui-widget-header .ui-state-active,
+a.ui-button:active,
+.ui-button:active,
+.ui-button.ui-state-active:hover {
+ /* Overrides the color of selection used in jQuery UI */
+ background: #F8981D;
+ border: 1px solid #F8981D;
+}
diff --git a/docs/v0.8.2/javadoc/selenium/legal/ADDITIONAL_LICENSE_INFO b/docs/v0.8.2/javadoc/selenium/legal/ADDITIONAL_LICENSE_INFO
new file mode 100644
index 00000000..ff700cd0
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/legal/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1,37 @@
+ ADDITIONAL INFORMATION ABOUT LICENSING
+
+Certain files distributed by Oracle America, Inc. and/or its affiliates are
+subject to the following clarification and special exception to the GPLv2,
+based on the GNU Project exception for its Classpath libraries, known as the
+GNU Classpath Exception.
+
+Note that Oracle includes multiple, independent programs in this software
+package. Some of those programs are provided under licenses deemed
+incompatible with the GPLv2 by the Free Software Foundation and others.
+For example, the package includes programs licensed under the Apache
+License, Version 2.0 and may include FreeType. Such programs are licensed
+to you under their original licenses.
+
+Oracle facilitates your further distribution of this package by adding the
+Classpath Exception to the necessary parts of its GPLv2 code, which permits
+you to use that code in combination with other independent modules not
+licensed under the GPLv2. However, note that this would not permit you to
+commingle code under an incompatible license with Oracle's GPLv2 licensed
+code by, for example, cutting and pasting such code into a file also
+containing Oracle's GPLv2 licensed code and then distributing the result.
+
+Additionally, if you were to remove the Classpath Exception from any of the
+files to which it applies and distribute the result, you would likely be
+required to license some or all of the other code in that distribution under
+the GPLv2 as well, and since the GPLv2 is incompatible with the license terms
+of some items included in the distribution by Oracle, removing the Classpath
+Exception could therefore effectively compromise your ability to further
+distribute the package.
+
+Failing to distribute notices associated with some files may also create
+unexpected legal consequences.
+
+Proceed with caution and we recommend that you obtain the advice of a lawyer
+skilled in open source matters before removing the Classpath Exception or
+making modifications to this package which may subsequently be redistributed
+and/or involve the use of third party software.
diff --git a/docs/v0.8.2/javadoc/selenium/legal/ASSEMBLY_EXCEPTION b/docs/v0.8.2/javadoc/selenium/legal/ASSEMBLY_EXCEPTION
new file mode 100644
index 00000000..065b8d90
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/legal/ASSEMBLY_EXCEPTION
@@ -0,0 +1,27 @@
+
+OPENJDK ASSEMBLY EXCEPTION
+
+The OpenJDK source code made available by Oracle America, Inc. (Oracle) at
+openjdk.java.net ("OpenJDK Code") is distributed under the terms of the GNU
+General Public License version 2
+only ("GPL2"), with the following clarification and special exception.
+
+ Linking this OpenJDK Code statically or dynamically with other code
+ is making a combined work based on this library. Thus, the terms
+ and conditions of GPL2 cover the whole combination.
+
+ As a special exception, Oracle gives you permission to link this
+ OpenJDK Code with certain code licensed by Oracle as indicated at
+ http://openjdk.java.net/legal/exception-modules-2007-05-08.html
+ ("Designated Exception Modules") to produce an executable,
+ regardless of the license terms of the Designated Exception Modules,
+ and to copy and distribute the resulting executable under GPL2,
+ provided that the Designated Exception Modules continue to be
+ governed by the licenses under which they were offered by Oracle.
+
+As such, it allows licensees and sublicensees of Oracle's GPL2 OpenJDK Code
+to build an executable that includes those portions of necessary code that
+Oracle could not provide under GPL2 (or that Oracle has provided under GPL2
+with the Classpath exception). If you modify or add to the OpenJDK code,
+that new GPL2 code may still be combined with Designated Exception Modules
+if the new code is made subject to this exception by its copyright holder.
diff --git a/docs/v0.8.2/javadoc/selenium/legal/LICENSE b/docs/v0.8.2/javadoc/selenium/legal/LICENSE
new file mode 100644
index 00000000..8b400c7a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/legal/LICENSE
@@ -0,0 +1,347 @@
+The GNU General Public License (GPL)
+
+Version 2, June 1991
+
+Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+Everyone is permitted to copy and distribute verbatim copies of this license
+document, but changing it is not allowed.
+
+Preamble
+
+The licenses for most software are designed to take away your freedom to share
+and change it. By contrast, the GNU General Public License is intended to
+guarantee your freedom to share and change free software--to make sure the
+software is free for all its users. This General Public License applies to
+most of the Free Software Foundation's software and to any other program whose
+authors commit to using it. (Some other Free Software Foundation software is
+covered by the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our
+General Public Licenses are designed to make sure that you have the freedom to
+distribute copies of free software (and charge for this service if you wish),
+that you receive source code or can get it if you want it, that you can change
+the software or use pieces of it in new free programs; and that you know you
+can do these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny
+you these rights or to ask you to surrender the rights. These restrictions
+translate to certain responsibilities for you if you distribute copies of the
+software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for
+a fee, you must give the recipients all the rights that you have. You must
+make sure that they, too, receive or can get the source code. And you must
+show them these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2)
+offer you this license which gives you legal permission to copy, distribute
+and/or modify the software.
+
+Also, for each author's protection and ours, we want to make certain that
+everyone understands that there is no warranty for this free software. If the
+software is modified by someone else and passed on, we want its recipients to
+know that what they have is not the original, so that any problems introduced
+by others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We
+wish to avoid the danger that redistributors of a free program will
+individually obtain patent licenses, in effect making the program proprietary.
+To prevent this, we have made it clear that any patent must be licensed for
+everyone's free use or not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification
+follow.
+
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+0. This License applies to any program or other work which contains a notice
+placed by the copyright holder saying it may be distributed under the terms of
+this General Public License. The "Program", below, refers to any such program
+or work, and a "work based on the Program" means either the Program or any
+derivative work under copyright law: that is to say, a work containing the
+Program or a portion of it, either verbatim or with modifications and/or
+translated into another language. (Hereinafter, translation is included
+without limitation in the term "modification".) Each licensee is addressed as
+"you".
+
+Activities other than copying, distribution and modification are not covered by
+this License; they are outside its scope. The act of running the Program is
+not restricted, and the output from the Program is covered only if its contents
+constitute a work based on the Program (independent of having been made by
+running the Program). Whether that is true depends on what the Program does.
+
+1. You may copy and distribute verbatim copies of the Program's source code as
+you receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice and
+disclaimer of warranty; keep intact all the notices that refer to this License
+and to the absence of any warranty; and give any other recipients of the
+Program a copy of this License along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and you may
+at your option offer warranty protection in exchange for a fee.
+
+2. You may modify your copy or copies of the Program or any portion of it, thus
+forming a work based on the Program, and copy and distribute such modifications
+or work under the terms of Section 1 above, provided that you also meet all of
+these conditions:
+
+ a) You must cause the modified files to carry prominent notices stating
+ that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in whole or
+ in part contains or is derived from the Program or any part thereof, to be
+ licensed as a whole at no charge to all third parties under the terms of
+ this License.
+
+ c) If the modified program normally reads commands interactively when run,
+ you must cause it, when started running for such interactive use in the
+ most ordinary way, to print or display an announcement including an
+ appropriate copyright notice and a notice that there is no warranty (or
+ else, saying that you provide a warranty) and that users may redistribute
+ the program under these conditions, and telling the user how to view a copy
+ of this License. (Exception: if the Program itself is interactive but does
+ not normally print such an announcement, your work based on the Program is
+ not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If identifiable
+sections of that work are not derived from the Program, and can be reasonably
+considered independent and separate works in themselves, then this License, and
+its terms, do not apply to those sections when you distribute them as separate
+works. But when you distribute the same sections as part of a whole which is a
+work based on the Program, the distribution of the whole must be on the terms
+of this License, whose permissions for other licensees extend to the entire
+whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest your
+rights to work written entirely by you; rather, the intent is to exercise the
+right to control the distribution of derivative or collective works based on
+the Program.
+
+In addition, mere aggregation of another work not based on the Program with the
+Program (or with a work based on the Program) on a volume of a storage or
+distribution medium does not bring the other work under the scope of this
+License.
+
+3. You may copy and distribute the Program (or a work based on it, under
+Section 2) in object code or executable form under the terms of Sections 1 and
+2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable source
+ code, which must be distributed under the terms of Sections 1 and 2 above
+ on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three years, to
+ give any third party, for a charge no more than your cost of physically
+ performing source distribution, a complete machine-readable copy of the
+ corresponding source code, to be distributed under the terms of Sections 1
+ and 2 above on a medium customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer to
+ distribute corresponding source code. (This alternative is allowed only
+ for noncommercial distribution and only if you received the program in
+ object code or executable form with such an offer, in accord with
+ Subsection b above.)
+
+The source code for a work means the preferred form of the work for making
+modifications to it. For an executable work, complete source code means all
+the source code for all modules it contains, plus any associated interface
+definition files, plus the scripts used to control compilation and installation
+of the executable. However, as a special exception, the source code
+distributed need not include anything that is normally distributed (in either
+source or binary form) with the major components (compiler, kernel, and so on)
+of the operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the source
+code from the same place counts as distribution of the source code, even though
+third parties are not compelled to copy the source along with the object code.
+
+4. You may not copy, modify, sublicense, or distribute the Program except as
+expressly provided under this License. Any attempt otherwise to copy, modify,
+sublicense or distribute the Program is void, and will automatically terminate
+your rights under this License. However, parties who have received copies, or
+rights, from you under this License will not have their licenses terminated so
+long as such parties remain in full compliance.
+
+5. You are not required to accept this License, since you have not signed it.
+However, nothing else grants you permission to modify or distribute the Program
+or its derivative works. These actions are prohibited by law if you do not
+accept this License. Therefore, by modifying or distributing the Program (or
+any work based on the Program), you indicate your acceptance of this License to
+do so, and all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+6. Each time you redistribute the Program (or any work based on the Program),
+the recipient automatically receives a license from the original licensor to
+copy, distribute or modify the Program subject to these terms and conditions.
+You may not impose any further restrictions on the recipients' exercise of the
+rights granted herein. You are not responsible for enforcing compliance by
+third parties to this License.
+
+7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues), conditions
+are imposed on you (whether by court order, agreement or otherwise) that
+contradict the conditions of this License, they do not excuse you from the
+conditions of this License. If you cannot distribute so as to satisfy
+simultaneously your obligations under this License and any other pertinent
+obligations, then as a consequence you may not distribute the Program at all.
+For example, if a patent license would not permit royalty-free redistribution
+of the Program by all those who receive copies directly or indirectly through
+you, then the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply and
+the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any patents or
+other property right claims or to contest validity of any such claims; this
+section has the sole purpose of protecting the integrity of the free software
+distribution system, which is implemented by public license practices. Many
+people have made generous contributions to the wide range of software
+distributed through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing to
+distribute software through any other system and a licensee cannot impose that
+choice.
+
+This section is intended to make thoroughly clear what is believed to be a
+consequence of the rest of this License.
+
+8. If the distribution and/or use of the Program is restricted in certain
+countries either by patents or by copyrighted interfaces, the original
+copyright holder who places the Program under this License may add an explicit
+geographical distribution limitation excluding those countries, so that
+distribution is permitted only in or among countries not thus excluded. In
+such case, this License incorporates the limitation as if written in the body
+of this License.
+
+9. The Free Software Foundation may publish revised and/or new versions of the
+General Public License from time to time. Such new versions will be similar in
+spirit to the present version, but may differ in detail to address new problems
+or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any later
+version", you have the option of following the terms and conditions either of
+that version or of any later version published by the Free Software Foundation.
+If the Program does not specify a version number of this License, you may
+choose any version ever published by the Free Software Foundation.
+
+10. If you wish to incorporate parts of the Program into other free programs
+whose distribution conditions are different, write to the author to ask for
+permission. For software which is copyrighted by the Free Software Foundation,
+write to the Free Software Foundation; we sometimes make exceptions for this.
+Our decision will be guided by the two goals of preserving the free status of
+all derivatives of our free software and of promoting the sharing and reuse of
+software generally.
+
+NO WARRANTY
+
+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
+THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE
+STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE
+PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
+YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
+ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE
+PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
+INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
+BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER
+OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible
+use to the public, the best way to achieve this is to make it free software
+which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach
+them to the start of each source file to most effectively convey the exclusion
+of warranty; and each file should have at least the "copyright" line and a
+pointer to where the full notice is found.
+
+ One line to give the program's name and a brief idea of what it does.
+
+ Copyright (C)
+
+ This program is free software; you can redistribute it and/or modify it
+ under the terms of the GNU General Public License as published by the Free
+ Software Foundation; either version 2 of the License, or (at your option)
+ any later version.
+
+ This program is distributed in the hope that it will be useful, but WITHOUT
+ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ more details.
+
+ You should have received a copy of the GNU General Public License along
+ with this program; if not, write to the Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this when it
+starts in an interactive mode:
+
+ Gnomovision version 69, Copyright (C) year name of author Gnomovision comes
+ with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free
+ software, and you are welcome to redistribute it under certain conditions;
+ type 'show c' for details.
+
+The hypothetical commands 'show w' and 'show c' should show the appropriate
+parts of the General Public License. Of course, the commands you use may be
+called something other than 'show w' and 'show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your school,
+if any, to sign a "copyright disclaimer" for the program, if necessary. Here
+is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+ 'Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+ signature of Ty Coon, 1 April 1989
+
+ Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Library General Public
+License instead of this License.
+
+
+"CLASSPATH" EXCEPTION TO THE GPL
+
+Certain source files distributed by Oracle America and/or its affiliates are
+subject to the following clarification and special exception to the GPL, but
+only where Oracle has expressly included in the particular source file's header
+the words "Oracle designates this particular file as subject to the "Classpath"
+exception as provided by Oracle in the LICENSE file that accompanied this code."
+
+ Linking this library statically or dynamically with other modules is making
+ a combined work based on this library. Thus, the terms and conditions of
+ the GNU General Public License cover the whole combination.
+
+ As a special exception, the copyright holders of this library give you
+ permission to link this library with independent modules to produce an
+ executable, regardless of the license terms of these independent modules,
+ and to copy and distribute the resulting executable under terms of your
+ choice, provided that you also meet, for each linked independent module,
+ the terms and conditions of the license of that module. An independent
+ module is a module which is not derived from or based on this library. If
+ you modify this library, you may extend this exception to your version of
+ the library, but you are not obligated to do so. If you do not wish to do
+ so, delete this exception statement from your version.
diff --git a/docs/v0.8.2/javadoc/selenium/legal/jquery.md b/docs/v0.8.2/javadoc/selenium/legal/jquery.md
new file mode 100644
index 00000000..a763ec6f
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/legal/jquery.md
@@ -0,0 +1,26 @@
+## jQuery v3.7.1
+
+### jQuery License
+```
+jQuery v 3.7.1
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
+
+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.
+```
diff --git a/docs/v0.8.2/javadoc/selenium/legal/jqueryUI.md b/docs/v0.8.2/javadoc/selenium/legal/jqueryUI.md
new file mode 100644
index 00000000..8bda9d7a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/legal/jqueryUI.md
@@ -0,0 +1,49 @@
+## jQuery UI v1.13.2
+
+### jQuery UI License
+```
+Copyright jQuery Foundation and other contributors, https://jquery.org/
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/jquery/jquery-ui
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+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.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code contained within the demos directory.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+All files located in the node_modules and external directories are
+externally maintained libraries used by this software which have their
+own licenses; we recommend you read them, as their terms may differ from
+the terms above.
+
+```
diff --git a/docs/v0.8.2/javadoc/selenium/member-search-index.js b/docs/v0.8.2/javadoc/selenium/member-search-index.js
new file mode 100644
index 00000000..65897730
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/member-search-index.js
@@ -0,0 +1 @@
+memberSearchIndex = [{"p":"org.shakespeareframework.selenium","c":"BrowseTheWeb","l":"BrowseTheWeb(WebDriverSupplier)","u":"%3Cinit%3E(org.shakespeareframework.selenium.WebDriverSupplier)"},{"p":"org.shakespeareframework.selenium","c":"BrowseTheWeb","l":"BrowseTheWeb(WebDriverSupplier, String)","u":"%3Cinit%3E(org.shakespeareframework.selenium.WebDriverSupplier,java.lang.String)"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"CHROME"},{"p":"org.shakespeareframework.selenium","c":"BrowseTheWeb","l":"close()"},{"p":"org.shakespeareframework.selenium","c":"WebDriverManagerWebDriverSupplier","l":"close()"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"EDGE"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"failure(Actor, Question, Exception)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Question,java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"failure(Actor, Question, Exception)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Question,java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"failure(Actor, Question, A)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Question,A)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"failure(Actor, Question, A)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Question,A)"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"failure(Actor, Task, Exception)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Task,java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"failure(Actor, Task, Exception)","u":"failure(org.shakespeareframework.Actor,org.shakespeareframework.Task,java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"FIREFOX"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"forName(String)","u":"forName(java.lang.String)"},{"p":"org.shakespeareframework.selenium","c":"WebDriverManagerWebDriverSupplier","l":"get()"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"getBaseCapabilities()"},{"p":"org.shakespeareframework.selenium","c":"WebDriverSupplier","l":"getBrowserType()"},{"p":"org.shakespeareframework.selenium","c":"WebDriverSupplier","l":"getCapabilities()"},{"p":"org.shakespeareframework.selenium","c":"BrowseTheWeb","l":"getWebDriver()"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"getWebDriverClass()"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"HtmlSnapshotReporter(Path)","u":"%3Cinit%3E(java.nio.file.Path)"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"HtmlSnapshotReporter(Path, boolean)","u":"%3Cinit%3E(java.nio.file.Path,boolean)"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"IEXPLORER"},{"p":"org.shakespeareframework.selenium","c":"LocalWebDriverSupplier","l":"LocalWebDriverSupplier(BrowserType)","u":"%3Cinit%3E(org.shakespeareframework.selenium.BrowserType)"},{"p":"org.shakespeareframework.selenium","c":"LocalWebDriverSupplier","l":"LocalWebDriverSupplier(BrowserType, Capabilities)","u":"%3Cinit%3E(org.shakespeareframework.selenium.BrowserType,org.openqa.selenium.Capabilities)"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"retry(Actor, RetryableQuestion, Exception)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableQuestion,java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"retry(Actor, RetryableQuestion, Exception)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableQuestion,java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"retry(Actor, RetryableQuestion, A)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableQuestion,A)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"retry(Actor, RetryableQuestion, A)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableQuestion,A)"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"retry(Actor, RetryableTask, Exception)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableTask,java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"retry(Actor, RetryableTask, Exception)","u":"retry(org.shakespeareframework.Actor,org.shakespeareframework.RetryableTask,java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"SAFARI"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"ScreenshotReporter(Path)","u":"%3Cinit%3E(java.nio.file.Path)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"ScreenshotReporter(Path, boolean)","u":"%3Cinit%3E(java.nio.file.Path,boolean)"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"success(Actor, Question, A)","u":"success(org.shakespeareframework.Actor,org.shakespeareframework.Question,A)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"success(Actor, Question, A)","u":"success(org.shakespeareframework.Actor,org.shakespeareframework.Question,A)"},{"p":"org.shakespeareframework.selenium","c":"HtmlSnapshotReporter","l":"success(Actor, Task)","u":"success(org.shakespeareframework.Actor,org.shakespeareframework.Task)"},{"p":"org.shakespeareframework.selenium","c":"ScreenshotReporter","l":"success(Actor, Task)","u":"success(org.shakespeareframework.Actor,org.shakespeareframework.Task)"},{"p":"org.shakespeareframework.selenium","c":"BrowseTheWeb","l":"toString()"},{"p":"org.shakespeareframework.selenium","c":"WebDriverSupplier","l":"toString()"},{"p":"org.shakespeareframework.selenium","c":"UnsupportedBrowserTypeException","l":"UnsupportedBrowserTypeException(String)","u":"%3Cinit%3E(java.lang.String)"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"valueOf(String)","u":"valueOf(java.lang.String)"},{"p":"org.shakespeareframework.selenium","c":"BrowserType","l":"values()"},{"p":"org.shakespeareframework.selenium","c":"WebDriverManagerWebDriverSupplier","l":"WebDriverManagerWebDriverSupplier(WebDriverManager, BrowserType)","u":"%3Cinit%3E(io.github.bonigarcia.wdm.WebDriverManager,org.shakespeareframework.selenium.BrowserType)"},{"p":"org.shakespeareframework.selenium","c":"WebDriverManagerWebDriverSupplier","l":"WebDriverManagerWebDriverSupplier(WebDriverManager, BrowserType, Capabilities)","u":"%3Cinit%3E(io.github.bonigarcia.wdm.WebDriverManager,org.shakespeareframework.selenium.BrowserType,org.openqa.selenium.Capabilities)"},{"p":"org.shakespeareframework.selenium","c":"WebDriverSetupFailedException","l":"WebDriverSetupFailedException(Exception)","u":"%3Cinit%3E(java.lang.Exception)"},{"p":"org.shakespeareframework.selenium","c":"WebDriverSupplier","l":"WebDriverSupplier(BrowserType, Capabilities)","u":"%3Cinit%3E(org.shakespeareframework.selenium.BrowserType,org.openqa.selenium.Capabilities)"}];updateSearchResults();
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/selenium/module-search-index.js b/docs/v0.8.2/javadoc/selenium/module-search-index.js
new file mode 100644
index 00000000..0d59754f
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/module-search-index.js
@@ -0,0 +1 @@
+moduleSearchIndex = [];updateSearchResults();
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/selenium/org/shakespeareframework/selenium/BrowseTheWeb.html b/docs/v0.8.2/javadoc/selenium/org/shakespeareframework/selenium/BrowseTheWeb.html
new file mode 100644
index 00000000..f6865ee7
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/org/shakespeareframework/selenium/BrowseTheWeb.html
@@ -0,0 +1,226 @@
+
+
+
+
+BrowseTheWeb (selenium 0.8.2 API)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Returns the enum constant of this class with the specified name.
+The string must match exactly an identifier used to declare an
+enum constant in this class. (Extraneous whitespace characters are
+not permitted.)
+
+
Parameters:
+
name - the name of the enum constant to be returned.
@NullMarked
+public class HtmlSnapshotReporter
+extends org.shakespeareframework.reporting.FileReporter
+
Reporter using the Actor's BrowseTheWeb.getWebDriver() to take an HTML snapshot
+ of the currently displayed site. By default, only retries and failures are reported. If reportSuccess is set true, successes are reported as well.
+
+
+
+
+
+
+
Nested Class Summary
+
+
Nested classes/interfaces inherited from class org.shakespeareframework.reporting.FileReporter
@NullMarked
+public class ScreenshotReporter
+extends org.shakespeareframework.reporting.FileReporter
+
Reporter using the Actor's BrowseTheWeb.getWebDriver() as TakesScreenshot
+ to take a screenshot of the currently displayed site. By default, only retries and failures are
+ reported. If reportSuccess is set true, successes are reported as well.
+
+
+
+
+
+
+
Nested Class Summary
+
+
Nested classes/interfaces inherited from class org.shakespeareframework.reporting.FileReporter
").text(e.label)).appendTo(t)},_move:function(t,e){if(this.menu.element.is(":visible"))return this.menu.isFirstItem()&&/^previous/.test(t)||this.menu.isLastItem()&&/^next/.test(t)?(this.isMultiLine||this._value(this.term),void this.menu.blur()):void this.menu[t](e);this.search(null,e)},widget:function(){return this.menu.element},_value:function(){return this.valueMethod.apply(this.element,arguments)},_keyEvent:function(t,e){this.isMultiLine&&!this.menu.element.is(":visible")||(this._move(t,e),e.preventDefault())},_isContentEditable:function(t){if(!t.length)return!1;var e=t.prop("contentEditable");return"inherit"===e?this._isContentEditable(t.parent()):"true"===e}}),x.extend(x.ui.autocomplete,{escapeRegex:function(t){return t.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&")},filter:function(t,e){var i=new RegExp(x.ui.autocomplete.escapeRegex(e),"i");return x.grep(t,function(t){return i.test(t.label||t.value||t)})}}),x.widget("ui.autocomplete",x.ui.autocomplete,{options:{messages:{noResults:"No search results.",results:function(t){return t+(1").text(e))},100))}});x.ui.autocomplete});
\ No newline at end of file
diff --git a/docs/v0.8.2/javadoc/selenium/script.js b/docs/v0.8.2/javadoc/selenium/script.js
new file mode 100644
index 00000000..73cd8faa
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/script.js
@@ -0,0 +1,132 @@
+/*
+ * Copyright (c) 2013, 2020, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+var moduleSearchIndex;
+var packageSearchIndex;
+var typeSearchIndex;
+var memberSearchIndex;
+var tagSearchIndex;
+function loadScripts(doc, tag) {
+ createElem(doc, tag, 'search.js');
+
+ createElem(doc, tag, 'module-search-index.js');
+ createElem(doc, tag, 'package-search-index.js');
+ createElem(doc, tag, 'type-search-index.js');
+ createElem(doc, tag, 'member-search-index.js');
+ createElem(doc, tag, 'tag-search-index.js');
+}
+
+function createElem(doc, tag, path) {
+ var script = doc.createElement(tag);
+ var scriptElement = doc.getElementsByTagName(tag)[0];
+ script.src = pathtoroot + path;
+ scriptElement.parentNode.insertBefore(script, scriptElement);
+}
+
+function show(tableId, selected, columns) {
+ if (tableId !== selected) {
+ document.querySelectorAll('div.' + tableId + ':not(.' + selected + ')')
+ .forEach(function(elem) {
+ elem.style.display = 'none';
+ });
+ }
+ document.querySelectorAll('div.' + selected)
+ .forEach(function(elem, index) {
+ elem.style.display = '';
+ var isEvenRow = index % (columns * 2) < columns;
+ elem.classList.remove(isEvenRow ? oddRowColor : evenRowColor);
+ elem.classList.add(isEvenRow ? evenRowColor : oddRowColor);
+ });
+ updateTabs(tableId, selected);
+}
+
+function updateTabs(tableId, selected) {
+ document.getElementById(tableId + '.tabpanel')
+ .setAttribute('aria-labelledby', selected);
+ document.querySelectorAll('button[id^="' + tableId + '"]')
+ .forEach(function(tab, index) {
+ if (selected === tab.id || (tableId === selected && index === 0)) {
+ tab.className = activeTableTab;
+ tab.setAttribute('aria-selected', true);
+ tab.setAttribute('tabindex',0);
+ } else {
+ tab.className = tableTab;
+ tab.setAttribute('aria-selected', false);
+ tab.setAttribute('tabindex',-1);
+ }
+ });
+}
+
+function switchTab(e) {
+ var selected = document.querySelector('[aria-selected=true]');
+ if (selected) {
+ if ((e.keyCode === 37 || e.keyCode === 38) && selected.previousSibling) {
+ // left or up arrow key pressed: move focus to previous tab
+ selected.previousSibling.click();
+ selected.previousSibling.focus();
+ e.preventDefault();
+ } else if ((e.keyCode === 39 || e.keyCode === 40) && selected.nextSibling) {
+ // right or down arrow key pressed: move focus to next tab
+ selected.nextSibling.click();
+ selected.nextSibling.focus();
+ e.preventDefault();
+ }
+ }
+}
+
+var updateSearchResults = function() {};
+
+function indexFilesLoaded() {
+ return moduleSearchIndex
+ && packageSearchIndex
+ && typeSearchIndex
+ && memberSearchIndex
+ && tagSearchIndex;
+}
+
+// Workaround for scroll position not being included in browser history (8249133)
+document.addEventListener("DOMContentLoaded", function(e) {
+ var contentDiv = document.querySelector("div.flex-content");
+ window.addEventListener("popstate", function(e) {
+ if (e.state !== null) {
+ contentDiv.scrollTop = e.state;
+ }
+ });
+ window.addEventListener("hashchange", function(e) {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ });
+ contentDiv.addEventListener("scroll", function(e) {
+ var timeoutID;
+ if (!timeoutID) {
+ timeoutID = setTimeout(function() {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ timeoutID = null;
+ }, 100);
+ }
+ });
+ if (!location.hash) {
+ history.replaceState(contentDiv.scrollTop, document.title);
+ }
+});
diff --git a/docs/v0.8.2/javadoc/selenium/search.js b/docs/v0.8.2/javadoc/selenium/search.js
new file mode 100644
index 00000000..db3b2f4a
--- /dev/null
+++ b/docs/v0.8.2/javadoc/selenium/search.js
@@ -0,0 +1,354 @@
+/*
+ * Copyright (c) 2015, 2020, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+var noResult = {l: "No results found"};
+var loading = {l: "Loading search index..."};
+var catModules = "Modules";
+var catPackages = "Packages";
+var catTypes = "Classes and Interfaces";
+var catMembers = "Members";
+var catSearchTags = "Search Tags";
+var highlight = "$&";
+var searchPattern = "";
+var fallbackPattern = "";
+var RANKING_THRESHOLD = 2;
+var NO_MATCH = 0xffff;
+var MIN_RESULTS = 3;
+var MAX_RESULTS = 500;
+var UNNAMED = "";
+function escapeHtml(str) {
+ return str.replace(//g, ">");
+}
+function getHighlightedText(item, matcher, fallbackMatcher) {
+ var escapedItem = escapeHtml(item);
+ var highlighted = escapedItem.replace(matcher, highlight);
+ if (highlighted === escapedItem) {
+ highlighted = escapedItem.replace(fallbackMatcher, highlight)
+ }
+ return highlighted;
+}
+function getURLPrefix(ui) {
+ var urlPrefix="";
+ var slash = "/";
+ if (ui.item.category === catModules) {
+ return ui.item.l + slash;
+ } else if (ui.item.category === catPackages && ui.item.m) {
+ return ui.item.m + slash;
+ } else if (ui.item.category === catTypes || ui.item.category === catMembers) {
+ if (ui.item.m) {
+ urlPrefix = ui.item.m + slash;
+ } else {
+ $.each(packageSearchIndex, function(index, item) {
+ if (item.m && ui.item.p === item.l) {
+ urlPrefix = item.m + slash;
+ }
+ });
+ }
+ }
+ return urlPrefix;
+}
+function createSearchPattern(term) {
+ var pattern = "";
+ var isWordToken = false;
+ term.replace(/,\s*/g, ", ").trim().split(/\s+/).forEach(function(w, index) {
+ if (index > 0) {
+ // whitespace between identifiers is significant
+ pattern += (isWordToken && /^\w/.test(w)) ? "\\s+" : "\\s*";
+ }
+ var tokens = w.split(/(?=[A-Z,.()<>[\/])/);
+ for (var i = 0; i < tokens.length; i++) {
+ var s = tokens[i];
+ if (s === "") {
+ continue;
+ }
+ pattern += $.ui.autocomplete.escapeRegex(s);
+ isWordToken = /\w$/.test(s);
+ if (isWordToken) {
+ pattern += "([a-z0-9_$<>\\[\\]]*?)";
+ }
+ }
+ });
+ return pattern;
+}
+function createMatcher(pattern, flags) {
+ var isCamelCase = /[A-Z]/.test(pattern);
+ return new RegExp(pattern, flags + (isCamelCase ? "" : "i"));
+}
+var watermark = 'Search';
+$(function() {
+ var search = $("#search-input");
+ var reset = $("#reset-button");
+ search.val('');
+ search.prop("disabled", false);
+ reset.prop("disabled", false);
+ search.val(watermark).addClass('watermark');
+ search.blur(function() {
+ if ($(this).val().length === 0) {
+ $(this).val(watermark).addClass('watermark');
+ }
+ });
+ search.on('click keydown paste', function() {
+ if ($(this).val() === watermark) {
+ $(this).val('').removeClass('watermark');
+ }
+ });
+ reset.click(function() {
+ search.val('').focus();
+ });
+ search.focus()[0].setSelectionRange(0, 0);
+});
+$.widget("custom.catcomplete", $.ui.autocomplete, {
+ _create: function() {
+ this._super();
+ this.widget().menu("option", "items", "> :not(.ui-autocomplete-category)");
+ },
+ _renderMenu: function(ul, items) {
+ var rMenu = this;
+ var currentCategory = "";
+ rMenu.menu.bindings = $();
+ $.each(items, function(index, item) {
+ var li;
+ if (item.category && item.category !== currentCategory) {
+ ul.append("
Shakespeare is a Java implementation of Screenplay.
+It was mainly created to explain the basic concepts of Screenplay and hence is kept rather simple in its core.
+
+
+
+
+
Screenplay
+
+
+
A framework helping to write tests like screenplays.
+It is based on the ideas from Page Objects Refactored by Antony Marcano, Andy Palmer & John Ferguson Smart, with Jan Molak.
+
+
+
Screenplay does not replace any testing framework like JUnit, TestNG, Spock, RSpec, Jasmine etc.
+In fact, it works with any of these.
+Screenplay rather structures complex test code in a different way that makes it
+
+
+
+
+
more readably,
+
+
+
more reusable, and
+
+
+
more maintainable.
+
+
+
+
+
It does that mainly by taking a user-centric and object-oriented view on things.
+
+
+
In screenplay a user is represented by as an Actor.
+Actors can have Abilities.
+These enable them to do Tasks or answer Questions.
+
+
+
+
+
+
Figure 1. Screenplay Core Concepts
+
+
+
In screenplay each of these concepts—Actor, Ability, Task and Question—are objects which abstract from the actual actions.
+
+
+
Actions can be calling an API, clicking a link, fetching an email, waiting for something to appear.
+All these tiny noisy details are hidden within the Task or Question objects.
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/v0.8.2/manual/chapters/01-getting-started.html b/docs/v0.8.2/manual/chapters/01-getting-started.html
new file mode 100644
index 00000000..179f1ac9
--- /dev/null
+++ b/docs/v0.8.2/manual/chapters/01-getting-started.html
@@ -0,0 +1,708 @@
+
+
+
+
+
+
+
+Getting Started
+
+
+
+
+
+
+
+
+
Getting Started
+
+version 0.8.2
+
+
+
+
+
Requirements
+
+
+
In oder to use Shakespeare you need a JDK 11 or higher.
+
+
+
+
+
Dependencies
+
+
+
To use Shakespeare in your own project, you need to add it as a dependency to your project.
+The core module is a transient dependency of any other module.
+Hence, you don’t need to keep it once you add another module (e.g. selenium or retrofit)
+
+
+
+
+
+
Bill of Materials
+
+
If you want to use more than one module in the same project, you can use Shakespeare’s bill of materials (BOM) and omit the explicit version for the other modules.
+
+
+
\ No newline at end of file
diff --git a/docs/v0.8.2/manual/chapters/02-actors-with-abilities.html b/docs/v0.8.2/manual/chapters/02-actors-with-abilities.html
new file mode 100644
index 00000000..9070c1b3
--- /dev/null
+++ b/docs/v0.8.2/manual/chapters/02-actors-with-abilities.html
@@ -0,0 +1,710 @@
+
+
+
+
+
+
+
+Actors with Abilities
+
+
+
+
+
+
+
+
+
Actors with Abilities
+
+version 0.8.2
+
+
+
+
+
Actors
+
+
+
The central object in a Screenplay and Shakespeare is the Actor.
+Actors represent something or someone that interacts with the system under test.
+
+
+
There can be any number of Actors in a Screenplay (Test).
+To make different Actors easily identifiable, they have a name.
+The name can be explicitly given or will be randomly assigned.
+
+
+
Java
+
+
var robin = new Actor("Robin");
+
+
+
+
Kotlin
+
+
val robin = Actor("Robin")
+
+
+
+
Java
+
+
var user = new Actor();
+
+
+
+
Kotlin
+
+
val user = Actor()
+
+
+
+
+
+
Abilities
+
+
+
Actors may use Abilities to interact with the system under test.
+
+
+
Ability is a simple marker interface.
+Implementations should provide methods providing an object which allows interaction with the system under test.
+If that object is being generated on demand or simply wrapped by the Ability is up to the implementation.
class SayHelloWorld implements Task {
+
+ @Override
+ public void performAs(Actor actor) {
+ var logger = actor.uses(Log.class).getLogger();
+ logger.info("Hello World");
+ }
+}
+
+
+
+
Kotlin
+
+
class SayHelloWorld() : Task {
+ override fun performAs(actor: Actor) {
+ val logger = actor.uses(Log::class.java).logger
+ logger.info("Hello World")
+ }
+}
+
+
+
+
Java
+
+
tom.does(new SayHelloWorld());
+
+
+
+
Kotlin
+
+
tom.does(SayHelloWorld())
+
+
+
+
+
+
Tasks with Parameters
+
+
+
Some tasks require data to be executed.
+E.g. a SearchFor Task probably needs a query string, or an AddToCart Task might need a product identifier.
+
+
+
Such data can be added as properties of the Task.
+
+
+
Java
+
+
class SayHello implements Task {
+
+ private final String to;
+
+ public SayHello(String to) {
+ this.to = to;
+ }
+
+ @Override
+ public void performAs(Actor actor) {
+ var logger = actor.uses(Log.class).getLogger();
+ logger.info(String.format("Hello %s", to));
+ }
+}
+
+
+
+
Kotlin
+
+
data class SayHello(val to: String) : Task {
+ override fun performAs(actor: Actor) {
+ val logger = actor.uses(Log::class.java).logger
+ logger.info("Hello $to")
+ }
+}
+
+
+
+
As Tasks should not change over time and should be reusable, it is also possible to declare them as Java Records—given that you can use Java 17+ features.
+
+
+
Doing the Tasks is the same for Classes and Records.
+
+
+
Java
+
+
record SayHelloAsRecord(String to) implements Task {
+
+ @Override
+ public void performAs(Actor actor) {
+ var logger = actor.uses(Log.class).getLogger();
+ logger.info(String.format("Hello %s", to));
+ }
+}
mila.does { she -> she.uses(Log::class.java).logger.info("Hi") }
+
+
+
+
+
+
+
Note
+
+
+A Task should group complex interactions into a semantic unit of work.
+So declaring them as Lambdas might be useful for short-lived experiments or debugging, but is not generally advisable.
+
+
+
+
+
+
+
+
Abstraction Levels
+
+
+
Tasks are a powerful tool.
+A task can be as simple as clicking on a link and as complex as a double-opt-in registration process.
+Finding the right abstraction can be hard.
+This chapter contains some examples how to find the right level of abstraction for Tasks.
+
+
+
Grouping Interactions
+
+
The simplest kind of Tasks are those who group simple interactions with the system under test.
+
+
+
Let’s take a Task to log in to a website.
+This might consist of the following interactions with the website:
data class Login(private val username: String, private val password: String) : Task {
+
+ override fun performAs(actor: Actor) {
+ val webDriver = actor.uses(BrowseTheWeb::class.java).webDriver
+
+ webDriver.get(mockWebServer.url("/").toString()) // (1)
+
+ webDriver
+ .findElement(By.name("username")) // (2)
+ .sendKeys(username) // (3)
+ webDriver
+ .findElement(By.name("password")) // (4)
+ .sendKeys(password) // (5)
+ webDriver
+ .findElement(By.cssSelector(".login button")) // (6)
+ .click() // (7)
+ }
+
+ override fun toString(): String {
+ return "login as $username"
+ }
+}
+
+
+
+
+
+
Navigate to the website,
+
+
+
find the "username" input field,
+
+
+
write "john" into it,
+
+
+
find the "password" input field,
+
+
+
write "demo" into it,
+
+
+
find the login button,
+
+
+
click on it.
+
+
+
+
+
As you can see all the interactions are wrapped in the Task object.
+It has fields for the username and the password, so we can easily reuse the Task with other credentials.
+
+
+
+
Grouping Tasks
+
+
As the Actor is fully injected into the performAs method, it is also possible to do other tasks in a Task.
+
+
+
Let’s take a shop website as an example.
+In order to check out, there are several complex steps needed:
+
+
+
+
+
Add any product to the shopping cart,
+
+
+
navigate to the checkout page,
+
+
+
enter a delivery address,
+
+
+
enter valid payment details,
+
+
+
confirm the checkout.
+
+
+
+
+
All these steps could be Tasks in their own right, but if we want to test that the user is able to cancel the order after check out, we might want to bundle the steps into something like a Checkout Task.
+
+
+
+
+
+
Warning
+
+
+It is generally a bad idea to mix simple interactions with sub-tasks, as it makes finding problems much harder!
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/v0.8.2/manual/chapters/04-checking-questions.html b/docs/v0.8.2/manual/chapters/04-checking-questions.html
new file mode 100644
index 00000000..937d5677
--- /dev/null
+++ b/docs/v0.8.2/manual/chapters/04-checking-questions.html
@@ -0,0 +1,716 @@
+
+
+
+
+
+
+
+Checking Questions
+
+
+
+
+
+
+
+
+
Checking Questions
+
+version 0.8.2
+
+
+
+
+
Questions
+
+
+
Questions are pretty similar to [Tasks], but may return an answer.
+
+
+
They can be checked (answered) by an Actor.
+How the Actor finds the answer to a Question is defined in the answerAs(Actor) method of the Question.
+
+
+
Similar to the performAs(Actor) method of the Task, the Actor is given as an argument, so a Question can use all the Actor’s Abilities to find the answer.
class LoggedInState : Question<Boolean> {
+
+ override fun answerAs(actor: Actor): Boolean {
+ val webDriver = actor.uses(BrowseTheWeb::class.java).webDriver
+ return webDriver.findElements(By.linkText("Log Out")).isNotEmpty()
+ }
+
+ override fun toString(): String {
+ return "login state"
+ }
+}
+
+
+
+
While it is possible to put complex interactions in Questions it is generally advisable to keep them simple and independent.
+
+
+
Good Questions
+
+
Undoubtedly good questions do not change the state of the system under test in any way
+
+
+
+
+
Checking a web element is present,
+
+
+
performing a GET call on an HTTP API and return its body,
+
+
+
fetching email and retuning its content.
+
+
+
+
+
+
Ugly Questions
+
+
Doubtfully ugly questions don’t change the persisted state of the system under test, but change the local state.
+For example the current displayed view.
+Using such questions requires to check the state in following Tasks or Questions.
+
+
+
+
+
Navigate to the user’s profile page to check for data that is only visible there,
+
+
+
checking available products by switching to the search results page.
+
+
+
+
+
Especially in web applications this type of Questions are often unavoidable, but should be kept to a minimum.
+
+
+
+
Bad Questions
+
+
Changing the persistent state of the system under test should genrally be avoided and be left to Tasks.
+
+
+
+
+
Sending data to a backend API,
+
+
+
login to a web application,
+
+
+
deleting email.
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/v0.8.2/manual/chapters/05-retryables.html b/docs/v0.8.2/manual/chapters/05-retryables.html
new file mode 100644
index 00000000..b4fa500b
--- /dev/null
+++ b/docs/v0.8.2/manual/chapters/05-retryables.html
@@ -0,0 +1,680 @@
+
+
+
+
+
+
+
+Retryables
+
+
+
+
+
+
+
+
+
Retryables
+
+version 0.8.2
+
+
+
+
+
+
+
Some things take time.
+E.g. after creating an account, it might take some time for a confirmation email to arrive.
+
+
+
Shakespeare provides a generic way to wait for things to succeed: Retryables.
+
+
+
They can be used just like regular Tasks and Questions, but they additionally have a defined timeout after which an Actor will give up and an interval in which an Actor will retry.
+The default timeout is 2 seconds, the default interval is the 10th of the timeout.
+
+
+
+
+
+
Note
+
+
+Shakespeare’s Retryables are meant for things that a human user would need to retry as well.
+To wait for UI elements to show up, there are better usually more efficient ways available (e.g. in Selenium, Cypress etc.).
+
+
+
+
+
+
+
+
Retryable Tasks
+
+
+
A RetryableTask also has a set of acknowledged exceptions.
+By default, an Actor will ignore all Exceptions thrown in retries, but will immediately fail if it is an instance of an acknowledged Exception.
+
+
+
E.g. you might expect a NotFoundException but not a AuthorizationFailedException.
+So you can just add the latter to the acknowledgedExceptions.
+
+
+
+
+
Retryable Questions
+
+
+
A RetryableQuestion has a set of ignored Exceptions and an acceptable method.
+While any Exception thrown that is not in the set of ignored exceptions will break the retrying loop, the acceptable method will be called for each yielded answer.
+Only if the acceptable method returns true, the retrying will stop and return the (accepted) answer.
+
+
+
There is a default implementation of acceptable, which will a number of possible answers:
+
+
+
+
+
Optionals that are present,
+
+
+
non-empty Collections, Maps or Arrays,
+
+
+
any Boolean answer, and
+
+
+
anything that not null.
+
+
+
+
+
Checked in that order.
+
+
+
This default implementation might suit your needs already, but you can always override it with your own logic.
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/v0.8.2/manual/chapters/06-learning-remembering-facts.html b/docs/v0.8.2/manual/chapters/06-learning-remembering-facts.html
new file mode 100644
index 00000000..d6ec0e35
--- /dev/null
+++ b/docs/v0.8.2/manual/chapters/06-learning-remembering-facts.html
@@ -0,0 +1,831 @@
+
+
+
+
+
+
+
+Learning & Remembering Facts
+
+
+
+
+
+
+
+
+
Learning & Remembering Facts
+
+version 0.8.2
+
+
+
+
+
+
+
Facts are a way to add data to the Actor.
+After a Fact was learned, it can always be remembered by its class and be used to do Tasks or answer Questions.
Fact classes only need to implement the (empty) Fact marker interface.
+Apart from that they can be basically anything but should be immutable value objects or records.
+
+
+
Java
+
+
record PhoneNumber(String number) implements Fact {}
+
+
+
+
Kotlin
+
+
data class PhoneNumber(val number: String) : Fact
+
+
+
+
+
+
Relearning Facts
+
+
+
Note that an Actor cannot remember multiple instances of a Fact.
+When you call remember with two different instances of the same Fact class, the older one is being forgotten and replaced by the new one.
One great advantage of Fact classes is the possibility of adding static fields and methods.
+
+
+
E.g. you can put that one valid test credit card number in a public static CreditCard DEFAULT in your CreditCard Fact class:
+
+
+
Java
+
+
record CreditCard(String type, String number, YearMonth expiration) implements Fact {
+ public static CreditCard DEFAULT_VISA =
+ new CreditCard("visa", "4111111111111111", YearMonth.of(2026, 10));
+}
+
+
+
+
Kotlin
+
+
data class CreditCard(val type: String, val number: String, val expiration: YearMonth) : Fact {
+ companion object {
+ val DEFAULT_VISA =
+ CreditCard("visa", "4111111111111111", YearMonth.of(2026, 10))
+ }
+}
+
+
+
+
Or you can add a method to generate valid unique random email addresses to your EmailAddress Fact class:
+
+
+
Java
+
+
record EmailAddress(String address) implements Fact {
+ public static EmailAddress random() {
+ return new EmailAddress("%s@shakespeareframework.org".formatted(UUID.randomUUID()));
+ }
+}
+
+
+
+
Kotlin
+
+
data class EmailAddress(val address: String) : Fact {
+ companion object {
+ fun random() = EmailAddress("${UUID.randomUUID()}@shakespeareframework.org")
+ }
+}
+
+
+
+
+
+
Personalized Tasks/Questions
+
+
+
Facts can be used to provide an Actor with necessary information for certain Tasks and Questions instead of using [Tasks with Parameters].
+
+
+
By doing so, we can instruct an Actors to do something with their memory as context.
+
+
+
For example, to create an account we usually require a lot of personal information.
+To human testers, I can say "go create an account", and they will use their own data to do that.
+Using Facts we can achieve the same feel of a personal context.
+
+
+
In that case, an Actors learn their facts in the setup phase of a test.
+
+
+
+
+
+
Warning
+
+
+Using Facts in your Tasks and Questions can be a really nice experience.
+You don’t need to keep your test data at hand in you test code, but can confine it in the test’s setup phase.
+However, by doing so you might end up scrolling back and forth in order to understand a failing test.
+So you really want to limit this to data that is really owned by an Actor.
+
+
+
+
+
+
+
+
Learning by Doing
+
+
+
Another possible use case for Facts is to learn things while doing things.
+E.g. after finishing a shop’s checkout process it might be useful to remember the displayed order number.
+
+
+
In that case the Facts are learned as a side effect of a Task or a Question.
+
+
+
+
+
+
Warning
+
+
+Don’t overdo this!
+Side effects are not easy to keep track of.
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/v0.8.2/manual/chapters/07-reporting.html b/docs/v0.8.2/manual/chapters/07-reporting.html
new file mode 100644
index 00000000..52a4ce7b
--- /dev/null
+++ b/docs/v0.8.2/manual/chapters/07-reporting.html
@@ -0,0 +1,682 @@
+
+
+
+
+
+
+
+Reporting
+
+
+
+
+
+
+
+
+
Reporting
+
+version 0.8.2
+
+
+
+
+
+
+
Actors can report actions and their outcome via Reporters that can be added using the link:{javadoc-url}/core/org/shakespeareframework/Actor.html#informs(org.shakespeareframework.reporting.Reporter…))[informs(Reporter…) method.
+
+
+
Actors call each of their Reporters in the declared order for the following events:
+
+
+
+
+
When starting to do a Task or answer a Question,
+
+
+
when retrying a RetryableTask or RetryableQuestion,
+
+
+
when successfully finishing a Task or successfully answering a Question,
Uses the Slf4j Logger to print each action of the Actor.
+Successful actions will be logged as info, failure as warnings.
+Note that actions are only logged after finishing.
+
+
+
Each action is printed with
+
+
+
+
+
the Actor’s name,
+
+
+
the Task’s/Question’s toString output,
+
+
+
the result (success = ✓, failure = ✗, each retry = •),
+
+
+
the action’s duration (e.g. 245ms),
+
+
+
in case of a failure the causing exception’s simple class name (e.g. ElementNotFoundException),
+
+
+
in case of a successful question the given answer (e.g. → answer)
+
+
+
+
+
Sub Tasks and Questions are printed as a hierarchic tree.
+
+
+
Slf4jReporter example output
+
+
19:45:18.359 [Test worker] WARN Logan - Logan does login ✓ 1s15ms
+├── Logan does enter username ✓ 312ms
+├── Logan does enter password ✓ 432ms
+└── Logan does submit login form ✓ 43ms
+ └── Logan does confirm terms and conditions •✗ 245ms ElementNotFoundException
+19:45:19.876 [Test worker] INFO Logan - Logan checks login state ✓ 1s15ms → false
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/v0.8.2/manual/chapters/08-selenium.html b/docs/v0.8.2/manual/chapters/08-selenium.html
new file mode 100644
index 00000000..790edff3
--- /dev/null
+++ b/docs/v0.8.2/manual/chapters/08-selenium.html
@@ -0,0 +1,832 @@
+
+
+
+
+
+
+
+Browser Automation with Selenium
+
+
+
+
+
+
+
+
The Ability not only warps a WebDriver, but also manages it using a WebDriverSupplier which comes in different flavors for different scenarios (e.g. local debugging or continuous integration).
+
+
+
+
+
Setup
+
+
+
For Local Development
+
+
When you write your UI tests locally, it is quite useful (and also satisfying) to be able to watch the automation work in a local browser, checking the browser’s developer and logs.
+For this Shakespeare comes with the LocalWebDriverSupplier, which relies on a local installation of the browser.
+
+
+
It does take care of downloading the required binary, starting the browser as soon as the Actor actually uses it and closing it after the test case.
+
+
+
Java
+
+
var tim =
+ new Actor("Tim").can(new BrowseTheWeb(new LocalWebDriverSupplier(BrowserType.CHROME)));
+
+
+
+
Kotlin
+
+
val tim = Actor("Tim").can(BrowseTheWeb(LocalWebDriverSupplier(BrowserType.CHROME)))
var webDriverManager = WebDriverManager.edgedriver().browserInDocker();
+var alex =
+ new Actor("Alex")
+ .can(
+ new BrowseTheWeb(
+ new WebDriverManagerWebDriverSupplier(webDriverManager, BrowserType.CHROME)));
+
+
+
+
Kotlin
+
+
val webDriverManager = WebDriverManager.edgedriver().browserInDocker()
+val alex = Actor("Alex")
+ .can(
+ BrowseTheWeb(
+ WebDriverManagerWebDriverSupplier(webDriverManager, BrowserType.CHROME)
+ )
+ )
+
+
+
+
+
+
+
Base URL
+
+
+
Usually you will be testing one specific web application.
+In order to reset the browser to the URL of that application, you can give that base URL as an additional parameter to the WebDriverManager.
+The URL will be automatically called when you call getWebDriver.
+
+
+
Java
+
+
var browseTheWeb = new BrowseTheWeb(webDriverSupplier, "https://shakespeareframework.org/");
+
+assertThat(browseTheWeb.getWebDriver().getCurrentUrl())
+ .isEqualTo("https://shakespeareframework.org/");
+
+
+
+
Kotlin
+
+
val browseTheWeb = BrowseTheWeb(webDriverSupplier, "https://shakespeareframework.org/")
+
+assertThat(browseTheWeb.webDriver.currentUrl)
+ .isEqualTo("https://shakespeareframework.org/")
+
+
+
+
+
+
Additional Capabilities
+
+
+
All WebDriverSuppliers provide a constructor, which allows configuring additional Capabilities.
+
+
+
Java
+
+
var cameron =
+ new Actor("Cameron")
+ .can(
+ new BrowseTheWeb(
+ new LocalWebDriverSupplier(
+ BrowserType.CHROME, new ChromeOptions().addArguments("--headless"))));
An actor can be instructed to inform ScreenshotReporter (see [Reporting]).
+By default, this will create a screenshot of the current page whenever doing a Task or answering a Question needs to be retried or fails, but it can also be configured to report successes.
+
+
+
The screenshots can then be found at the configured reports path and are named <counter>-<actor>-<retry|failure|success>-<task|question string>.png, where the <task|question string> is a file system friendly version of the Task’s or Question’s toString().
+E.g. 001-imogen-success-latest_shakespeare_release_version.png.
+
+
+
Java
+
+
var reportsPath = Path.of("build", "reports", "shakespeare");
+var imogen =
+ new Actor("Imogen")
+ .can(
+ new BrowseTheWeb(
+ new WebDriverManagerWebDriverSupplier(
+ WebDriverManager.firefoxdriver().browserInDocker(), BrowserType.FIREFOX)))
+ .informs(new ScreenshotReporter(reportsPath, true));
+
+imogen.checks(new LatestShakespeareReleaseVersion());
+
+assertThat(reportsPath.resolve("001-imogen-success-latest_shakespeare_release_version.png"))
+ .isNotEmptyFile();
Shakespeare currently ships only with Jackson and Scalars, but you can add other ones.
+To do so, add the required dependency to your project, and use the generic addConverterFactory method to add it to your client.
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/v0.8.2/manual/chapters/diag-7a3e81e6682727c1b0fc0823c5b40be1.png b/docs/v0.8.2/manual/chapters/diag-7a3e81e6682727c1b0fc0823c5b40be1.png
new file mode 100644
index 00000000..d0dd9098
Binary files /dev/null and b/docs/v0.8.2/manual/chapters/diag-7a3e81e6682727c1b0fc0823c5b40be1.png differ
diff --git a/docs/v0.8.2/manual/diag-7a3e81e6682727c1b0fc0823c5b40be1.png b/docs/v0.8.2/manual/diag-7a3e81e6682727c1b0fc0823c5b40be1.png
new file mode 100644
index 00000000..d0dd9098
Binary files /dev/null and b/docs/v0.8.2/manual/diag-7a3e81e6682727c1b0fc0823c5b40be1.png differ
diff --git a/docs/v0.8.2/manual/index.html b/docs/v0.8.2/manual/index.html
new file mode 100644
index 00000000..18fe8a4a
--- /dev/null
+++ b/docs/v0.8.2/manual/index.html
@@ -0,0 +1,2178 @@
+
+
+
+
+
+
+
+
+
+Shakespeare Framework
+
+
+
+
+
+
+
+
+
+
Shakespeare is a Java implementation of Screenplay.
+It was mainly created to explain the basic concepts of Screenplay and hence is kept rather simple in its core.
A framework helping to write tests like screenplays.
+It is based on the ideas from Page Objects Refactored by Antony Marcano, Andy Palmer & John Ferguson Smart, with Jan Molak.
+
+
+
Screenplay does not replace any testing framework like JUnit, TestNG, Spock, RSpec, Jasmine etc.
+In fact, it works with any of these.
+Screenplay rather structures complex test code in a different way that makes it
+
+
+
+
+
more readably,
+
+
+
more reusable, and
+
+
+
more maintainable.
+
+
+
+
+
It does that mainly by taking a user-centric and object-oriented view on things.
+
+
+
In screenplay a user is represented by as an Actor.
+Actors can have Abilities.
+These enable them to do Tasks or answer Questions.
+
+
+
+
+
+
Figure 1. Screenplay Core Concepts
+
+
+
In screenplay each of these concepts—Actor, Ability, Task and Question—are objects which abstract from the actual actions.
+
+
+
Actions can be calling an API, clicking a link, fetching an email, waiting for something to appear.
+All these tiny noisy details are hidden within the Task or Question objects.
+The core module is a transient dependency of any other module.
+Hence, you don’t need to keep it once you add another module (e.g. selenium or retrofit)
+
If you want to use more than one module in the same project, you can use Shakespeare’s bill of materials (BOM) and omit the explicit version for the other modules.
The central object in a Screenplay and Shakespeare is the Actor.
+Actors represent something or someone that interacts with the system under test.
+
+
+
There can be any number of Actors in a Screenplay (Test).
+To make different Actors easily identifiable, they have a name.
+The name can be explicitly given or will be randomly assigned.
Actors may use Abilities to interact with the system under test.
+
+
+
Ability is a simple marker interface.
+Implementations should provide methods providing an object which allows interaction with the system under test.
+If that object is being generated on demand or simply wrapped by the Ability is up to the implementation.
Some tasks require data to be executed.
+E.g. a SearchFor Task probably needs a query string, or an AddToCart Task might need a product identifier.
+
+
+
Such data can be added as properties of the Task.
+
+
+
Java
+
+
class SayHello implements Task {
+
+ private final String to;
+
+ public SayHello(String to) {
+ this.to = to;
+ }
+
+ @Override
+ public void performAs(Actor actor) {
+ var logger = actor.uses(Log.class).getLogger();
+ logger.info(String.format("Hello %s", to));
+ }
+}
+
+
+
+
Kotlin
+
+
data class SayHello(val to: String) : Task {
+ override fun performAs(actor: Actor) {
+ val logger = actor.uses(Log::class.java).logger
+ logger.info("Hello $to")
+ }
+}
+
+
+
+
As Tasks should not change over time and should be reusable, it is also possible to declare them as Java Records—given that you can use Java 17+ features.
+
+
+
Doing the Tasks is the same for Classes and Records.
+
+
+
Java
+
+
record SayHelloAsRecord(String to) implements Task {
+
+ @Override
+ public void performAs(Actor actor) {
+ var logger = actor.uses(Log.class).getLogger();
+ logger.info(String.format("Hello %s", to));
+ }
+}
mila.does { she -> she.uses(Log::class.java).logger.info("Hi") }
+
+
+
+
+
+
+
+
+
+A Task should group complex interactions into a semantic unit of work.
+So declaring them as Lambdas might be useful for short-lived experiments or debugging, but is not generally advisable.
+
Tasks are a powerful tool.
+A task can be as simple as clicking on a link and as complex as a double-opt-in registration process.
+Finding the right abstraction can be hard.
+This chapter contains some examples how to find the right level of abstraction for Tasks.
data class Login(private val username: String, private val password: String) : Task {
+
+ override fun performAs(actor: Actor) {
+ val webDriver = actor.uses(BrowseTheWeb::class.java).webDriver
+
+ webDriver.get(mockWebServer.url("/").toString()) (1)
+
+ webDriver
+ .findElement(By.name("username")) (2)
+ .sendKeys(username) (3)
+ webDriver
+ .findElement(By.name("password")) (4)
+ .sendKeys(password) (5)
+ webDriver
+ .findElement(By.cssSelector(".login button")) (6)
+ .click() (7)
+ }
+
+ override fun toString(): String {
+ return "login as $username"
+ }
+}
+
+
+
+
+
+
1
+
Navigate to the website,
+
+
+
2
+
find the "username" input field,
+
+
+
3
+
write "john" into it,
+
+
+
4
+
find the "password" input field,
+
+
+
5
+
write "demo" into it,
+
+
+
6
+
find the login button,
+
+
+
7
+
click on it.
+
+
+
+
+
As you can see all the interactions are wrapped in the Task object.
+It has fields for the username and the password, so we can easily reuse the Task with other credentials.
As the Actor is fully injected into the performAs method, it is also possible to do other tasks in a Task.
+
+
+
Let’s take a shop website as an example.
+In order to check out, there are several complex steps needed:
+
+
+
+
+
Add any product to the shopping cart,
+
+
+
navigate to the checkout page,
+
+
+
enter a delivery address,
+
+
+
enter valid payment details,
+
+
+
confirm the checkout.
+
+
+
+
+
All these steps could be Tasks in their own right, but if we want to test that the user is able to cancel the order after check out, we might want to bundle the steps into something like a Checkout Task.
+
+
+
+
+
+
+
+
+It is generally a bad idea to mix simple interactions with sub-tasks, as it makes finding problems much harder!
+
Questions are pretty similar to Tasks, but may return an answer.
+
+
+
They can be checked (answered) by an Actor.
+How the Actor finds the answer to a Question is defined in the answerAs(Actor) method of the Question.
+
+
+
Similar to the performAs(Actor) method of the Task, the Actor is given as an argument, so a Question can use all the Actor’s Abilities to find the answer.
Doubtfully ugly questions don’t change the persisted state of the system under test, but change the local state.
+For example the current displayed view.
+Using such questions requires to check the state in following Tasks or Questions.
+
+
+
+
+
Navigate to the user’s profile page to check for data that is only visible there,
+
+
+
checking available products by switching to the search results page.
+
+
+
+
+
Especially in web applications this type of Questions are often unavoidable, but should be kept to a minimum.
Some things take time.
+E.g. after creating an account, it might take some time for a confirmation email to arrive.
+
+
+
Shakespeare provides a generic way to wait for things to succeed: Retryables.
+
+
+
They can be used just like regular Tasks and Questions, but they additionally have a defined timeout after which an Actor will give up and an interval in which an Actor will retry.
+The default timeout is 2 seconds, the default interval is the 10th of the timeout.
+
+
+
+
+
+
+
+
+Shakespeare’s Retryables are meant for things that a human user would need to retry as well.
+To wait for UI elements to show up, there are better usually more efficient ways available (e.g. in Selenium, Cypress etc.).
+
A RetryableTask also has a set of acknowledged exceptions.
+By default, an Actor will ignore all Exceptions thrown in retries, but will immediately fail if it is an instance of an acknowledged Exception.
+
+
+
E.g. you might expect a NotFoundException but not a AuthorizationFailedException.
+So you can just add the latter to the acknowledgedExceptions.
A RetryableQuestion has a set of ignored Exceptions and an acceptable method.
+While any Exception thrown that is not in the set of ignored exceptions will break the retrying loop, the acceptable method will be called for each yielded answer.
+Only if the acceptable method returns true, the retrying will stop and return the (accepted) answer.
+
+
+
There is a default implementation of acceptable, which will a number of possible answers:
+
+
+
+
+
Optionals that are present,
+
+
+
non-empty Collections, Maps or Arrays,
+
+
+
any Boolean answer, and
+
+
+
anything that not null.
+
+
+
+
+
Checked in that order.
+
+
+
This default implementation might suit your needs already, but you can always override it with your own logic.
Facts are a way to add data to the Actor.
+After a Fact was learned, it can always be remembered by its class and be used to do Tasks or answer Questions.
Fact classes only need to implement the (empty) Fact marker interface.
+Apart from that they can be basically anything but should be immutable value objects or records.
+
+
+
Java
+
+
record PhoneNumber(String number) implements Fact {}
Note that an Actor cannot remember multiple instances of a Fact.
+When you call remember with two different instances of the same Fact class, the older one is being forgotten and replaced by the new one.
Facts can be used to provide an Actor with necessary information for certain Tasks and Questions instead of using Tasks with Parameters.
+
+
+
By doing so, we can instruct an Actors to do something with their memory as context.
+
+
+
For example, to create an account we usually require a lot of personal information.
+To human testers, I can say "go create an account", and they will use their own data to do that.
+Using Facts we can achieve the same feel of a personal context.
+
+
+
In that case, an Actors learn their facts in the setup phase of a test.
+
+
+
+
+
+
+
+
+Using Facts in your Tasks and Questions can be a really nice experience.
+You don’t need to keep your test data at hand in you test code, but can confine it in the test’s setup phase.
+However, by doing so you might end up scrolling back and forth in order to understand a failing test.
+So you really want to limit this to data that is really owned by an Actor.
+
Another possible use case for Facts is to learn things while doing things.
+E.g. after finishing a shop’s checkout process it might be useful to remember the displayed order number.
+
+
+
In that case the Facts are learned as a side effect of a Task or a Question.
+
+
+
+
+
+
+
+
+Don’t overdo this!
+Side effects are not easy to keep track of.
+
Actors can report actions and their outcome via Reporters that can be added using the link:../javadoc/core/org/shakespeareframework/Actor.html#informs(org.shakespeareframework.reporting.Reporter…))[informs(Reporter…) method.
+
+
+
Actors call each of their Reporters in the declared order for the following events:
+
+
+
+
+
When starting to do a Task or answer a Question,
+
+
+
when retrying a RetryableTask or RetryableQuestion,
+
+
+
when successfully finishing a Task or successfully answering a Question,
Uses the Slf4j Logger to print each action of the Actor.
+Successful actions will be logged as info, failure as warnings.
+Note that actions are only logged after finishing.
+
+
+
Each action is printed with
+
+
+
+
+
the Actor’s name,
+
+
+
the Task’s/Question’s toString output,
+
+
+
the result (success = ✓, failure = ✗, each retry = •),
+
+
+
the action’s duration (e.g. 245ms),
+
+
+
in case of a failure the causing exception’s simple class name (e.g. ElementNotFoundException),
+
+
+
in case of a successful question the given answer (e.g. → answer)
+
+
+
+
+
Sub Tasks and Questions are printed as a hierarchic tree.
+
+
+
Slf4jReporter example output
+
+
19:45:18.359 [Test worker] WARN Logan - Logan does login ✓ 1s15ms
+├── Logan does enter username ✓ 312ms
+├── Logan does enter password ✓ 432ms
+└── Logan does submit login form ✓ 43ms
+ └── Logan does confirm terms and conditions •✗ 245ms ElementNotFoundException
+19:45:19.876 [Test worker] INFO Logan - Logan checks login state ✓ 1s15ms → false
The Ability not only warps a WebDriver, but also manages it using a WebDriverSupplier which comes in different flavors for different scenarios (e.g. local debugging or continuous integration).
When you write your UI tests locally, it is quite useful (and also satisfying) to be able to watch the automation work in a local browser, checking the browser’s developer and logs.
+For this Shakespeare comes with the LocalWebDriverSupplier, which relies on a local installation of the browser.
+
+
+
It does take care of downloading the required binary, starting the browser as soon as the Actor actually uses it and closing it after the test case.
+
+
+
Java
+
+
var tim =
+ new Actor("Tim").can(new BrowseTheWeb(new LocalWebDriverSupplier(BrowserType.CHROME)));
+
+
+
+
Kotlin
+
+
val tim = Actor("Tim").can(BrowseTheWeb(LocalWebDriverSupplier(BrowserType.CHROME)))
var webDriverManager = WebDriverManager.edgedriver().browserInDocker();
+var alex =
+ new Actor("Alex")
+ .can(
+ new BrowseTheWeb(
+ new WebDriverManagerWebDriverSupplier(webDriverManager, BrowserType.CHROME)));
+
+
+
+
Kotlin
+
+
val webDriverManager = WebDriverManager.edgedriver().browserInDocker()
+val alex = Actor("Alex")
+ .can(
+ BrowseTheWeb(
+ WebDriverManagerWebDriverSupplier(webDriverManager, BrowserType.CHROME)
+ )
+ )
Usually you will be testing one specific web application.
+In order to reset the browser to the URL of that application, you can give that base URL as an additional parameter to the WebDriverManager.
+The URL will be automatically called when you call getWebDriver.
+
+
+
Java
+
+
var browseTheWeb = new BrowseTheWeb(webDriverSupplier, "https://shakespeareframework.org/");
+
+assertThat(browseTheWeb.getWebDriver().getCurrentUrl())
+ .isEqualTo("https://shakespeareframework.org/");
+
+
+
+
Kotlin
+
+
val browseTheWeb = BrowseTheWeb(webDriverSupplier, "https://shakespeareframework.org/")
+
+assertThat(browseTheWeb.webDriver.currentUrl)
+ .isEqualTo("https://shakespeareframework.org/")
All WebDriverSuppliers provide a constructor, which allows configuring additional Capabilities.
+
+
+
Java
+
+
var cameron =
+ new Actor("Cameron")
+ .can(
+ new BrowseTheWeb(
+ new LocalWebDriverSupplier(
+ BrowserType.CHROME, new ChromeOptions().addArguments("--headless"))));
An actor can be instructed to inform ScreenshotReporter (see Reporting).
+By default, this will create a screenshot of the current page whenever doing a Task or answering a Question needs to be retried or fails, but it can also be configured to report successes.
+
+
+
The screenshots can then be found at the configured reports path and are named <counter>-<actor>-<retry|failure|success>-<task|question string>.png, where the <task|question string> is a file system friendly version of the Task’s or Question’s toString().
+E.g. 001-imogen-success-latest_shakespeare_release_version.png.
+
+
+
Java
+
+
var reportsPath = Path.of("build", "reports", "shakespeare");
+var imogen =
+ new Actor("Imogen")
+ .can(
+ new BrowseTheWeb(
+ new WebDriverManagerWebDriverSupplier(
+ WebDriverManager.firefoxdriver().browserInDocker(), BrowserType.FIREFOX)))
+ .informs(new ScreenshotReporter(reportsPath, true));
+
+imogen.checks(new LatestShakespeareReleaseVersion());
+
+assertThat(reportsPath.resolve("001-imogen-success-latest_shakespeare_release_version.png"))
+ .isNotEmptyFile();
Shakespeare currently ships only with Jackson and Scalars, but you can add other ones.
+To do so, add the required dependency to your project, and use the generic addConverterFactory method to add it to your client.
+