{"id":23974652,"url":"https://github.com/hal/berg","last_synced_at":"2025-10-09T20:12:27.769Z","repository":{"id":69084680,"uuid":"596954635","full_name":"hal/berg","owner":"hal","description":"HAL test suite based on Cypress","archived":false,"fork":false,"pushed_at":"2025-10-01T01:41:15.000Z","size":26346,"stargazers_count":1,"open_issues_count":45,"forks_count":13,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-10-01T03:35:10.705Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"https://hal.github.io/berg/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-03T09:50:47.000Z","updated_at":"2025-09-25T08:03:29.000Z","dependencies_parsed_at":"2023-10-15T02:43:54.392Z","dependency_job_id":"dd57c78e-2faa-4264-bde2-8ccaf349240d","html_url":"https://github.com/hal/berg","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hal/berg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fberg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fberg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fberg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fberg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hal","download_url":"https://codeload.github.com/hal/berg/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fberg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002017,"owners_count":26083258,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest"],"created_at":"2025-01-07T05:48:01.143Z","updated_at":"2025-10-09T20:12:27.759Z","avatar_url":"https://github.com/hal.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Berg\n\nBerg is a test-suite for [HAL Management Console](https://github.com/hal/console) based on [Cypress](https://www.cypress.io) UI test automation. Berg as a name is heavily inspired by Gutenberg, inventor of printing press :) (printing press -\u003e press -\u003e Cypress).\n\n# Technological Stack\n\n## NodeJS\n\nNode (https://nodejs.org/en/) is the JavaScript runtime engine used to run Berg, since Cypress is built only for JavaScript.\n\n## Cypress\n\nCypress (https://www.cypress.io) is the main automation framework used for developing, running \u0026 reporting tests. Main benefit of Cypress is, that it is bundling the testing code directly into the system (browser) under testing. Since JavaScript is the main language used by modern browsers, the test execution is swift, stable and less environment error-prone as in standard (Selenium + WebDriver) UI automation tools.\n\n## TestContainers\n\nTestContainers (https://github.com/testcontainers/testcontainers-node) serves to launch \u0026 manage test scoped containers. Currently following containers are being used for testing:\n\n- [Standalone HAL image](https://quay.io/repository/halconsole/hal) used for most of the UI testing. It is a standalone HAL binary delivered by a container image that will be connected to a running WildFly server (that exposes management interface)\n- [WildFly Server Image](https://quay.io/repository/halconsole/wildfly) used for resource management. Exposes management interfaces onto which the Standalone HAL Image connects.\n- DB Images (such as [postgres](https://hub.docker.com/_/postgres)) serving (mostly) to run DB instances, that are being used in the datasource related tests.\n\n# Requirements\n\nFollowing tools are required to run the test suite\n\n- [NodeJS](https://nodejs.org/en/) as a runtime environment\n  - recommended version is 16, in other versions you can get errors like `Unable to detect compiler type`\n  - [Node Version Manager (nvm)](https://github.com/nvm-sh/nvm) is recommended optional tool to install \u0026 manage multiple Node environments\n- [npx](https://github.com/npm/npx) CLI tool used to exeute binaries from project's `node_modules` directly (instead of providing absolute/relative path to the commannds). It is used in multiple build steps.\n- [Podman](https://podman.io) | [Docker](https://www.docker.com) as a container runtime used by TestContainers. Note that when using Podman as container runtime you may need to export following environment variables and start podman socket:\n  - `export TESTCONTAINERS_RYUK_DISABLED=true`\n  - `export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock`\n    - the path can be found by command `podman info --debug` and look for `path` in `remoteSocket` section.\n  - `systemctl --user start podman.socket`\n- Java. Yes we'll need Java to write deployments/applications that will be deployed onto the running WildFly container.\n- [Maven](https://maven.apache.org). Yes, we'll need Maven to ease up the development of the deployed applications \u0026 downloading needed JDBC drivers for datasource \u0026 drivers UI tests. Maven is mostly used embedded by [node-maven](https://github.com/headcr4sh/node-maven) JS wrapper to execute Maven \u0026 Java related tasks into the build automation.\n\n# How to build \u0026 run\n\n- Make sure you have all the tools from [Requirements](#requirements) installed\n- Run\n\n```\nnpm install\n```\n\nin the root directory to download all of the NPM dependencies specified in `package.json`\n\n- If you want to run Cypress developer console with the loaded spec files, run\n\n```\nnpm run develop\n```\n\n- If you want to execute whole testsuite, navigate to `packages/testsuite` and from within that directory execute `npm test`\n  - It is also possible to run on specific browser by supplying `--browser` argument, e.g\n  ```\n  npm test -- --browser=chrome\n  ```\n  - It is also possible to reduce the amount of specs executed by passing `--specs` flag. This flag must be relative to the `packages/testsuite` directory and supports glob patterns, e.g to execute only `ejb` related tests, run\n  ```\n  npm test -- --specs=\"cypress/e2e/ejb/*.cy.ts\"\n  ```\n  - If you wish to run the test suite against custom HAL or WildFly images, you can use `HAL_IMAGE` and `WILDFLY_IMAGE` environment variables to specify custom images, e.g\n  ```\n  HAL_IMAGE=quay.io/myorg/hal WILDFLY_IMAGE=quay.io/myorg/wildfly npm test ...\n  ```\n\n- For debugging purposes videos (and screenshots) of failed tests are stored after the test run (works only with chrome).\n\n## Available environment properties\n\nFollowing is a table of supported environment properties that can be used when running the testsuite.\n\n| Property name    | Default value                                   | Description                                                                                   |\n| :--------------- | :---------------------------------------------- | :-------------------------------------------------------------------------------------------- |\n| `HAL_IMAGE`      | `quay.io/halconsole/hal-development:latest`     | [HAL standalone image](https://hal.github.io/documentation/get-started/#container) to be used |\n| `WILDFLY_IMAGE`  | `quay.io/halconsole/wildfly-development:latest` | WildFly/JBoss EAP image to be used                                                            |\n| `KEYCLOAK_IMAGE` | `quay.io/keycloak/keycloak:latest`              | Keycloak/RH-SSO image to be used for OIDC tests                                               |\n| `POSTGRES_IMAGE` | `docker.io/library/postgres:latest`             | PostgreSQL image to be used for datasource tests                                              |\n| `MYSQL_IMAGE`    | `docker.io/library/mysql:latest`                | MySQL image to be used for datasource tests                                                   |\n| `MARIADB_IMAGE`  | `docker.io/library/mariadb:latest`              | MariaDB image to be used for datasource tests                                                 |\n| `MSSQL_IMAGE`    | `mcr.microsoft.com/mssql/server:2022-latest`    | Microsoft SQL Server image to be used for datasource tests                                    |\n\n## Custom method documentation\n\nDocumentation can be generated by following command in root of this repository\n\n```\nnpm run docs\n```\n\n# Contributing\n\nSee contributing guide: [CONTRIBUTING.md](CONTRIBUTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhal%2Fberg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhal%2Fberg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhal%2Fberg/lists"}