scythe-ttp 0.17.5__tar.gz → 0.17.6__tar.gz

{scythe_ttp-0.17.5/scythe_ttp.egg-info → scythe_ttp-0.17.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scythe-ttp
-Version: 0.17.5
+Version: 0.17.6
 Summary: An extensible framework for emulating attacker TTPs with Selenium.
 Author-email: EpykLab <cyber@epyklab.com>
 Classifier: Programming Language :: Python :: 3

scythe_ttp-0.17.6/VERSION

@@ -0,0 +1 @@
+0.17.6

{scythe_ttp-0.17.5 → scythe_ttp-0.17.6}/scythe/cli/main.py

@@ -71,16 +71,42 @@ def scythe_test_definition(args) -> bool:
     
     # Example usage with TTPExecutor:
     # from scythe.core.executor import TTPExecutor
-    # executor = TTPExecutor(ttp=my_ttp, target_url=args.url)
+    # from scythe.ttps.web.login_bruteforce import LoginBruteforceTTP
+    # 
+    # ttp = LoginBruteforceTTP(
+    #     payloads=['admin', 'root', 'test'],
+    #     expected_result=False  # Expect security controls to block attempts
+    # )
+    # executor = TTPExecutor(ttp=ttp, target_url=args.url)
     # executor.run()
     # return executor.was_successful()  # Returns True if all results matched expectations
     
     # Example usage with JourneyExecutor:
     # from scythe.journeys.executor import JourneyExecutor
-    # executor = JourneyExecutor(journey=my_journey, target_url=args.url)
+    # from scythe.journeys.base import Journey, Step
+    # from scythe.journeys.actions import NavigateAction, FillFormAction, ClickAction
+    # 
+    # journey = Journey(
+    #     name="Login Journey",
+    #     description="Test user login flow",
+    #     expected_result=True  # Expect journey to succeed
+    # )
+    # journey.add_step(Step("Navigate").add_action(NavigateAction(url=args.url)))
+    # executor = JourneyExecutor(journey=journey, target_url=args.url)
     # executor.run()
     # return executor.was_successful()  # Returns True if journey succeeded as expected
     
+    # Example usage with Orchestrators:
+    # from scythe.orchestrators.scale import ScaleOrchestrator
+    # from scythe.orchestrators.base import OrchestrationStrategy
+    # 
+    # orchestrator = ScaleOrchestrator(
+    #     strategy=OrchestrationStrategy.PARALLEL,
+    #     max_workers=10
+    # )
+    # result = orchestrator.orchestrate_ttp(ttp=my_ttp, target_url=args.url, replications=100)
+    # return orchestrator.exit_code(result) == 0  # Returns True if all executions succeeded
+    
     return True
 
 

{scythe_ttp-0.17.5 → scythe_ttp-0.17.6}/scythe/core/executor.py

@@ -344,3 +344,12 @@ class TTPExecutor:
             True if all test results matched expectations, False otherwise
         """
         return not self.has_test_failures
+    
+    def exit_code(self) -> int:
+        """
+        Get the exit code for this test execution.
+        
+        Returns:
+            0 if test was successful (results matched expectations), 1 otherwise
+        """
+        return 0 if self.was_successful() else 1

{scythe_ttp-0.17.5 → scythe_ttp-0.17.6}/scythe/journeys/executor.py

@@ -463,6 +463,15 @@ class JourneyExecutor:
         actual = self.execution_results.get('overall_success', False)
         expected = self.execution_results.get('expected_result', True)
         return actual == expected
+    
+    def exit_code(self) -> int:
+        """
+        Get the exit code for this journey execution.
+        
+        Returns:
+            0 if journey was successful (results matched expectations), 1 otherwise
+        """
+        return 0 if self.was_successful() else 1
 
 
 class JourneyRunner:

{scythe_ttp-0.17.5 → scythe_ttp-0.17.6}/scythe/orchestrators/base.py

@@ -281,6 +281,24 @@ class Orchestrator(ABC):
                 self.logger.warning(f"  ... and {len(result.errors) - 3} more errors")
         
         self.logger.info("="*60)
+    
+    def exit_code(self, result: OrchestrationResult) -> int:
+        """
+        Get the exit code for an orchestration result.
+        
+        An orchestration is considered successful if all executions completed
+        successfully (matching their expected results).
+        
+        Args:
+            result: OrchestrationResult to evaluate
+            
+        Returns:
+            0 if all executions were successful, 1 otherwise
+        """
+        # Check if any executions failed or if there were errors
+        if result.failed_executions > 0 or len(result.errors) > 0:
+            return 1
+        return 0
 
 
 class ExecutionContext:

{scythe_ttp-0.17.5 → scythe_ttp-0.17.6/scythe_ttp.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scythe-ttp
-Version: 0.17.5
+Version: 0.17.6
 Summary: An extensible framework for emulating attacker TTPs with Selenium.
 Author-email: EpykLab <cyber@epyklab.com>
 Classifier: Programming Language :: Python :: 3

scythe_ttp-0.17.5/VERSION

@@ -1 +0,0 @@
-0.17.5