added asyncio to the readme

README.md

@@ -32,23 +32,87 @@ This library's goal is to refresh and supplant the legacy module (this repositor
 ## Usage
 1. Export your API key as an [environment variable](https://www.twilio.com/blog/2017/01/how-to-set-environment-variables.html), for example:
 
-    `export MERAKI_DASHBOARD_API_KEY=093b24e85df15a3e66f1fc359f4c48493eaa1b73`
+    ```shell
+    export MERAKI_DASHBOARD_API_KEY=093b24e85df15a3e66f1fc359f4c48493eaa1b73
+    ```
 
 2. Alternatively, define your API key as a variable in your source code; this method is not recommended due to its inherent insecurity.
 
 3. Single line of code to import and use the library goes at the top of your script:
 
-    `import meraki`
+    ```python
+    import meraki
+    ```
 
 4. Instantiate the client (API consumer class), optionally specifying any of the parameters available to set:
 
-    `dashboard = meraki.DashboardAPI()`
+    ```python
+    dashboard = meraki.DashboardAPI()
+    ```
 
 5. Make dashboard API calls in your source code, using the format _client.section.operation_, where _client_ is the name you defined in the previous step (**dashboard** above), _section_ is the corresponding group (or tag from the OpenAPI spec) from the [API docs](https://developer.cisco.com/meraki/api/#/rest), and _operation_ is the name (or operation ID from OpenAPI) of the API endpoint. For example, to make a call to get the list of organizations accessible by the API key defined in step 1, use this function call:
 
-    `my_orgs = dashboard.organizations.getOrganizations()`
+    ```python
+    my_orgs = dashboard.organizations.getOrganizations()
+    ```
 
 6. If you were using this module versions 0.34 and prior, that file's functions are included in the _legacy.py_ file, and you can adapt your existing scripts by replacing their `from meraki import meraki` line to `import meraki`
 
+### Examples
+You can find fully working example scripts in the **examples** folder.
 
-For a full working script that demos this library, please see and run the **org_wide_clients.py** file included (in **examples** folder). That code collects the clients of all networks, in all orgs to which the key has access. No changes are made, since only GET endpoints are called, and the data is written to local CSV output files.
+| Script              | Purpose                                                                                                                                                                                               |
+|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **org_wide_clients.py** | That code collects the clients of all networks, in all orgs to which the key has access. No changes are made, since only GET endpoints are called, and the data is written to local CSV output files. |
+
+## AsyncIO
+**asyncio** is a library to write concurrent code using the **async/await** syntax. Special thanks to Heimo Stieg ([@coreGreenberet](https://github.com/coreGreenberet)) who has ported the API to asyncio.
+
+The usage is similiar to the sequential version above. However it has has some differences.
+
+1. Export your API key as an [environment variable](https://www.twilio.com/blog/2017/01/how-to-set-environment-variables.html), for example:
+
+    ```shell
+    export MERAKI_DASHBOARD_API_KEY=093b24e85df15a3e66f1fc359f4c48493eaa1b73
+    ```
+
+2. Alternatively, define your API key as a variable in your source code; this method is not recommended due to its inherent insecurity.
+
+3. Single line of code to import and use the library goes at the top of your script:
+
+    ```python
+    import meraki.aio
+    ```
+
+4. Instantiate the client (API consumer class), optionally specifying any of the parameters available to set:
+
+    ```python
+    async with meraki.aio.AsyncDashboardAPI() as aiomeraki:
+    ```
+    The **async with** statement is important here to make sure, that the client sessions will be closed after using the api.
+
+5. Make dashboard API calls in your source code, using the format await _client.section.operation_, where _client_ is the name you defined in the previous step (**aiomeraki** above), _section_ is the corresponding group (or tag from the OpenAPI spec) from the [API docs](https://developer.cisco.com/meraki/api/#/rest), and _operation_ is the name (or operation ID from OpenAPI) of the API endpoint. For example, to make a call to get the list of organizations accessible by the API key defined in step 1, use this function call:
+
+    ```python
+    my_orgs = await aiomeraki.organizations.getOrganizations()
+    ```
+6. Run everything inside an event loop.
+```python
+import asyncio
+
+if __name__ == "__main__":
+    loop = asyncio.get_event_loop()
+    loop.run_until_complete(my_async_entry_point())
+
+    # if you are using Python 3.7+ you can also simply 
+    # use the following line instead of the two lines above
+    asyncio.run(my_async_entry_point())
+```
+
+
+### Examples
+You can find fully working example scripts in the **examples** folder.
+| Script                  | Purpose                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **aio_org_wide_clients.py** | That code is a asyncio port from org_wide_clients.py and collects the clients of all networks, in all orgs to which the key has access. No changes are made, since only GET endpoints are called, and the data is written to local CSV output files.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| **aio_ips2firewall.py**     |  That code will collect the source IP of security events and creates L7 firewall rules to block them. `usage: aio_ips2firewall.py [-h] -o ORGANIZATIONS [ORGANIZATIONS ...] [-f FILTER] [-s] [-d DAYS]` |