neoload 1.3.19.dev1__tar.gz → 1.3.19.dev2__tar.gz

{neoload-1.3.19.dev1 → neoload-1.3.19.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neoload
-Version: 1.3.19.dev1
+Version: 1.3.19.dev2
 Summary: A command-line native utility for launching and observing NeoLoad performance tests
 Home-page: https://github.com/Neotys-Labs/neoload-cli
 Author: Neotys
@@ -86,6 +86,8 @@ NOTE: On the Windows command line, replace the `\` line-continuation characters
     - [Exporting Transaction CSV data](#exporting-transaction-csv-data)
  - [View zones](#view-zones)
  - [Create local Docker infrastructure to run a test](#create-local-docker-infrastructure-to-run-a-test)
+ - [Examples](#examples)
+   - [As-Code Demo Project](#as-code-demo-project)
  - [Continuous Testing Examples](#continuous-testing-examples)
    - [Support for fast-fail based on SLAs](#support-for-fast-fail-based-on-slas)
  - [Packaging the CLI with Build Agents](#packaging-the-cli-with-build-agents)
@@ -213,6 +215,24 @@ Pressing `Ctrl+C` causes the CLI to attempt to stop the test gracefully.
 neoload stop             # Sends the stop signal to the test and waits until it ends.
 ```
 
+## CheckVU an as-code project
+This command runs a CheckVU on an as-code project: it executes a single virtual user to verify that the project runs. It is meant to support fast iteration on as-code projects (generate -> checkvu -> fix).
+
+It delegates to a standalone headless CheckVU JAR and streams the JAR's output and exit code directly.
+
+```
+Usage: neoload checkvu [OPTIONS] PROJECT_FILE
+Help: neoload checkvu --help
+neoload checkvu default.yaml
+neoload checkvu -u myUser default.yaml
+```
+ - `PROJECT_FILE` is a path to an as-code yaml file. The CLI validates it against the as-code schema first (same as `neoload validate`), using `-s, --as-code-schema` to override the default schema.
+ - `-e, --engine-jar <path-or-url>` resolves the CheckVU JAR: a local file path or a download URL. If omitted, a previously cached JAR is reused, otherwise a default URL is used to download the latest JAR.
+ - `-j, --java` selects the java executable; by default `JAVA_HOME/bin/java` then `java` on the PATH. Java 21+ is required and verified before running.
+ - `-w, --work-dir <path>` sets the directory used for engine files and logs. Defaults to a temporary directory deleted afterwards unless `--keep-temp-work-dir` is set; a directory you supply yourself is never deleted.
+ - `--app-proxy`, `--app-proxy-username` and `--app-proxy-bypass` configure the proxy used for application traffic. The proxy password is set with `NEOLOAD_CHECK_VU_APP_PROXY_PASSWORD` environment variable instead so it never shows up in the process list or CI logs.
+ - `--controller-properties` and `--load-generator-properties` are advanced options to merge a `.properties` file into the JAR's embedded `controller.properties` / `agent.properties`.
+
 ## Reporting
 
 The NeoLoad CLI provides basic support for viewing and exporting test results.
@@ -394,6 +414,40 @@ Help: neoload config --help
 ```
 The configuration lets you customize the CLI's behavior. For now, it is only used by the `docker` command (see above).
 
+## Examples
+
+### As-Code Demo Project
+
+[`examples/as-code-demo`](examples/as-code-demo) contains a NeoLoad As-Code YAML project that works out-of-the-box:
+no NeoLoad Web project, no manual scenario setup - just point NeoLoad at
+[`default.yaml`](examples/as-code-demo/default.yaml) and run.
+
+Target: [Tricentis Demo Web Shop](https://demowebshop.tricentis.com/) (nopCommerce demo).
+
+The `BuyAsGuest` user path walks through a typical guest purchase:
+
+1. Open the shop home page
+2. Browse a product category
+3. Add a product to the cart (quantity randomised per iteration via a variable)
+4. View the cart
+5. Check out as a guest
+6. View product details
+
+It uses two variables (`product_id`, `quantity`) and a single population (`GuestShoppers`)
+
+Run CheckVU against the project:
+```
+neoload checkvu examples/as-code-demo/default.yaml
+```
+
+Run the full test:
+```
+neoload login $NLW_TOKEN \
+     test-settings --zone defaultzone --lgs 1 createorpatch DemoWebShopTest \
+     project --path examples/as-code-demo/default.yaml upload DemoWebShopTest \
+     run --scenario DemoWebShop
+```
+
 ## Continuous Testing Examples
 The main goal of the NeoLoad CLI is to standardize how load tests are executed across development, non-prod, and production environments.
 The instructions above can be run from a contributor workstation, but they can also be easily translated to various continuous build and deployment platforms. Examples are provided for:

{neoload-1.3.19.dev1 → neoload-1.3.19.dev2}/README.md

@@ -47,6 +47,8 @@ NOTE: On the Windows command line, replace the `\` line-continuation characters
     - [Exporting Transaction CSV data](#exporting-transaction-csv-data)
  - [View zones](#view-zones)
  - [Create local Docker infrastructure to run a test](#create-local-docker-infrastructure-to-run-a-test)
+ - [Examples](#examples)
+   - [As-Code Demo Project](#as-code-demo-project)
  - [Continuous Testing Examples](#continuous-testing-examples)
    - [Support for fast-fail based on SLAs](#support-for-fast-fail-based-on-slas)
  - [Packaging the CLI with Build Agents](#packaging-the-cli-with-build-agents)
@@ -174,6 +176,24 @@ Pressing `Ctrl+C` causes the CLI to attempt to stop the test gracefully.
 neoload stop             # Sends the stop signal to the test and waits until it ends.
 ```
 
+## CheckVU an as-code project
+This command runs a CheckVU on an as-code project: it executes a single virtual user to verify that the project runs. It is meant to support fast iteration on as-code projects (generate -> checkvu -> fix).
+
+It delegates to a standalone headless CheckVU JAR and streams the JAR's output and exit code directly.
+
+```
+Usage: neoload checkvu [OPTIONS] PROJECT_FILE
+Help: neoload checkvu --help
+neoload checkvu default.yaml
+neoload checkvu -u myUser default.yaml
+```
+ - `PROJECT_FILE` is a path to an as-code yaml file. The CLI validates it against the as-code schema first (same as `neoload validate`), using `-s, --as-code-schema` to override the default schema.
+ - `-e, --engine-jar <path-or-url>` resolves the CheckVU JAR: a local file path or a download URL. If omitted, a previously cached JAR is reused, otherwise a default URL is used to download the latest JAR.
+ - `-j, --java` selects the java executable; by default `JAVA_HOME/bin/java` then `java` on the PATH. Java 21+ is required and verified before running.
+ - `-w, --work-dir <path>` sets the directory used for engine files and logs. Defaults to a temporary directory deleted afterwards unless `--keep-temp-work-dir` is set; a directory you supply yourself is never deleted.
+ - `--app-proxy`, `--app-proxy-username` and `--app-proxy-bypass` configure the proxy used for application traffic. The proxy password is set with `NEOLOAD_CHECK_VU_APP_PROXY_PASSWORD` environment variable instead so it never shows up in the process list or CI logs.
+ - `--controller-properties` and `--load-generator-properties` are advanced options to merge a `.properties` file into the JAR's embedded `controller.properties` / `agent.properties`.
+
 ## Reporting
 
 The NeoLoad CLI provides basic support for viewing and exporting test results.
@@ -355,6 +375,40 @@ Help: neoload config --help
 ```
 The configuration lets you customize the CLI's behavior. For now, it is only used by the `docker` command (see above).
 
+## Examples
+
+### As-Code Demo Project
+
+[`examples/as-code-demo`](examples/as-code-demo) contains a NeoLoad As-Code YAML project that works out-of-the-box:
+no NeoLoad Web project, no manual scenario setup - just point NeoLoad at
+[`default.yaml`](examples/as-code-demo/default.yaml) and run.
+
+Target: [Tricentis Demo Web Shop](https://demowebshop.tricentis.com/) (nopCommerce demo).
+
+The `BuyAsGuest` user path walks through a typical guest purchase:
+
+1. Open the shop home page
+2. Browse a product category
+3. Add a product to the cart (quantity randomised per iteration via a variable)
+4. View the cart
+5. Check out as a guest
+6. View product details
+
+It uses two variables (`product_id`, `quantity`) and a single population (`GuestShoppers`)
+
+Run CheckVU against the project:
+```
+neoload checkvu examples/as-code-demo/default.yaml
+```
+
+Run the full test:
+```
+neoload login $NLW_TOKEN \
+     test-settings --zone defaultzone --lgs 1 createorpatch DemoWebShopTest \
+     project --path examples/as-code-demo/default.yaml upload DemoWebShopTest \
+     run --scenario DemoWebShop
+```
+
 ## Continuous Testing Examples
 The main goal of the NeoLoad CLI is to standardize how load tests are executed across development, non-prod, and production environments.
 The instructions above can be run from a contributor workstation, but they can also be easily translated to various continuous build and deployment platforms. Examples are provided for:

neoload-1.3.19.dev2/examples/as-code-demo/default.yaml

@@ -0,0 +1,140 @@
+# =============================================================================
+# NeoLoad As-Code demo project  -  Tricentis Demo Web Shop
+# -----------------------------------------------------------------------------
+# Target : https://demowebshop.tricentis.com/  (nopCommerce demo)
+# Scenario:  add a product to the cart  ->  checkout as guest  ->  view details
+#
+# Out-of-the-box usage (from the repo root, via neoload-cli):
+#   Run CheckVU against the project:
+#     neoload checkvu examples/as-code-demo/default.yaml
+#   Run the full test:
+#     neoload login $NLW_TOKEN \
+#          test-settings --zone defaultzone --lgs 1 createorpatch DemoWebShopTest \
+#          project --path examples/as-code-demo/default.yaml upload DemoWebShopTest \
+#          run --scenario DemoWebShop
+#
+# =============================================================================
+name: DemoWebShop
+
+# --- Server under test -------------------------------------------------------
+servers:
+- name: demowebshop
+  host: demowebshop.tricentis.com
+  scheme: https
+  port: 443
+
+# --- Variables -------------------------------
+variables:
+# Product added to the cart. "13" = "Computing and Internet" book in the demo shop.
+- constant:
+    name: product_id
+    value: "13"
+# Quantity added to the cart, randomised per iteration.
+- random_number:
+    name: quantity
+    description: Number of items added to the cart
+    min: 1
+    max: 3
+    change_policy: each_iteration
+
+# --- User path ---------------------------------------------------------------
+user_paths:
+- name: BuyAsGuest
+  description: Browse the shop, add a product, check out as a guest and view details
+
+  actions:
+    steps:
+
+    # 1) Open the shop home page ------------------------------------------------
+    - transaction:
+        name: 01_Home
+        steps:
+        - request:
+            server: demowebshop
+            url: /
+            assertions:
+            - contains: Tricentis Demo Web Shop
+        - think_time: 3s
+
+    # 2) Browse a category and open a product ----------------------------------
+    - transaction:
+        name: 02_Browse
+        steps:
+        - request:
+            server: demowebshop
+            url: /books
+            assertions:
+            - contains: Books
+        - think_time: 2s
+
+    # 3) Add the product to the cart (AJAX POST) -------------------------------
+    - transaction:
+        name: 03_AddToCart
+        steps:
+        - request:
+            server: demowebshop
+            url: /addproducttocart/catalog/${product_id}/1/${quantity}
+            method: POST
+            headers:
+            - name: X-Requested-With
+              value: XMLHttpRequest
+            assertions:
+            - contains: success
+        - think_time: 2s
+
+    # 4) View the cart ---------------------------------------------------------
+    - transaction:
+        name: 04_ViewCart
+        steps:
+        - request:
+            server: demowebshop
+            url: /cart
+            assertions:
+            - contains: Shopping cart
+        - think_time: 2s
+
+    # 5) Checkout as guest -----------------------------------------------------
+    - transaction:
+        name: 05_CheckoutAsGuest
+        steps:
+        - request:
+            server: demowebshop
+            url: /login/checkoutasguest?returnUrl=%2Fcart
+            method: POST
+            headers:
+            - name: Content-Type
+              value: application/x-www-form-urlencoded
+        - request:
+            server: demowebshop
+            url: /onepagecheckout
+            assertions:
+            - contains: Checkout
+        - think_time: 3s
+
+    # 6) View product details --------------------------------------------------
+    - transaction:
+        name: 06_ViewDetails
+        steps:
+        - request:
+            server: demowebshop
+            url: /computing-and-internet
+            assertions:
+            - contains: Computing and Internet
+        - think_time: 2s
+
+# --- Population -----------------------------------
+populations:
+- name: GuestShoppers
+  user_paths:
+  - name: BuyAsGuest
+
+# --- Scenario (used for the full test run) ------------------------------------
+scenarios:
+- name: DemoWebShop
+  description: Light constant load used for the manual test run on cloud/on-site LG
+  populations:
+  - name: GuestShoppers
+    constant_load:
+      users: 5
+      rampup: 30s
+      duration: 5m

neoload-1.3.19.dev2/neoload/commands/__init__.py

@@ -0,0 +1,2 @@
+__all__ = ["checkvu", "config", "docker", "fastfail", "login", "logout", "logs_url", "project", "run", "status", "stop", "test_results", "test_settings",
+           "validate", "wait", "workspaces", "zones", "report"]

neoload-1.3.19.dev2/neoload/commands/checkvu.py

@@ -0,0 +1,98 @@
+import os
+import sys
+
+import click
+
+from neoload_cli_lib import checkvu_runner, cli_exception
+import neoload_cli_lib.schema_validation as schema_validation
+from neoload_cli_lib.schema_validation import __default_schema_url
+
+__yaml_extensions = (".yaml", ".yml")
+
+@click.command()
+@click.option('-e', '--engine-jar',
+              help="CheckVU engine JAR to run: a local file, for air-gapped or pinned setups, or a download URL. "
+                   "Defaults to the cached JAR, otherwise the release URL for this version.",
+              metavar="PATH|URL")
+@click.option('-j', '--java', help="Path to the java executable to use. "
+                            "Defaults to JAVA_HOME/bin/java, then java on the PATH.", metavar="PATH")
+@click.option('-u', '--user-path', help="Run only the specified user path. If omitted, all user paths in the file "
+                                  "are executed sequentially. An unknown name fails and lists the user paths "
+                                  "found in the file.", metavar="NAME")
+@click.option('-s', '--as-code-schema', default=__default_schema_url, show_default=True,
+              help="NeoLoad as-code schema (URL or local path) to validate PROJECT_FILE "
+                   "against. Defaults to the schema published for this release on Github.",
+              metavar="PATH|URL")
+@click.option('--ssl-cert', default="",
+              help="Path to SSL certificate or write False to disable certificate checking. "
+                   "Used both for schema validation and the JAR download.")
+@click.option('--controller-properties',
+              help="Advanced. Path to controller.properties file merged additively into the Controller "
+                   "configuration; only the keys you set are overridden, other embedded values are kept.",
+              metavar="PATH")
+@click.option('--load-generator-properties',
+              help="Advanced. Path to agent.properties file merged additively into the Load Generator "
+                   "configuration; only the keys you set are overridden.",
+              metavar="PATH")
+@click.option('--app-proxy',
+              help="Proxy used to reach the tested applications, as host:port (e.g. myproxy.corp:8080). "
+                   "Applies to both HTTP and HTTPS application traffic (User Path validation / Load Generator "
+                   "traffic). Not used for NeoLoad Web API calls. CheckVU CLI download proxy uses the standard "
+                   "HTTPS_PROXY, HTTP_PROXY and NO_PROXY variables instead.",
+              metavar="HOST:PORT")
+@click.option('--app-proxy-username',
+              help="Username for --app-proxy authentication (optional). The password is read from environment "
+                   "variable NEOLOAD_CHECK_VU_APP_PROXY_PASSWORD; there is no flag for it, so it is never "
+                   "exposed in the process list or CI logs.",
+              metavar="USERNAME")
+@click.option('--app-proxy-bypass',
+              help="Comma-separated hosts that bypass --app-proxy (e.g. localhost,internal.corp).",
+              metavar="HOSTS")
+@click.option('-w', '--work-dir',
+              help="Directory for engine scratch files and logs. Defaults to a temporary directory. "
+                   "A directory you supply is never deleted.",
+              metavar="PATH")
+@click.option('--keep-temp-work-dir', is_flag=True, default=False,
+              help="Keep the temporary work directory after the run instead of deleting it. "
+                   "Equivalent to setting CHECKVU_CLI_KEEP_TEMP_WORK_DIR=1. "
+                   "Has no effect when --work-dir is already set, since that directory is never auto-deleted.")
+@click.argument('project_file')
+def cli(engine_jar, java, user_path, as_code_schema, ssl_cert,
+        controller_properties, load_generator_properties,
+        app_proxy, app_proxy_username, app_proxy_bypass, work_dir, keep_temp_work_dir,
+        project_file):
+    """  Validate the User Paths of a NeoLoad as-code Project locally.
+
+    Runs each User Path once against the application and reports whether
+    it completes without blocking errors. This is not a load test: no
+    Population, no Scenario, no Result. Exits 0 when every User Path passes, 1
+    otherwise, and always writes a JSON output.
+
+    PROJECT_FILE is the as-code Project YAML file. Its parent directory is the
+    Project root; colocated assets such as CSV files must live under that
+    root.
+    """
+    if not project_file.lower().endswith(__yaml_extensions):
+        raise cli_exception.CliException("Project file must be a yaml (\".yaml\", \".yml\") file: " + project_file)
+    if not os.path.isfile(project_file):
+        raise cli_exception.CliException("Project file not found: " + project_file)
+    print(schema_validation.validate_path(project_file, as_code_schema, ssl_cert), flush=True)
+
+    java_executable = checkvu_runner.resolve_java(java)
+    checkvu_runner.check_java_version(java_executable)
+
+    resolved_jar = checkvu_runner.resolve_jar(engine_jar, ssl_cert)
+
+    command = checkvu_runner.build_command(
+        java_executable, resolved_jar, project_file,
+        user_path=user_path,
+        controller_properties=controller_properties,
+        load_generator_properties=load_generator_properties,
+        app_proxy=app_proxy,
+        app_proxy_username=app_proxy_username,
+        app_proxy_bypass=app_proxy_bypass,
+        work_dir=work_dir,
+        keep_temp_work_dir=keep_temp_work_dir,
+    )
+    exit_code = checkvu_runner.run_checkvu(command)
+    sys.exit(exit_code)

neoload-1.3.19.dev2/neoload/commands/validate.py

@@ -0,0 +1,19 @@
+import click
+import neoload_cli_lib.schema_validation as schema_validation
+from neoload_cli_lib.schema_validation import __default_schema_url
+
+@click.command()
+@click.option('-s', '--as-code-schema', default=None,
+              help="NeoLoad as-code schema (URL or local path) to validate FILE against. "
+                   "Defaults to the schema published for this release on Github.",
+              metavar="PATH|URL")
+@click.option('--schema-url', 'schema_url', default=None, hidden=True,
+              help="Deprecated alias for --as-code-schema, kept for backward compatibility.")
+@click.option('--refresh', is_flag=True, help="THIS OPTION IS NOW USELESS", hidden=True)
+@click.option('--ssl-cert', default="", help="Path to SSL certificate or write False to disable certificate checking")
+@click.argument('file')
+def cli(file, refresh, as_code_schema, schema_url, ssl_cert):
+    """Verify that the yaml FILE matches the neoload as-code file format"""
+    # -s/--as-code-schema (new) takes priority over --schema-url (deprecated alias)
+    resolved_schema = as_code_schema or schema_url or __default_schema_url
+    print(schema_validation.validate_path(file, resolved_schema, ssl_cert))

neoload-1.3.19.dev2/neoload/neoload_cli_lib/checkvu_runner.py

@@ -0,0 +1,189 @@
+import os
+import re
+import shutil
+import subprocess
+import sys
+
+from neoload_cli_lib import cli_exception, paths
+
+MIN_JAVA_VERSION = 21
+
+# Default download URL pointing at the "latest" CheckVU JAR
+# TODO: set this once we have public jar url
+# use --engine-jar for now
+DEFAULT_JAR_URL = ""
+
+CACHE_DIR_NAME = "checkvu"
+CACHE_JAR_NAME = "neoload-checkvu-cli.jar"
+
+__java_version_pattern = re.compile(r'version "(\d+)(?:\.(\d+))?')
+
+
+def get_cache_dir():
+    return os.path.join(paths.get_config_dir(), CACHE_DIR_NAME)
+
+
+def get_cached_jar_path():
+    return os.path.join(get_cache_dir(), CACHE_JAR_NAME)
+
+
+def resolve_java(java_option=None):
+    """Return the path to a usable java executable, raising if none is found."""
+    if java_option:
+        return java_option
+    java_home = os.environ.get("JAVA_HOME")
+    if java_home:
+        candidate = os.path.join(java_home, "bin", "java")
+        resolved = shutil.which(candidate) or (candidate if os.path.isfile(candidate) else None)
+        if resolved:
+            return resolved
+    found = shutil.which("java")
+    if found:
+        return found
+    raise cli_exception.CliException(
+        "No Java runtime found. CheckVU requires Java {0} or later.\n"
+        "Install a JDK {0}+ and either add it to your PATH, set JAVA_HOME, "
+        "or pass --java <path-to-java>.".format(MIN_JAVA_VERSION))
+
+
+def parse_java_major_version(version_output):
+    """Extract the major Java version from `java -version` output, or None."""
+    match = __java_version_pattern.search(version_output)
+    if match is None:
+        return None
+    major = int(match.group(1))
+    # Legacy versions 1.x -> x
+    if major == 1 and match.group(2) is not None:
+        return int(match.group(2))
+    return major
+
+
+def check_java_version(java):
+    """Runs `java -version` and enforces the minimum supported major version.
+    `java -version` writes to stderr, so we merge stderr into stdout to capture it.
+    """
+    try:
+        completed = subprocess.run(
+            [java, "-version"],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            universal_newlines=True)
+    except OSError as err:
+        raise cli_exception.CliException(
+            "Unable to run '{0}': {1}\n"
+            "Install a JDK {2}+ and either add it to your PATH, set JAVA_HOME, "
+            "or pass --java <path-to-java>.".format(java, str(err), MIN_JAVA_VERSION))
+
+    output = completed.stdout or ""
+    major = parse_java_major_version(output)
+    if major is None:
+        raise cli_exception.CliException(
+            "Could not determine the Java version from '{0} -version':\n{1}".format(java, output.strip()))
+    if major < MIN_JAVA_VERSION:
+        raise cli_exception.CliException(
+            "CheckVU requires Java {0} or later, but '{1}' reports major version {2}.\n"
+            "Install a JDK {0}+ and either add it to your PATH, set JAVA_HOME, "
+            "or pass --java <path-to-java>.".format(MIN_JAVA_VERSION, java, major))
+    return major
+
+def is_url(spec):
+    return spec is not None and '://' in spec
+
+
+# TODO cache invalidation according to project version ?
+def resolve_jar(engine_jar=None, ssl_cert=''):
+    """Resolves the CheckVU fat JAR from --engine-jar (a local file, or a download URL).
+    Resolution order:
+      1. --engine-jar
+      2. cached JAR if exists
+      3. DEFAULT_JAR_URL -> download + cache
+      4. error
+    """
+    cache_path = get_cached_jar_path()
+
+    if engine_jar:
+        if is_url(engine_jar):
+            return download_jar(engine_jar, cache_path, ssl_cert)
+        if not os.path.isfile(engine_jar):
+            raise cli_exception.CliException("CheckVU JAR not found at '{0}'.".format(engine_jar))
+        return engine_jar
+
+    if os.path.isfile(cache_path):
+        return cache_path
+
+    if DEFAULT_JAR_URL:
+        return download_jar(DEFAULT_JAR_URL, cache_path, ssl_cert)
+
+    raise cli_exception.CliException(
+        "No CheckVU JAR available. Provide one with --engine-jar <path-to-neoload-checkvu-cli.jar|download-url>.\n")
+
+
+def download_jar(url, destination, ssl_cert=''):
+    """Download the CheckVU JAR to the cache, showing a progress bar when interactive."""
+    import requests
+    from tqdm import tqdm
+    from neoload_cli_lib import tools
+
+    verify = tools.ssl_cert_to_verify(ssl_cert)
+    os.makedirs(os.path.dirname(destination), exist_ok=True)
+    partial_destination = destination + ".part"
+    print("Downloading JAR from " + url + "\n")
+    try:
+        with requests.get(url, stream=True, verify=verify) as response:
+            response.raise_for_status()
+            total_bytes = int(response.headers.get("content-length", 0))
+            progress_bar = None
+            if tools.is_user_interactive():
+                progress_bar = tqdm(desc=CACHE_JAR_NAME, total=total_bytes, unit="B",
+                                    unit_scale=True, leave=False, dynamic_ncols=True)
+            with open(partial_destination, "wb") as stream:
+                for chunk in response.iter_content(chunk_size=1024 * 64):
+                    if chunk:
+                        stream.write(chunk)
+                        if progress_bar is not None:
+                            progress_bar.update(len(chunk))
+            if progress_bar is not None:
+                progress_bar.close()
+        os.replace(partial_destination, destination)
+    except Exception as err:
+        if os.path.isfile(partial_destination):
+            os.remove(partial_destination)
+        raise cli_exception.CliException(
+            "Failed to download the CheckVU JAR from '{0}':\n{1}".format(url, str(err)))
+    return destination
+
+
+def build_command(java, jar, project_file, user_path=None,
+                  controller_properties=None, load_generator_properties=None,
+                  app_proxy=None, app_proxy_username=None, app_proxy_bypass=None,
+                  work_dir=None, keep_temp_work_dir=False):
+    command = [java, "-jar", jar]
+    if user_path:
+        command.extend(["--user-path", user_path])
+    if controller_properties:
+        command.extend(["--controller-properties", controller_properties])
+    if load_generator_properties:
+        command.extend(["--load-generator-properties", load_generator_properties])
+    if app_proxy:
+        command.extend(["--app-proxy", app_proxy])
+    if app_proxy_username:
+        command.extend(["--app-proxy-username", app_proxy_username])
+    if app_proxy_bypass:
+        command.extend(["--app-proxy-bypass", app_proxy_bypass])
+    if work_dir:
+        command.extend(["--work-dir", work_dir])
+    if keep_temp_work_dir:
+        command.append("--keep-temp-work-dir")
+    command.append(project_file)
+    return command
+
+
+def run_checkvu(command):
+    """Run the JAR, inheriting stdio so the CLI output is the JAR output, and return its exit code."""
+    sys.stdout.flush()
+    sys.stderr.flush()
+    try:
+        completed = subprocess.run(command, stdout=sys.stdout, stderr=sys.stderr, stdin=sys.stdin)
+    except OSError as err:
+        raise cli_exception.CliException("Failed to run CheckVU: {0}".format(str(err)))
+    return completed.returncode

{neoload-1.3.19.dev1 → neoload-1.3.19.dev2}/neoload/neoload_cli_lib/schema_validation.py

@@ -307,3 +307,21 @@ def get_json_schema_by_spec(schema_spec, ssl_cert):
             raise bad_as_code_exception.BadAsCodeSchemaException('Could not load schema from provided file spec: %s' % schema_spec)
 
     return json_schema_spec
+
+
+def validate_path(file, schema_url, ssl_cert=''):
+    """Validates an as-code yaml file against the schema from NLCLI_FORCE_SCHEMA
+    or downloaded from given URL or from the defautl URL."""
+    force_schema = os.environ.get('NLCLI_FORCE_SCHEMA')
+    if force_schema is not None and len(force_schema) > 0:
+        schema_url = force_schema
+
+    path = os.path.abspath(file)
+    try:
+        if os.path.isdir(path):
+            validate_yaml_dir(path, schema_url, ssl_cert)
+            return 'All yaml files underneath the path provided are valid.'
+        validate_yaml(file, schema_url, ssl_cert)
+        return 'Yaml file is valid.'
+    except Exception as err:
+        raise cli_exception.CliException(str(err))

neoload-1.3.19.dev2/neoload/version.py

@@ -0,0 +1 @@
+__version__ = "1.3.19.dev2"