New bleeding edge build (v0.4.10) now available!

[jshcodes]

FalconPy v.0.4.10

This update (PR #166) adds timeout handling functionality and fixes for proxy support within Service Classes.

Special thanks to @matcha-shake for suggesting this enhancement.

• Enhancement
• Bug fixes
• Updated unit tests

Production package release date

The updates to the production package will be published on 06.23.2021.

Using timeouts

The timeout value you pass to the Service or Uber class is utilized for all calls to the requests library. For scenarios where you are creating multiple objects to represent different API's, you will be able to set specific timeouts for each API service collection.

Specifying timeouts

The timeout value is passed directly to the requests library, allowing you to specify a float for a "generic" timeout and a tuple to specify read/connect timeouts. Values should be specified in seconds.

Generic timeouts

Passing a float for the timeout value will allow you to specify a timeout for the entire operation.

# Times out after thirty second for connect and read
from falconpy.cloud_connect_aws import Cloud_Connect_AWS as FalconAWS
falcon = FalconAWS(creds={
    'client_id': falcon_client_id,
    'client_secret': falcon_client_secret
}, timeout=30
)
result = falcon.QueryAWSAccounts()
print(result)

Connect / Read timeouts

Using a tuple for the timeout value will allow you to specify individual timeouts for connect and read.

# Times out after one second for connect and read
from falconpy.cloud_connect_aws import Cloud_Connect_AWS as FalconAWS
falcon = FalconAWS(creds={
    'client_id': falcon_client_id,
    'client_secret': falcon_client_secret
}, timeout=(3.05,26.95)
)
result = falcon.QueryAWSAccounts()
print(result)

Installation

You can check out this new release by installing the package via the Python Package Index.

$ python3 -m pip install -i https://test.pypi.org/simple/ crowdstrike-falconpy

or

pip3 install -i https://test.pypi.org/simple/ crowdstrike-falconpy

Upgrading

You can upgrade to this new release by installing the update via the Python Package Index.

$ python3 -m pip install -i https://test.pypi.org/simple/ crowdstrike-falconpy --upgrade

or

pip3 install -i https://test.pypi.org/simple/ crowdstrike-falconpy --upgrade