behavex 4.2.1__tar.gz → 4.2.2__tar.gz

{behavex-4.2.1/behavex.egg-info → behavex-4.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: behavex
-Version: 4.2.1
+Version: 4.2.2
 Summary: Agile testing framework on top of Behave (BDD).
 Home-page: https://github.com/hrcorval/behavex
 Author: Hernan Rey
@@ -87,20 +87,20 @@ BehaveX now provides seamless integration with Allure, the popular test reportin
 
 ## Introduction
 
-**BehaveX** is a BDD testing solution designed to enhance your Behave-based testing workflow by providing additional features and performance improvements. It's particularly beneficial in the following scenarios:
+**BehaveX** is a BDD testing solution built on top of the Python Behave library, orchestrating parallel test sessions to enhance your testing workflow with additional features and performance improvements. It's particularly beneficial in the following scenarios:
 
 - **Accelerating test execution**: Significantly reduce test run times through parallel execution by feature or scenario.
 - **Enhancing test reporting**: Generate comprehensive and visually appealing HTML and JSON reports for in-depth analysis and integration with other tools.
 - **Improving test visibility**: Provide detailed evidence, such as screenshots and logs, essential for understanding test failures and successes.
 - **Optimizing test automation**: Utilize features like test retries, test muting, and performance metrics for efficient test maintenance and analysis.
-- **Managing complex test suites**: Handle large test suites with advanced features for organization, execution, and reporting.
+- **Managing complex test suites**: Handle large test suites with advanced features for organization, execution, and comprehensive reporting through multiple formats and custom formatters.
 
 ## Features
 
 BehaveX provides the following features:
 
 - **Parallel Test Executions**: Execute tests using multiple processes, either by feature or by scenario.
-- **Enhanced Reporting**: Generate friendly HTML and JSON reports that can be exported and integrated with third-party tools.
+- **Enhanced Reporting**: Generate comprehensive reports in multiple formats (HTML, JSON, JUnit) and utilize custom formatters like Allure for advanced reporting capabilities that can be exported and integrated with third-party tools.
 - **Evidence Collection**: Include images/screenshots and additional evidence in the HTML report.
 - **Test Logs**: Automatically compile logs generated during test execution into individual log reports for each scenario.
 - **Test Muting**: Add the `@MUTE` tag to test scenarios to execute them without including them in JUnit reports.
@@ -210,6 +210,9 @@ Execute BehaveX in the same way as Behave from the command line, using the `beha
 - **parallel-processes** (--parallel-processes): Specifies the number of parallel Behave processes.
 - **parallel-scheme** (--parallel-scheme): Performs parallel test execution by [scenario|feature].
 - **show-progress-bar** (--show-progress-bar): Displays a progress bar in the console during parallel test execution.
+- **formatter** (--formatter): Specifies a custom formatter for test reports (e.g., Allure formatter).
+- **formatter-outdir** (--formatter-outdir): Specifies the output directory for formatter results (default: output/allure-results for Allure).
+- **no-formatter-attach-logs** (--no-formatter-attach-logs): Disables automatic attachment of scenario log files to formatter reports.
 
 ## Parallel Test Executions
 

{behavex-4.2.1 → behavex-4.2.2}/README.md

@@ -39,20 +39,20 @@ BehaveX now provides seamless integration with Allure, the popular test reportin
 
 ## Introduction
 
-**BehaveX** is a BDD testing solution designed to enhance your Behave-based testing workflow by providing additional features and performance improvements. It's particularly beneficial in the following scenarios:
+**BehaveX** is a BDD testing solution built on top of the Python Behave library, orchestrating parallel test sessions to enhance your testing workflow with additional features and performance improvements. It's particularly beneficial in the following scenarios:
 
 - **Accelerating test execution**: Significantly reduce test run times through parallel execution by feature or scenario.
 - **Enhancing test reporting**: Generate comprehensive and visually appealing HTML and JSON reports for in-depth analysis and integration with other tools.
 - **Improving test visibility**: Provide detailed evidence, such as screenshots and logs, essential for understanding test failures and successes.
 - **Optimizing test automation**: Utilize features like test retries, test muting, and performance metrics for efficient test maintenance and analysis.
-- **Managing complex test suites**: Handle large test suites with advanced features for organization, execution, and reporting.
+- **Managing complex test suites**: Handle large test suites with advanced features for organization, execution, and comprehensive reporting through multiple formats and custom formatters.
 
 ## Features
 
 BehaveX provides the following features:
 
 - **Parallel Test Executions**: Execute tests using multiple processes, either by feature or by scenario.
-- **Enhanced Reporting**: Generate friendly HTML and JSON reports that can be exported and integrated with third-party tools.
+- **Enhanced Reporting**: Generate comprehensive reports in multiple formats (HTML, JSON, JUnit) and utilize custom formatters like Allure for advanced reporting capabilities that can be exported and integrated with third-party tools.
 - **Evidence Collection**: Include images/screenshots and additional evidence in the HTML report.
 - **Test Logs**: Automatically compile logs generated during test execution into individual log reports for each scenario.
 - **Test Muting**: Add the `@MUTE` tag to test scenarios to execute them without including them in JUnit reports.
@@ -162,6 +162,9 @@ Execute BehaveX in the same way as Behave from the command line, using the `beha
 - **parallel-processes** (--parallel-processes): Specifies the number of parallel Behave processes.
 - **parallel-scheme** (--parallel-scheme): Performs parallel test execution by [scenario|feature].
 - **show-progress-bar** (--show-progress-bar): Displays a progress bar in the console during parallel test execution.
+- **formatter** (--formatter): Specifies a custom formatter for test reports (e.g., Allure formatter).
+- **formatter-outdir** (--formatter-outdir): Specifies the output directory for formatter results (default: output/allure-results for Allure).
+- **no-formatter-attach-logs** (--no-formatter-attach-logs): Disables automatic attachment of scenario log files to formatter reports.
 
 ## Parallel Test Executions
 

{behavex-4.2.1 → behavex-4.2.2}/behavex/environment.py

@@ -28,10 +28,12 @@ Context.__getattribute__ = create_custom_log_when_called
 
 hooks_already_set = False
 
+
 def _get_current_timestamp_ms():
     """Get current time as Unix epoch milliseconds."""
     return int(datetime.now().timestamp() * 1000)
 
+
 def extend_behave_hooks():
     """
     Extend Behave hooks with BehaveX hooks code.
@@ -106,7 +108,7 @@ def extend_behave_hooks():
 def before_all(context):
     """Setup up initial tests configuration."""
     try:
-        # Initialyzing log handler
+        # Initialize critical state variables to ensure consistent state
         context.bhx_log_handler = None
         context.bhx_inside_scenario = False
         # Store framework settings to make them accessible from steps
@@ -120,40 +122,68 @@ def before_feature(context, feature):
     try:
         context.bhx_execution_attempts = {}
         scenarios_instances = get_scenarios_instances(feature.scenarios)
+
         for scenario in scenarios_instances:
             scenario_tags = get_scenario_tags(scenario)
-            if get_param('dry_run'):
-                if 'MANUAL' not in scenario_tags:
-                    scenario.tags.append(u'BHX_MANUAL_DRY_RUN')
-                    scenario.tags.append(u'MANUAL')
+
+            # Handle dry run scenario tagging
+            if get_param('dry_run') and 'MANUAL' not in scenario_tags:
+                scenario.tags.extend(['BHX_MANUAL_DRY_RUN', 'MANUAL'])
+
+            # Configure scenario auto-retry
             configured_attempts = get_autoretry_attempts(scenario_tags)
             if configured_attempts > 0:
                 patch_scenario_with_autoretry(scenario, configured_attempts)
     except Exception as exception:
+        # Keep generic exception as fallback for truly unexpected errors
         _log_exception_and_continue('before_feature (behavex)', exception)
 
 
 def before_scenario(context, scenario):
     """Initialize logs for current scenario."""
+    # Initialize critical variables first to ensure they're always set
+    context.bhx_inside_scenario = True
+    # Initialize log handler to None to ensure it's always defined
+    context.bhx_log_handler = None
+
     try:
-        context.bhx_inside_scenario = True
+        # Handle execution attempts tracking
         if scenario.name not in context.bhx_execution_attempts:
             context.bhx_execution_attempts[scenario.name] = 0
         execution_attempt = context.bhx_execution_attempts[scenario.name]
         retrying_execution = True if execution_attempt > 0 else False
-
         # Calculate and store the scenario identifier hash
         scenario_identifier = f"{str(context.feature.filename)}-{str(scenario.line)}"
+        # Calculate the scenario identifier hash
         scenario.identifier_hash = get_string_hash(scenario_identifier)
-
-        context.log_path = create_log_path(scenario_identifier, retrying_execution)
+        # Create log path
+        context.log_path = create_log_path(scenario.identifier_hash, retrying_execution)
+        # Add log handler
         context.bhx_log_handler = _add_log_handler(context.log_path)
+        # Handle retry scenario cleanup
         if retrying_execution:
-            logging.info('Retrying scenario execution...\n'.format())
-            shutil.rmtree(context.evidence_path)
+            try:
+                logging.info('Retrying scenario execution...')
+                if hasattr(context, 'evidence_path') and context.evidence_path:
+                    try:
+                        shutil.rmtree(context.evidence_path)
+                    except FileNotFoundError:
+                        # Directory already removed by another process - this is fine
+                        pass
+                    except Exception as cleanup_ex:
+                        logging.warning(f"Failed to remove evidence directory {context.evidence_path}: {cleanup_ex}")
+            except Exception as retry_ex:
+                logging.warning(f"Failed to clean up evidence path during retry: {retry_ex}")
+        scenario.process_id = os.getpid()
+        if "config" in context and "worker_id" in context.config.userdata:
+            scenario.worker_id = context.config.userdata['worker_id']
+        else:
+            scenario.worker_id = str(os.getpid())
     except Exception as exception:
+        # Log the exception but ensure execution continues
         _log_exception_and_continue('before_scenario (behavex)', exception)
-    scenario.start = _get_current_timestamp_ms()
+    finally:
+        scenario.start = _get_current_timestamp_ms()
 
 
 def before_step(context, step):
@@ -191,9 +221,12 @@ def after_scenario(context, scenario):
             else:
                 global_vars.retried_scenarios[feature_name].append(scenario.name)
             context.bhx_execution_attempts[scenario.name] += 1
-        _close_log_handler(context.bhx_log_handler)
     except Exception as exception:
         _log_exception_and_continue('after_scenario (behavex)', exception)
+    finally:
+        # Always reset the scenario state flag, regardless of success or failure
+        _close_log_handler(context.bhx_log_handler)
+        context.bhx_inside_scenario = False
 
 
 # noinspection PyUnusedLocal
@@ -217,24 +250,31 @@ def after_all(context):
 
 def _add_log_handler(log_path):
     """Adding a new log handler to logger"""
-    log_filename = os.path.join(log_path, 'scenario.log')
-    file_handler = logging.FileHandler(
-        log_filename, mode='+a', encoding=LOGGING_CFG['file_handler']['encoding']
-    )
-    log_level = get_logging_level()
-    logging.getLogger().setLevel(log_level)
-    file_handler.addFilter(lambda record: setattr(record, 'msg', strip_ansi_codes(str(record.msg))) or True)
-    file_handler.setFormatter(_get_log_formatter())
-    logging.getLogger().addHandler(file_handler)
+    file_handler = None
+    try:
+        log_filename = os.path.join(log_path, 'scenario.log')
+        file_handler = logging.FileHandler(
+            log_filename, mode='+a', encoding=LOGGING_CFG['file_handler']['encoding']
+        )
+        log_level = get_logging_level()
+        logging.getLogger().setLevel(log_level)
+        file_handler.addFilter(lambda record: setattr(record, 'msg', strip_ansi_codes(str(record.msg))) or True)
+        file_handler.setFormatter(_get_log_formatter())
+        logging.getLogger().addHandler(file_handler)
+    except Exception as exception:
+        _log_exception_and_continue('_add_log_handler', exception)
     return file_handler
 
 
 def _close_log_handler(handler):
-    """Closing current log handlers and removing them from logger"""
+    """Closing current log handlers and removing them from logger."""
     if handler:
-        if hasattr(handler, 'stream') and hasattr(handler.stream, 'close'):
-            handler.stream.close()
-        logging.getLogger().removeHandler(handler)
+        try:
+            if hasattr(handler, 'stream') and hasattr(handler.stream, 'close'):
+                handler.stream.close()
+            logging.getLogger().removeHandler(handler)
+        except Exception as exception:
+            _log_exception_and_continue('_close_log_handler', exception)
 
 
 def _get_log_formatter():

{behavex-4.2.1 → behavex-4.2.2}/behavex/outputs/formatters/allure_behavex_formatter.py

@@ -433,6 +433,7 @@ class AllureBehaveXFormatter:
 
                 # Process tags
                 package_from_tag = None
+                test_thread_already_set = False
                 for tag in scenario['tags']:
                     if tag.startswith("epic="):
                         test_case.labels.append({"name": "epic", "value": tag.split("=")[-1]})
@@ -465,9 +466,19 @@ class AllureBehaveXFormatter:
                         test_case.labels = [label for label in test_case.labels if label.get("name") != "package"]
                         # Add the package from tag
                         test_case.labels.append({"name": "package", "value": package_from_tag})
+                    elif tag.startswith("allure.label."):
+                        label_key, label_value = tag.removeprefix("allure.label.").split(":")
+                        if label_key == "thread":
+                            test_thread_already_set = True
+                        test_case.labels.append({
+                            "name": label_key,
+                            "value": label_value
+                        })
                     else:
                         test_case.labels.append({"name": "tag", "value": tag})
-
+                # Add thread label if not already set and process_id is present
+                if "process_id" in scenario.keys() and not test_thread_already_set:
+                    test_case.labels.append({"name": "thread", "value": scenario["process_id"]})
                 # Add scenario timing
                 test_case.start = scenario.get("start", now())
                 test_case.stop = scenario.get("stop", now())

{behavex-4.2.1 → behavex-4.2.2}/behavex/outputs/output_strings.py

@@ -68,4 +68,20 @@ TEXTS = {
     },
     'folder': {'run_behave': u"Running folder: '{}' and feature '{}'."},
     'path': {'not_found': u'\nThe path "{}" was not found.\n'},
+    'process': {
+        'pool': {
+            'broken': u'\nWarning: Process pool was terminated abruptly: {}',
+            'broken.main': u'\nWarning: A process in the pool was terminated abruptly during main execution: {}'
+        }
+    },
+    'execution': {
+        'callback': {
+            'error': u'\nError occurred during execution callback: {}'
+        }
+    },
+    'parallel': {
+        'process': {
+            'error': u'\nError occurred during parallel process execution: {}'
+        }
+    }
 }

{behavex-4.2.1 → behavex-4.2.2}/behavex/outputs/report_json.py

@@ -202,6 +202,8 @@ def _processing_scenarios(scenarios, scenario_list, id_feature):
             scenario_info['error_background'] = error_background
             scenario_info['id_hash'] = generate_uuid()
             scenario_info['identifier_hash'] = scenario.identifier_hash if hasattr(scenario, 'identifier_hash') else get_string_hash(f"{str(scenario.feature.filename)}-{str(scenario.line)}")
+            scenario_info['process_id'] = str(scenario.process_id) if hasattr(scenario, 'process_id') else str(os.getpid())
+            scenario_info['worker_id'] = str(scenario.worker_id) if hasattr(scenario, 'worker_id') else str(os.getpid())
             if scenario.feature.name in global_vars.retried_scenarios:
                 if (
                     scenario.name

{behavex-4.2.1 → behavex-4.2.2}/behavex/outputs/report_utils.py

@@ -15,11 +15,13 @@ from __future__ import absolute_import, print_function
 
 import codecs
 import hashlib
+import logging
 import os
 import re
 import shutil
 import string
 import sys
+import tempfile
 import traceback
 import unicodedata
 from operator import getitem
@@ -331,25 +333,65 @@ def get_save_function(path, content):
     return fun_save
 
 
-def create_log_path(name, execution_retry=False):
-    name = get_string_hash(name)
-    if sys.version_info < (3, 0):
-        path = os.path.join(get_env('logs').decode('utf8'), str(name))
-    else:
-        path = os.path.join(get_env('logs'), str(name))
-    initial_path = path
-    scenario_outline_index = 1
-    while os.path.exists(path):
-        if execution_retry:
-            return path
-        path = initial_path + u'_' + str(scenario_outline_index)
-        scenario_outline_index += 1
+def create_log_path(scenario_identifier_hash, execution_retry=False):
+    """Create log path with fallback mechanisms for robust error handling.
+
+    Args:
+        scenario_identifier_hash: Hash representation of the scenario
+        execution_retry: Whether this is a retry execution
+
+    Returns:
+        str: The created log path
+    """
     try:
-        os.makedirs(path)
-    except FileExistsError:
-        # path already exists
-        pass
-    return path
+        # Validate and sanitize the logs directory
+        logs_dir = _get_safe_logs_directory()
+
+        # Create the full path
+        path = os.path.join(logs_dir, str(scenario_identifier_hash))
+        initial_path = path
+        scenario_outline_index = 1
+
+        # Handle existing paths
+        while os.path.exists(path):
+            if execution_retry:
+                return path
+            path = initial_path + u'_' + str(scenario_outline_index)
+            scenario_outline_index += 1
+
+        # Create the directory with robust error handling
+        os.makedirs(path, exist_ok=True)
+        return path
+
+    except Exception as ex:
+        logging.warning(f"Primary log path creation failed: {ex}")
+        # Only use temp fallback for actual file system issues
+        temp_path = tempfile.mkdtemp(prefix=f"bhx_scenario_{scenario_identifier_hash or 'unknown'}_")
+        logging.error(f"Using temp directory as last resort: {temp_path}")
+        return temp_path
+
+
+def _get_safe_logs_directory():
+    """Get a safe logs directory, creating it if necessary."""
+    # Try to get the configured logs directory
+    logs_dir = get_env('logs')
+
+    # If not configured, use a safe default
+    if not logs_dir:
+        output_dir = get_env('output', '.')
+        logs_dir = os.path.join(output_dir, 'outputs', 'logs')
+
+    # Ensure the logs directory exists
+    try:
+        os.makedirs(logs_dir, exist_ok=True)
+    except OSError as ex:
+        # If we can't create the logs directory, fall back to output directory
+        logging.warning(f"Cannot create logs directory {logs_dir}: {ex}")
+        output_dir = get_env('output', '.')
+        logs_dir = os.path.join(output_dir, 'logs')
+        os.makedirs(logs_dir, exist_ok=True)
+
+    return logs_dir
 
 
 def get_error_message(error_message):
@@ -399,7 +441,31 @@ def text(value, encoding=None, errors=None):
 
 
 def get_string_hash(string_to_hash):
-    return str(hashlib.sha256(string_to_hash.encode('UTF-8')).hexdigest())
+    """Generate SHA256 hash for a given string input.
+
+    Args:
+        string_to_hash: String or bytes to hash
+
+    Returns:
+        str: Hexadecimal representation of the SHA256 hash
+
+    Raises:
+        TypeError: If input is not string or bytes
+    """
+    if string_to_hash is None:
+        raise ValueError("Input cannot be None")
+
+    if isinstance(string_to_hash, str):
+        # Convert string to bytes
+        bytes_to_hash = string_to_hash.encode('UTF-8')
+    elif isinstance(string_to_hash, bytes):
+        # Already bytes, use as-is
+        bytes_to_hash = string_to_hash
+    else:
+        # Convert other types to string first
+        bytes_to_hash = str(string_to_hash).encode('UTF-8')
+
+    return hashlib.sha256(bytes_to_hash).hexdigest()
 
 
 def normalize_filename(input_name):

{behavex-4.2.1 → behavex-4.2.2}/behavex/outputs/report_xml.py

@@ -21,6 +21,41 @@ from behavex.outputs.report_utils import (get_save_function,
 from behavex.utils import get_scenario_tags
 
 
+def generate_junit_xml_filename(filename):
+    """Generate JUnit XML report filename from feature file path.
+
+    Args:
+        filename (str): Path to the feature file
+
+    Returns:
+        str: JUnit XML filename in format TESTS-<name>.xml
+    """
+    if not filename:
+        return 'TESTS-default.xml'
+
+    # Normalize path for the current OS and replace backslashes for consistency
+    normalized_path = os.path.normpath(filename).replace('\\', '/')
+    path_parts = normalized_path.split('/')
+
+    # Find 'features' directory
+    if 'features' in path_parts:
+        features_idx = path_parts.index('features')
+        # Use everything after 'features'
+        name_parts = path_parts[features_idx + 1:]
+    else:
+        # Fallback: use all parts but filter out empty ones and drive letters
+        name_parts = [part for part in path_parts if part and ':' not in part]
+
+    # Remove .feature extension from the last part
+    if name_parts and name_parts[-1].endswith('.feature'):
+        name_parts[-1] = name_parts[-1][:-8]  # Remove '.feature'
+
+    # Join with dots, filter out empty parts
+    name = '.'.join(part for part in name_parts if part)
+
+    return f'TESTS-{name or "default"}.xml'
+
+
 def _export_feature_to_xml(feature, isobject=True):
     def get_scenarios(feature_):
         def flatter_scenarios(scenarios_list):
@@ -94,15 +129,19 @@ def _export_feature_to_xml(feature, isobject=True):
         parameters_template,
     )
     output_text = output_text.replace('status="Status.', 'status="')
-    exp = re.compile('\\\\|/')
+
     filename = feature.filename if isobject else feature['filename']
     filename = text(filename)
-    name = u'.'.join(exp.split(filename.partition('features')[2][1:-8]))
+
+    # Generate XML filename using the helper function
+    xml_filename = generate_junit_xml_filename(filename)
+
     junit_path = os.path.join(get_env('OUTPUT'), 'behave')
-    path_output = os.path.join(junit_path, u'TESTS-' + name + u'.xml')
+
+    path_output = os.path.join(junit_path, xml_filename)
 
     retry_file_operation(
-        path_output + '.xml', get_save_function(path_output, output_text)
+        path_output, get_save_function(path_output, output_text)
     )
 
 

{behavex-4.2.1 → behavex-4.2.2}/behavex/runner.py

@@ -12,6 +12,7 @@ including setup, execution, and reporting.
 from __future__ import absolute_import, print_function
 
 import codecs
+import concurrent
 import copy
 import io
 import json
@@ -81,7 +82,23 @@ def main():
     Parses command-line arguments and initiates the test run.
     """
     args = sys.argv[1:]
-    exit_code = run(args)
+    exit_code = 1  # Default to error
+    try:
+        exit_code = run(args)
+    except SystemExit as e:
+        # Handle cases where scenarios call exit() directly
+        if hasattr(e, 'code') and e.code is not None:
+            exit_code = e.code
+        else:
+            exit_code = 1
+        # Ensure we print the exit code even when scenarios crash
+        print('Exit code: {}'.format(exit_code))
+    except Exception as e:
+        # Handle unexpected exceptions
+        print(f'Unexpected error: {e}')
+        exit_code = 1
+        print('Exit code: {}'.format(exit_code))
+
     try:
         exit(exit_code)
     except:
@@ -483,7 +500,19 @@ def launch_by_feature(features,
             global_vars.progress_bar_instance,
         ))
     for parallel_process in parallel_processes:
-        parallel_process.result()
+        try:
+            parallel_process.result()
+        except:
+            from concurrent.futures.process import BrokenProcessPool
+            e = sys.exc_info()[1]
+            if isinstance(e, BrokenProcessPool):
+                print_parallel('process.pool.broken.main', str(e))
+                # Mark as failed execution but continue processing remaining futures
+                execution_codes.append(1)
+            else:
+                print_parallel('parallel.process.error', str(e))
+                execution_codes.append(1)
+    parallel_processes.clear()
     return execution_codes, json_reports
 
 
@@ -511,6 +540,7 @@ def launch_by_scenario(features,
     duplicated_scenarios = {}
     total_scenarios_to_run = {}
     features_with_no_scen_desc = []
+    parallel_processes = []
     for features_path, scenarios in features.items():
         scenarios_instances = get_scenarios_instances(scenarios)
         for scenario in scenarios_instances:
@@ -569,7 +599,6 @@ def launch_by_scenario(features,
                     global_vars.progress_bar_instance.update()
     if parallel_scenarios:
         print_parallel('scenario.running_parallels')
-        parallel_processes = []
         for features_path in parallel_scenarios.keys():
             for scenario_information in parallel_scenarios[features_path]:
                 scenarios_to_run_in_feature = total_scenarios_to_run[scenario_information["feature_filename"]]
@@ -594,7 +623,19 @@ def launch_by_scenario(features,
                     global_vars.progress_bar_instance
                 ))
         for parallel_process in parallel_processes:
-            parallel_process.result()
+            try:
+                parallel_process.result()
+            except:
+                from concurrent.futures.process import BrokenProcessPool
+                e = sys.exc_info()[1]
+                if isinstance(e, BrokenProcessPool):
+                    print_parallel('process.pool.broken.main', str(e))
+                    # Mark as failed execution but continue processing remaining futures
+                    execution_codes.append(1)
+                else:
+                    print_parallel('parallel.process.error', str(e))
+                    execution_codes.append(1)
+        parallel_processes.clear()
     return execution_codes, json_reports
 
 

{behavex-4.2.1 → behavex-4.2.2}/behavex/utils.py

@@ -55,6 +55,13 @@ def handle_execution_complete_callback(codes,
     try:
         tuple_values = future.result()
     except: # isort:skip
+        # Handle BrokenProcessPool and other exceptions gracefully
+        from concurrent.futures.process import BrokenProcessPool
+        e = sys.exc_info()[1]
+        if isinstance(e, BrokenProcessPool):
+            print_parallel('process.pool.broken', str(e))
+        else:
+            print_parallel('execution.callback.error', str(e))
         json_reports += []
         codes.append(1)
     if tuple_values:

{behavex-4.2.1 → behavex-4.2.2/behavex.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: behavex
-Version: 4.2.1
+Version: 4.2.2
 Summary: Agile testing framework on top of Behave (BDD).
 Home-page: https://github.com/hrcorval/behavex
 Author: Hernan Rey
@@ -87,20 +87,20 @@ BehaveX now provides seamless integration with Allure, the popular test reportin
 
 ## Introduction
 
-**BehaveX** is a BDD testing solution designed to enhance your Behave-based testing workflow by providing additional features and performance improvements. It's particularly beneficial in the following scenarios:
+**BehaveX** is a BDD testing solution built on top of the Python Behave library, orchestrating parallel test sessions to enhance your testing workflow with additional features and performance improvements. It's particularly beneficial in the following scenarios:
 
 - **Accelerating test execution**: Significantly reduce test run times through parallel execution by feature or scenario.
 - **Enhancing test reporting**: Generate comprehensive and visually appealing HTML and JSON reports for in-depth analysis and integration with other tools.
 - **Improving test visibility**: Provide detailed evidence, such as screenshots and logs, essential for understanding test failures and successes.
 - **Optimizing test automation**: Utilize features like test retries, test muting, and performance metrics for efficient test maintenance and analysis.
-- **Managing complex test suites**: Handle large test suites with advanced features for organization, execution, and reporting.
+- **Managing complex test suites**: Handle large test suites with advanced features for organization, execution, and comprehensive reporting through multiple formats and custom formatters.
 
 ## Features
 
 BehaveX provides the following features:
 
 - **Parallel Test Executions**: Execute tests using multiple processes, either by feature or by scenario.
-- **Enhanced Reporting**: Generate friendly HTML and JSON reports that can be exported and integrated with third-party tools.
+- **Enhanced Reporting**: Generate comprehensive reports in multiple formats (HTML, JSON, JUnit) and utilize custom formatters like Allure for advanced reporting capabilities that can be exported and integrated with third-party tools.
 - **Evidence Collection**: Include images/screenshots and additional evidence in the HTML report.
 - **Test Logs**: Automatically compile logs generated during test execution into individual log reports for each scenario.
 - **Test Muting**: Add the `@MUTE` tag to test scenarios to execute them without including them in JUnit reports.
@@ -210,6 +210,9 @@ Execute BehaveX in the same way as Behave from the command line, using the `beha
 - **parallel-processes** (--parallel-processes): Specifies the number of parallel Behave processes.
 - **parallel-scheme** (--parallel-scheme): Performs parallel test execution by [scenario|feature].
 - **show-progress-bar** (--show-progress-bar): Displays a progress bar in the console during parallel test execution.
+- **formatter** (--formatter): Specifies a custom formatter for test reports (e.g., Allure formatter).
+- **formatter-outdir** (--formatter-outdir): Specifies the output directory for formatter results (default: output/allure-results for Allure).
+- **no-formatter-attach-logs** (--no-formatter-attach-logs): Disables automatic attachment of scenario log files to formatter reports.
 
 ## Parallel Test Executions
 

{behavex-4.2.1 → behavex-4.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "behavex"
-version = "4.2.1"
+version = "4.2.2"
 description = "Agile testing framework on top of Behave (BDD)."
 readme = "README.md"
 license = { text = "MIT" }

{behavex-4.2.1 → behavex-4.2.2}/setup.py

@@ -6,7 +6,7 @@ with open('README.md', 'r') as fh:
 
 setup(
     name='behavex',
-    version='4.2.1',
+    version='4.2.2',
     license="MIT",
     platforms=['any'],
     python_requires='>=3.5',

{behavex-4.2.1 → behavex-4.2.2}/tests/features/steps/allure_formatter_steps.py

@@ -6,10 +6,8 @@ import tempfile
 from pathlib import Path
 
 from behave import given, then, when
-
-from tests.features.steps.execution_steps import (execute_command,
-                                                  get_random_number,
-                                                  root_project_path)
+from execution_steps import (execute_command, get_random_number,
+                             root_project_path)
 
 tests_features_path = os.path.join(root_project_path, 'tests', 'features')