robotframework-apex 0.0.0__py3-none-any.whl

BrowserApex/cli/commands/parse.py

@@ -0,0 +1,25 @@
+import typer
+from typing import Annotated
+import yaml
+from rich import print
+from pathlib import Path
+
+#from BrowserApex.cli.utils import get_template
+from BrowserApex.cli.main import app
+from BrowserApex.cli.apex.grammar import parse_apex_file
+
+@app.command(name='parse')
+def project_parse(
+    pagefile: Annotated[str, typer.Argument(help="The filename of exported page (yaml, apx)")]
+    ):
+    """
+    Parse file and dump ast.
+
+    """
+    page = None
+
+    fn = Path(pagefile)
+    if fn.suffix == '.apx':
+        page = parse_apex_file(fn)
+
+    print(page)

BrowserApex/cli/commands/show.py

@@ -0,0 +1,63 @@
+import typer
+from rich import print
+from typing import Annotated
+from rich.table import Table
+from pathlib import Path
+
+from BrowserApex.cli.main import app
+from BrowserApex.cli.apex import parse_yaml_file, parse_apex_file
+
+@app.command(name='show')
+def project_show(
+    pagefile: Annotated[str, typer.Argument(help="The filename of exported page (yaml)")]
+    ):
+    """
+    Show project.
+
+    """
+    data = None
+    fn = Path(pagefile)
+    match fn.suffix:
+        case '.apx':
+            page = parse_apex_file(fn)
+        case '.yaml' | '.yml':
+            page = parse_yaml_file(fn)
+        case _:
+            raise RuntimeWarning("Unsupported file")
+
+    print("Page:")
+    print(f"id: {page.component_id}")
+    print(f"name: {page.name}")
+    print(f"alias: {page.alias}")
+
+
+    table = Table(title='Regions')
+    table.add_column("Component ID")
+    table.add_column("Name")
+    table.add_column("Type")
+    table.add_column("Template")
+    table.add_column("Parent")
+
+    for region in page.regions:
+        table.add_row(str(region.component_id), region.name, region.type, region.appearance['template'],region.layout['parentRegion'])
+
+    print(table)
+    
+    table = Table(title='Page items')
+    table.add_column("Seq.")
+    table.add_column("Name")
+    table.add_column("Type")
+    table.add_column("Label")
+    table.add_column("Region")
+    for pageitem in page.page_items:
+        table.add_row( str(pageitem.layout['sequence']), pageitem.name, pageitem.type, pageitem.label.get('label', '[red]?[/red]'), pageitem.layout['region'] ) 
+    print(table)
+
+    table = Table(title='Buttons')
+    table.add_column("Seq.")
+    table.add_column("Name")
+    table.add_column("Label")
+    table.add_column("Region")
+    for button in page.buttons:
+        table.add_row(str(button.layout['sequence']), button['buttonName'], button['label'], button.layout['region'])
+    print(table)

BrowserApex/cli/main.py

@@ -0,0 +1,24 @@
+import typer
+from dotenv import load_dotenv
+from BrowserApex import __VERSION__
+
+load_dotenv()
+
+app = typer.Typer(
+    help=f"""CLI for supporting development of Page Object Models.
+
+Page exported as readable format (yaml) is used as source for generating POM resources for RobotFramework.
+
+Version: {__VERSION__}
+""",
+    add_completion=True)
+
+from BrowserApex.cli import commands
+
+
+def main():                   # pragma: no cover
+    app()
+
+
+if __name__ == '__main__':    # pragma: no cover
+    main()

BrowserApex/cli/templates/custom-settings.template

@@ -0,0 +1 @@
+Resource   ../master.resource

BrowserApex/cli/templates/keywords.template

@@ -0,0 +1 @@
+# TODO: KEYWORDS

BrowserApex/cli/templates/pageobject.template

@@ -0,0 +1,12 @@
+*** Settings ***
+### PAGEGEN:BEGIN:SETTINGS ------------------------------------------
+### PAGEGEN:END:SETTINGS --------------------------------------------
+{% include "custom-settings.template" %}
+
+*** Variables ***
+### PAGEGEN:BEGIN:VARIABLES -----------------------------------------
+### PAGEGEN:END:VARIABLES -------------------------------------------
+
+*** Keywords ***
+### PAGEGEN:BEGIN:KEYWORDS ------------------------------------------
+### PAGEGEN:END:KEYWORDS --------------------------------------------

BrowserApex/cli/templates/pageobjects-resource.template

@@ -0,0 +1,3 @@
+*** Settings ***
+### PAGEGEN:BEGIN:RESOURCES -----------------------------------------
+### PAGEGEN:END:RESOURCES -------------------------------------------

BrowserApex/cli/templates/rfapex.toml.template

@@ -0,0 +1,3 @@
+[output]
+folder = "pageobjects"
+mainresource = "pageobjects.resource"

BrowserApex/cli/templates/settings.template

@@ -0,0 +1,2 @@
+# TODO: SETTINGS
+# BLA

BrowserApex/cli/templates/variables.template

@@ -0,0 +1,9 @@
+{% for block in blocks.values() %}
+{%- if block.fields %}
+&{{ '{' }}{{page.component_id}}_{{ block.name | upper | replace(" ","_") }}_FIELDS{{ '}' }}
+{%- for label, name, type in block.fields %}
+...    {{ label }}={{ name }}:{{ type | replace(" ","") }}
+{%- endfor -%}
+{%- endif -%}
+
+{% endfor %}

BrowserApex/cli/utils.py

@@ -0,0 +1,41 @@
+from pathlib import Path
+import tomllib
+from jinja2 import FileSystemLoader, Environment, ChoiceLoader, PackageLoader, TemplateNotFound, TemplateSyntaxError
+
+def get_config_path():
+    path = Path().cwd()
+    root = path.drive + path.root
+    while str(path) != str(root):
+        if (path / "rfapex.toml").exists():
+            return path
+        path = path.parent
+
+    return None
+
+def get_config(path=None):
+    if path is None:
+        path = get_config_path()
+
+    with open(path / "rfapex.toml", "rb") as f:
+        cnf = tomllib.load(f)
+    return cnf
+
+
+def get_template(template_name, template_path: Path):
+    default_loader = ChoiceLoader(
+        [FileSystemLoader(template_path / "templates"), PackageLoader(__package__, "templates")]
+    )
+    env = Environment(loader=default_loader)
+    if not template_name.endswith(".template") and not template_name.endswith(".sample"):
+        template_name += ".template"
+    try:
+        template = env.get_template(template_name)
+        return template
+    except TemplateNotFound:
+        print("Template not found")
+        return None
+
+    except TemplateSyntaxError:
+        print("Template has syntax error")
+        return None
+    

BrowserApex/version.py

@@ -0,0 +1 @@
+__VERSION__ = "0.0.0"

robotframework_apex-0.0.0.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: robotframework-apex
+Version: 0.0.0
+Summary: Robot Framework Browser extension library supporting Oracle APEX application using Page Object Model.
+Author: Maurice Koster
+Author-email: Maurice Koster <maurice@mauricekoster.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Testing
+Classifier: Framework :: Robot Framework
+Classifier: Framework :: Robot Framework :: Library
+Requires-Dist: robotframework>=7.1.1,<9.0.0
+Requires-Dist: robotframework-browser>=20.0.0,<21.0.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=15.0.0
+Requires-Dist: typer>=0.26.8
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: python-dotenv
+Requires-Dist: parsimonious>=0.11.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# robotframework-apex
+Supporting library to control Oracle APEX applications usin Page Object Model
+
+
+## Apex library
+
+Depends on Browser library `robotframework-browser`
+
+
+## rfapex command line tool
+

robotframework_apex-0.0.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+BrowserApex/__init__.py,sha256=ms01r5JoP5KWfz-06h54xB8S93OWSVcdlPVo8MUFN-U,66
+BrowserApex/browser.py,sha256=2xtLPj7hlDu47mtCP-pMNqhY3IStchR0np_qD4gTdYk,23374
+BrowserApex/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+BrowserApex/cli/apex/__init__.py,sha256=7qiVg8824UUgxnxU8AGeu90rXD1AgMBs6QkEpjA34jY,96
+BrowserApex/cli/apex/apexlang-26.1.peg,sha256=MkaV5oPG6q5nHnbgH61Q4MQhResTTqtAexi7UaK9CBA,26825
+BrowserApex/cli/apex/ebnf/apexlang-26.1.ebnf,sha256=EvQGd6cohMQR8xFXpOFsb-N3deOkBVR-r5B3IciYjpk,1140535
+BrowserApex/cli/apex/grammar.py,sha256=fwM99X0kQ0AANXxOsTscdqjLVK904jw-2Y_iNXQYXvw,31320
+BrowserApex/cli/apex/objects.py,sha256=Lj1g7GnlYt6Upz5q4uoGaKRFyMJeqPHfioKpIUn0cAI,7224
+BrowserApex/cli/apex/reader.py,sha256=Hpr2tsEdq0DpZTESGpw7ZcVc1acfHSOwOdImizh7BBI,4667
+BrowserApex/cli/commands/__init__.py,sha256=XMQnuYkSGP06V-5DrJhsb_ENh4FHIAkLV7axJPl-kOI,101
+BrowserApex/cli/commands/config.py,sha256=7FAOdc91Ahv0jF8sCY8a-rPD0IT7ztgmykPo34nNei8,359
+BrowserApex/cli/commands/dump.py,sha256=XzqlM73kxTSX8CXFt8Y1hvrzUh51mUmcfdrP-W-222E,474
+BrowserApex/cli/commands/generate.py,sha256=n-6yxHqiK8xle35w3q8OSlNjuz7X5IzPoIBFuPEuxKg,5412
+BrowserApex/cli/commands/parse.py,sha256=he_wkNSRCqDC2kvHQlBP9DKIoy588AICPgzNWVaoNK0,560
+BrowserApex/cli/commands/show.py,sha256=36rDmm0V0Dofe17dMdr1Wvso-_KgUxAE35RyRVLkwjE,1893
+BrowserApex/cli/main.py,sha256=GWeI_xABHHuSmo8HL8UeesdTg6NDYWtFaV0GzDIbR84,504
+BrowserApex/cli/templates/custom-settings.template,sha256=9y6iQSmTZob4JR5hjJyufBtLTWY25t6UQWD_Q3dJGXY,29
+BrowserApex/cli/templates/keywords.template,sha256=-aJX1C42yk-SlweL_WJriK0X5ypMWczTowxbcAoW8Ts,16
+BrowserApex/cli/templates/pageobject.template,sha256=b8Sf0Hv6P1Ny24_5xCZEHKk_SznLtT-DWkI9q8AOolg,514
+BrowserApex/cli/templates/pageobjects-resource.template,sha256=DjNaeF329R5fJqnJp49qHQGCriKegFLTtIWtfvKwvf0,156
+BrowserApex/cli/templates/rfapex.toml.template,sha256=qR1c0CQERPCbc2-0lCvd2HUiYBXkoA_BSdqgvSHsgnY,69
+BrowserApex/cli/templates/settings.template,sha256=IirGAjTlX5U-ETmZJM8D8C18Lug2nSIUN4709Rk-TtE,22
+BrowserApex/cli/templates/variables.template,sha256=raSvBqKz2KEzvRn0_P1W5CskK62HOf7Ya1xLIU8ees0,296
+BrowserApex/cli/utils.py,sha256=fKoj8ballm8b1EU2EHshh5fUaR3OFg3UaHf9xzPCdcQ,1196
+BrowserApex/keywords/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+BrowserApex/keywords/commands.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+BrowserApex/version.py,sha256=CLZHscZt3iUUkjyvg0pLZr6X8pfFpnXM7naghJiVoKA,21
+robotframework_apex-0.0.0.dist-info/licenses/LICENSE,sha256=QnzXbUcFpJo0hQP9aj6LLOqS9DYefOZiLzzqxfswT44,1071
+robotframework_apex-0.0.0.dist-info/WHEEL,sha256=ZFFp7t7R4RYQ5KYZkmiFWoQvHay7SrTmn-6ZYfoFZ3U,80
+robotframework_apex-0.0.0.dist-info/entry_points.txt,sha256=n-EIvIpt-3cuBPp3Jv_0iLWaFVqQseEBYHeDZ-dpMWk,55
+robotframework_apex-0.0.0.dist-info/METADATA,sha256=Q-RvWl0elE9Ji2GI3O7xA1uWr69Vzl5pcoJ0DIQYqWY,1142
+robotframework_apex-0.0.0.dist-info/RECORD,,

robotframework_apex-0.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.7
+Root-Is-Purelib: true
+Tag: py3-none-any

robotframework_apex-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+apexcli = BrowserApex.cli.main:main
+

robotframework_apex-0.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maurice Koster
+
+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.