crowdstrike-falconpy 1.3.0.dev10__tar.gz → 1.3.0.dev12__tar.gz

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/AUTHORS.md

@@ -88,6 +88,7 @@ This has been a critical element in the development of the FalconPy project.
 + Alex, `@khyberspache`
 + Phil Massyn, `@massyn`
 + Russell Snyder, `@rusnyder`
++ `@PeroSoy`
 
 
 ## Sponsors

{crowdstrike-falconpy-1.3.0.dev10/src/crowdstrike_falconpy.egg-info → crowdstrike-falconpy-1.3.0.dev12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crowdstrike-falconpy
-Version: 1.3.0.dev10
+Version: 1.3.0.dev12
 Summary: The CrowdStrike Falcon SDK for Python 3
 Home-page: https://github.com/CrowdStrike/falconpy
 Author: CrowdStrike

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12/src/crowdstrike_falconpy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crowdstrike-falconpy
-Version: 1.3.0.dev10
+Version: 1.3.0.dev12
 Summary: The CrowdStrike Falcon SDK for Python 3
 Home-page: https://github.com/CrowdStrike/falconpy
 Author: CrowdStrike

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/crowdstrike_falconpy.egg-info/SOURCES.txt

@@ -198,4 +198,61 @@ src/falconpy/_service_class/_service_class.py
 src/falconpy/_util/__init__.py
 src/falconpy/_util/_auth.py
 src/falconpy/_util/_functions.py
-src/falconpy/_util/_uber.py
+src/falconpy/_util/_uber.py
+tests/test_alerts.py
+tests/test_authentications.py
+tests/test_authorization.py
+tests/test_cloud_connect_aws.py
+tests/test_cspm_registration.py
+tests/test_custom_ioa.py
+tests/test_d4c_registration.py
+tests/test_detects.py
+tests/test_device_control_policies.py
+tests/test_discover.py
+tests/test_event_streams.py
+tests/test_falcon_complete_dashboard.py
+tests/test_falcon_container.py
+tests/test_falconx_sandbox.py
+tests/test_fdr.py
+tests/test_filevantage.py
+tests/test_firewall_management.py
+tests/test_firewall_policies.py
+tests/test_host_group.py
+tests/test_hosts.py
+tests/test_identity_protection.py
+tests/test_incidents.py
+tests/test_installation_tokens.py
+tests/test_intel.py
+tests/test_ioa_exclusions.py
+tests/test_ioc.py
+tests/test_iocs.py
+tests/test_kubernetes_protection.py
+tests/test_malquery.py
+tests/test_message_center.py
+tests/test_ml_exclusions.py
+tests/test_mobile_enrollment.py
+tests/test_mssp.py
+tests/test_ods.py
+tests/test_overwatch_dashboard.py
+tests/test_prevention_policy.py
+tests/test_quarantine.py
+tests/test_quick_scan.py
+tests/test_real_time_response.py
+tests/test_real_time_response_admin.py
+tests/test_recon.py
+tests/test_report_executions.py
+tests/test_response_policies.py
+tests/test_result_object.py
+tests/test_sample_uploads.py
+tests/test_scheduled_reports.py
+tests/test_sensor_download.py
+tests/test_sensor_update_policy.py
+tests/test_sensor_visibility_exclusions.py
+tests/test_service_class.py
+tests/test_spotlight_evaluation_logic.py
+tests/test_spotlight_vulnerabilities.py
+tests/test_tailored_intelligence.py
+tests/test_timeout.py
+tests/test_uber_api_complete.py
+tests/test_user_management.py
+tests/test_zero_trust_assessment.py

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_api_request/_request.py

@@ -35,7 +35,7 @@ OTHER DEALINGS IN THE SOFTWARE.
 
 For more information, please refer to <https://unlicense.org>
 """
-from typing import Union, Dict, Optional, List, Type, Any
+from typing import Union, Dict, Optional, List, Any
 from logging import Logger
 from ._request_behavior import RequestBehavior
 from ._request_connection import RequestConnection
@@ -47,16 +47,6 @@ from .._log import LogFacility
 class APIRequest:
     """This class represents a request made to the CrowdStrike API."""
 
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    _meta: RequestMeta = RequestMeta()
-    _payloads: RequestPayloads = RequestPayloads()
-    _connection: RequestConnection = RequestConnection()
-    _behavior = RequestBehavior()
-    _request_log: Optional[LogFacility] = None
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
@@ -95,6 +85,13 @@ class APIRequest:
                                             sanitize_log=initializer.get("sanitize", None)
                                             )
 
+        else:
+            self._meta = RequestMeta()
+            self._payloads = RequestPayloads()
+            self._connection = RequestConnection()
+            self._behavior = RequestBehavior()
+            self._request_log: Optional[LogFacility] = None
+
     # _  _ ____ ___ _  _ ____ ___  ____
     # |\/| |___  |  |__| |  | |  \ [__
     # |  | |___  |  |  | |__| |__/ ___]
@@ -212,7 +209,7 @@ class APIRequest:
         self.behavior.perform = value
 
     @property
-    def body_validator(self) -> Optional[Dict[str, Type]]:
+    def body_validator(self) -> Optional[Dict[str, Any]]:
         """Return the body payload validator from the behavior object."""
         return self.behavior.body_validator
 

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_api_request/_request_behavior.py

@@ -35,48 +35,48 @@ OTHER DEALINGS IN THE SOFTWARE.
 
 For more information, please refer to <https://unlicense.org>
 """
-from typing import Optional, Dict, List, Type
+from typing import Optional, Any, Dict, List
 from ._request_validator import RequestValidator
 
 
 class RequestBehavior:
     """This class represents specified behaviors for an API request."""
 
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    _expand_result: bool = False
-    _container: bool = False
-    _authenticating: bool = False
-    _perform: bool = True
-    _validator = RequestValidator()
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
     #
     def __init__(self,
-                 expand_result: Optional[bool] = None,
-                 container: Optional[bool] = None,
-                 authenticating: Optional[bool] = None,
-                 perform: Optional[bool] = None,
-                 body_validator: Optional[Dict[str, Type]] = None,
+                 expand_result: Optional[bool] = False,
+                 container: Optional[bool] = False,
+                 authenticating: Optional[bool] = False,
+                 perform: Optional[bool] = True,
+                 body_validator: Optional[Dict[str, Any]] = None,
                  body_required: Optional[List[str]] = None
                  ):
         """Construct an instance of RequestBehavior class."""
+        self._expand_result = False
         if isinstance(expand_result, bool):
-            self.expand_result = expand_result
+            self._expand_result = expand_result
+
+        self._container = False
         if isinstance(container, bool):
-            self.container = container
+            self._container = container
+
+        self._authenticating = False
         if isinstance(authenticating, bool):
-            self.authenticating = authenticating
+            self._authenticating = authenticating
+
+        self._perform = True
         if isinstance(perform, bool):
-            self.perform = perform
+            self._perform = perform
+
         if isinstance(body_validator, dict) or isinstance(body_required, list):
-            self.validator = RequestValidator(validator=body_validator,
-                                              required=body_required
-                                              )
+            self._validator = RequestValidator(validator=body_validator,
+                                               required=body_required
+                                               )
+        else:
+            self._validator = RequestValidator()
 
     # ___  ____ ____ ___  ____ ____ ___ _ ____ ____
     # |__] |__/ |  | |__] |___ |__/  |  | |___ [__
@@ -133,7 +133,7 @@ class RequestBehavior:
         self._validator = value
 
     @property
-    def body_validator(self) -> Optional[Dict[str, Type]]:
+    def body_validator(self) -> Optional[Dict[str, Any]]:
         """Reflection into the validator object for the body payload validator."""
         return self.validator.validator
 

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_api_request/_request_connection.py

@@ -41,15 +41,6 @@ from typing import Optional, Dict, Union
 class RequestConnection:
     """This class represents connection details related to an API request."""
 
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    _user_agent: Optional[str] = None
-    _verify: bool = True
-    _timeout: Optional[Union[int, tuple]] = None
-    _proxy: Optional[Dict[str, str]] = None
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
@@ -58,12 +49,14 @@ class RequestConnection:
                  user_agent: Optional[str] = None,
                  proxy: Optional[Dict[str, str]] = None,
                  timeout: Optional[Union[int, tuple]] = None,
-                 verify: Optional[bool] = None
+                 verify: Optional[bool] = True
                  ):
         """Construct an instance of RequestConnection class."""
-        self.user_agent: Optional[str] = user_agent
-        self.proxy: Optional[Dict[str, str]] = proxy
-        self.timeout: Optional[Union[int, tuple]] = timeout
+        self._user_agent: Optional[str] = user_agent
+        self._proxy: Optional[Dict[str, str]] = proxy
+        self._timeout: Optional[Union[int, tuple]] = timeout
+
+        self._verify = True
         if isinstance(verify, bool):
             self.verify: bool = verify
 

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_api_request/_request_meta.py

@@ -41,15 +41,6 @@ from typing import Dict, Union, Optional
 class RequestMeta:
     """This class contains the relevant metadata for the API request being performed."""
 
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    _method: str = "GET"
-    _endpoint: Optional[str] = None
-    # These are set during the processing of the request
-    _debug_headers: Optional[Dict[str, Optional[Union[str, int, float]]]] = {}
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
@@ -60,9 +51,12 @@ class RequestMeta:
                  debug_headers: Optional[Dict[str, Optional[Union[str, int, float]]]] = None
                  ):
         """Construct an instance of RequestMeta class."""
-        self.endpoint = endpoint
-        self.method = method
-        self.debug_headers = debug_headers
+        self._endpoint: Optional[str] = endpoint
+        self._method: str = method
+
+        self._debug_headers: Optional[Dict[str, Optional[Union[str, int, float]]]] = debug_headers
+        if debug_headers is None:
+            self._debug_headers = {}
 
     # ___  ____ ____ ___  ____ ____ ___ _ ____ ____
     # |__] |__/ |  | |__] |___ |__/  |  | |___ [__

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_api_request/_request_payloads.py

@@ -41,15 +41,6 @@ from typing import Optional, Dict, List, Union
 class RequestPayloads:
     """This class contains all of the payloads sent as part of the API request."""
 
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    _params: Optional[Dict[str, Optional[Union[str, int, float, list, dict]]]] = None
-    _body: Optional[Union[bytes, Dict[str, Union[str, int, dict, list, bytes]]]] = None
-    _data: Optional[Union[bytes, Dict[str, Union[str, int, dict, list, bytes]]]] = None
-    _files: Optional[List[tuple]] = None
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
@@ -61,10 +52,10 @@ class RequestPayloads:
                  files: Optional[List[tuple]] = None
                  ):
         """Construct an instance of RequestPayloads class."""
-        self.params = params
-        self.body = body
-        self.data = data
-        self.files = files
+        self._params = params
+        self._body = body
+        self._data = data
+        self._files = files
 
     # ___  ____ ____ ___  ____ ____ ___ _ ____ ____
     # |__] |__/ |  | |__] |___ |__/  |  | |___ [__

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_api_request/_request_validator.py

@@ -35,42 +35,35 @@ OTHER DEALINGS IN THE SOFTWARE.
 
 For more information, please refer to <https://unlicense.org>
 """
-from typing import Type, Dict, Optional, List
+from typing import Any, Dict, Optional, List
 
 
 class RequestValidator:
     """This class represents a request payload validator."""
 
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    _validator: Optional[Dict[str, Type]] = None
-    _required: Optional[List[str]] = None
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
     #
     def __init__(self,
-                 validator: Optional[Dict[str, Type]] = None,
+                 validator: Optional[Dict[str, Any]] = None,
                  required: Optional[List[str]] = None
                  ):
         """Construct an instance of RequestValidator class."""
-        self.validator = validator
-        self.required = required
+        self._validator: Optional[Dict[str, Any]] = validator
+        self._required: Optional[List[str]] = required
 
     # ___  ____ ____ ___  ____ ____ ___ _ ____ ____
     # |__] |__/ |  | |__] |___ |__/  |  | |___ [__
     # |    |  \ |__| |    |___ |  \  |  | |___ ___]
     #
     @property
-    def validator(self) -> Optional[Dict[str, Type]]:
+    def validator(self) -> Optional[Dict[str, Any]]:
         """Return the validator dictionary."""
         return self._validator
 
     @validator.setter
-    def validator(self, value: Optional[Dict[str, Type]]):
+    def validator(self, value: Optional[Dict[str, Any]]):
         """Set the validator dictionary."""
         self._validator = value
 
@@ -88,7 +81,7 @@ class RequestValidator:
 # This code will be updated to the following once Python 3.6 support is dropped.
 #
 # from dataclasses import dataclass
-# from typing import Type, Dict, Optional, List
+# from typing import Any, Dict, Optional, List
 
 
 # @dataclass
@@ -99,5 +92,5 @@ class RequestValidator:
 #     # |__|  |   |  |__/ | |__] |  |  |  |___ [__
 #     # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
 #     #
-#     validator: Optional[Dict[str, Type]] = None
+#     validator: Optional[Dict[str, Any]] = None
 #     required: Optional[List[str]] = None

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_auth_object/_bearer_token.py

@@ -42,24 +42,6 @@ from .._constant import MIN_TOKEN_RENEW_WINDOW, MAX_TOKEN_RENEW_WINDOW
 
 class BearerToken:
     """This class represents a bearer token received from the API."""
-
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    # Integer specifying the amount of time remaining before the token expires (in seconds).
-    _expiration: int = 0
-    # Float indicating the moment in time that the token was generated (timestamp).
-    _token_time: float = 0
-    # String containing the error message received from the API when token generation failed.
-    _fail_reason: Optional[str] = None
-    # Integer representing the HTTP status code received when generating the token.
-    _status: Optional[int] = None
-    # String representation of the token.
-    _value: Optional[str] = None
-    # Number of seconds between token expiration and now before a token is considered stale.
-    _renew_window: int = 120
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
@@ -67,19 +49,32 @@ class BearerToken:
     # Tokens can be instantiated without a value (e.g. invalid or expired).
     def __init__(self,
                  token_value: Optional[str] = None,
-                 expiration: Optional[int] = None,
+                 expiration: Optional[int] = 0,
                  status: Optional[int] = None
                  ):
         """Create an instance of the BearerToken class."""
-        # if token_value:
         self._value = token_value
+
+        # String containing the error message received from the API when token generation failed.
+        self._fail_reason: Optional[str] = None
+        # Number of seconds between token expiration and now before a token is considered stale.
+        self._renew_window: int = 120
+
+        # Integer specifying the amount of time remaining before the token expires (in seconds).
+        self._expiration: int = 0
         if isinstance(expiration, int):
             self._expiration = expiration
-        if token_value:
-            self._token_time = time.time()
+
+        # Integer representing the HTTP status code received when generating the token.
+        self._status: Optional[int] = None
         if isinstance(status, int):
             self._status = status
 
+        # Float indicating the moment in time that the token was generated (timestamp).
+        self._token_time: float = 0
+        if token_value:
+            self._token_time = time.time()
+
     # _  _ ____ ___ _  _ ____ ___  ____
     # |\/| |___  |  |__| |  | |  \ [__
     # |  | |___  |  |  | |__| |__/ ___]

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_auth_object/_falcon_interface.py

@@ -67,28 +67,6 @@ from .._error import InvalidCredentials, NoAuthenticationMechanism, InvalidCrede
 # pylint: disable=R0902
 class FalconInterface(BaseFalconAuth):
     """Standard Falcon API interface used by Service Classes."""
-
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    # These attributes are present in all FalconInterface objects, regardless if we are referring
-    # to APIHarness, OAuth2 or custom inheriting classes.
-    #
-    # The default credential dictionary, where the client_id and client_secret are stored.
-    _creds: Dict[str, str] = {}
-    # Starting with v1.3.0 minimal python native logging is available. In order to reduce
-    # potential impacts to developer configurations, this facility is extremely limited
-    # and not implemented by default. (Meaning logs are not generated.)
-    # To enable logging, pass the keyword "debug" with a value of True to the constructor.
-    _log: LogFacility = LogFacility()
-    # Our token is stored within a BearerToken object.
-    _token: BearerToken = BearerToken()
-    # Configuration detail for this interface.
-    _config: InterfaceConfiguration = None
-    # Pythonic behavior.
-    _pythonic: bool = False
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
@@ -111,12 +89,20 @@ class FalconInterface(BaseFalconAuth):
                  debug: Optional[bool] = False,
                  debug_record_count: Optional[int] = None,
                  sanitize_log: Optional[bool] = None,
-                 pythonic: Optional[bool] = None
+                 pythonic: Optional[bool] = False
                  ) -> "FalconInterface":
         """Construct an instance of the FalconInterface class."""
         # Set the pythonic behavior mode.
+        self.pythonic: bool = False
         if isinstance(pythonic, bool):
             self._pythonic = pythonic
+
+        # The default credential dictionary, where the client_id and client_secret are stored.
+        self._creds = {}
+
+        # Set up an empty Bearer Token container
+        self._token: BearerToken = BearerToken()
+
         # Setup our configuration object using the provided keywords.
         self.config: InterfaceConfiguration = InterfaceConfiguration(base_url=base_url,
                                                                      proxy=proxy,
@@ -150,14 +136,16 @@ class FalconInterface(BaseFalconAuth):
             self.creds: Dict[str, str] = creds
         else:
             raise InvalidCredentialFormat
+
+        # Legacy (Token) Authentication (fallback)
+        if access_token:
+            # Store this non-refreshable token, assuming it was just generated.
+            self._token: BearerToken = BearerToken(access_token, 1799, 201)
+
         # Set the token renewal window, ignored when using Legacy Authentication.
         self.renew_window: int = max(min(renew_window, MAX_TOKEN_RENEW_WINDOW),
                                      MIN_TOKEN_RENEW_WINDOW
                                      )
-        # Legacy (Token) Authentication (fallback)
-        if access_token:
-            # Store this non-refreshable token, assuming it was just generated.
-            self._token: BearerToken = BearerToken(access_token, 1799)
 
         # Environment Authentication
         # When credentials are not provided, attempt to retrieve them from the environment.
@@ -174,6 +162,10 @@ class FalconInterface(BaseFalconAuth):
                 }
 
         # Log the creation of this object if debugging is enabled.
+        # Starting with v1.3.0 minimal Python native logging is available. In order to reduce
+        # potential impacts to developer configurations, this facility is extremely limited
+        # and not implemented by default. (Meaning logs are not generated.)
+        # To enable logging, pass the keyword "debug" with a value of True to the constructor.
         if debug:
             # Ignored when debugging is disabled.
             _debug_record_count: int = debug_record_count if debug_record_count else None
@@ -186,6 +178,9 @@ class FalconInterface(BaseFalconAuth):
                                                  )
             # Log the startup of this class.
             log_class_startup(self, self.log)
+        else:
+            # Set up an empty log facility
+            self._log: LogFacility = LogFacility()
 
         try:
             if not self.cred_format_valid and not self.token_value:

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_auth_object/_interface_config.py

@@ -41,40 +41,26 @@ from typing import Dict, Union, Optional
 class InterfaceConfiguration:
     """This class represents the configuration of the interface."""
 
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    # The base URL for this interface.
-    _base_url: str = None
-    # The proxy to use for communication with the CrowdStrike Falcon API.
-    _proxy: Optional[Dict[str, str]] = None
-    # The timeout to use for communication.
-    # Either an integer for the entire operation or a float for (connect, read).
-    _timeout: Optional[Union[int, tuple]] = None
-    # The user-agent string to use for requests to the CrowdStrike Falcon API.
-    _user_agent: Optional[str] = None
-    # SSL Verification boolean, defaults to True.
-    _ssl_verify: bool = True
-
     # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
     # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
     # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
     #
     def __init__(self,
-                 base_url: str,
+                 base_url: Optional[str] = None,
                  proxy: Optional[Dict[str, str]] = None,
                  timeout: Optional[Union[int, tuple]] = None,
                  user_agent: Optional[str] = None,
                  ssl_verify: Optional[bool] = True
                  ):
         """Construct an instance of the InterfaceConfiguration class."""
-        self.base_url = base_url
-        self.proxy = proxy
-        self.timeout = timeout
-        self.user_agent = user_agent
+        self._base_url: Optional[str] = base_url
+        self._proxy: Optional[Dict[str, str]] = proxy
+        self._timeout: Optional[Union[int, tuple]] = timeout
+        self._user_agent: Optional[str] = user_agent
+
+        self._ssl_verify: bool = True
         if isinstance(ssl_verify, bool):
-            self.ssl_verify = ssl_verify
+            self._ssl_verify = ssl_verify
 
     # ___  ____ ____ ___  ____ ____ ___ _ ____ ____
     # |__] |__/ |  | |__] |___ |__/  |  | |___ [__

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_constant/__init__.py

@@ -45,7 +45,7 @@ PREFER_NONETYPE: List[str] = [
 PREFER_IDS_IN_BODY: List[str] = [
     "GetDeviceDetails", "PostDeviceDetailsV2", "GetVulnerabilities", "GetIntelIndicatorEntities",
     "getChildrenV2", "cancel-scans", "GetDetectSummaries", "UpdateQuarantinedDetectsByIds",
-    "GetQuarantineFiles"
+    "GetQuarantineFiles", "PostEntitiesAlertsV1"
 ]
 MOCK_OPERATIONS: List[str] = [
     "GetImageAssessmentReport", "DeleteImageDetails", "ImageMatchesPolicy"

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_log/_facility.py

@@ -43,26 +43,21 @@ from .._constant import MAX_DEBUG_RECORDS
 class LogFacility:
     """This class encapsulates the log facility and additional configuration."""
 
-    # ____ ___ ___ ____ _ ___  _  _ ___ ____ ____
-    # |__|  |   |  |__/ | |__] |  |  |  |___ [__
-    # |  |  |   |  |  \ | |__] |__|  |  |___ ___]
-    #
-    _log: Optional[Logger] = None
-    # Maximum number of debug records to log in debug logs.
-    _debug_record_count: int = MAX_DEBUG_RECORDS
-    # Flag representing if debug logs should be sanitized.
-    _sanitize: bool = True
-
     def __init__(self,
                  log: Optional[Logger] = None,
                  debug_record_count: Optional[int] = None,
                  sanitize_log: Optional[bool] = None
                  ):
         """Construct an instance of the LogFacility class."""
+        self._log: Optional[Logger] = None
         if isinstance(log, Logger):
             self._log = log
+
+        self._debug_record_count: int = MAX_DEBUG_RECORDS
         if isinstance(debug_record_count, (int, str)):
             self._debug_record_count = int(debug_record_count)
+
+        self._sanitize: bool = True
         if isinstance(sanitize_log, bool):
             self._sanitize = sanitize_log
 

{crowdstrike-falconpy-1.3.0.dev10 → crowdstrike-falconpy-1.3.0.dev12}/src/falconpy/_result/__base_resource.py

@@ -41,21 +41,16 @@ from ._response_component import ResponseComponent
 
 class BaseResource(ResponseComponent):
     """The base class for different resource types we can have within an API response."""
-
-    #  _______ _______ _______  ______ _____ ______  _     _ _______ _______ _______
-    #  |_____|    |       |    |_____/   |   |_____] |     |    |    |______ |______
-    #  |     |    |       |    |    \_ __|__ |_____] |_____|    |    |______ ______|
-    #
-    # Override the _data attribute from ResponseComponent to always be a list.
-    _data: List[Optional[Union[str, int, float, dict]]] = []
-    _pos: int = 0
-
     #  _______  _____  __   _ _______ _______  ______ _     _ _______ _______  _____   ______
     #  |       |     | | \  | |______    |    |_____/ |     | |          |    |     | |_____/
     #  |_____  |_____| |  \_| ______|    |    |    \_ |_____| |_____     |    |_____| |    \_
     #
     def __init__(self, data: Optional[List[Union[str, int, float, dict]]] = None):
         """Construct an instance of the class."""
+        # Override the _data attribute from ResponseComponent to always be a list.
+        self._data: Optional[List[Union[str, int, float, dict]]] = []
+        self._pos: int = 0
+
         if isinstance(data, list):
             super().__init__(data=data)