Tahoma

- Tahoma v3.0.2 introduces the ability to use a Cozytouch hub

- Special notes:
- To benefit from this new feature, reconfigure tahoma by executing the following commands after installing the update:
- `tahoma -c` to reconfigure application settings
- `tahoma -g` to reset the database

- Changes:
- Bug fixes
- Adds ability to use a Cozytouch hub thanks to Flavien06
- Adds ability to override the default server set in `tahoma -c` with the `--server` argument.
For example: `tahoma eco heater kitchen --username my_username --password my_password --server atlantic_cozytouch --remote`.
This is useful if you have more than one server (For example a Tahoma hub and a Cozytouch hub).
- Adds some useful ACTION commands for some compatible heaters (auto, manual, standby, prog, NUMBER).
For example: `tahoma manual heater kitchen wait for 2 18 heater kitchen --remote`. (Please note that this new feature doesn't works with every heaters)

- Explanation:
- Run `tahoma -c` to choose the default server (somfy_europe, somfy_america, somfy_oceania or atlantic_cozytouch)

- Tahoma v3.0 introduces a significant enhancement with the ability to utilize a local API for certain devices.

- Special notes:
- To benefit from the new features, reconfigure Tahoma by executing the following commands after installing the update:
- `tahoma -c` to reconfigure application settings
- `tahoma -g` to reset the database
- For the GitHub version of Tahoma, ensure to update the packages:
- Download the updated `requirements.txt` file from GitHub.
- Run the command: `python3 -m pip install -r requirements.txt`

- Changes:
- Bug fixes
- Script Harmonization:
- Standardized the script across GitHub and PyPi versions.
- Local API Control:
- Added the possibility to control some devices (shutters, sunscreens, heaters) via a local API without the need for a cloud connection
- Overriding default API setting:
- Added ability to override default API set in `tahoma -c` with the `--local` or `--remote` argument. For example `tahoma open shutter kitchen --local`
- Added ability to override the default API set in `tahoma -c` with the `--token` or `--pin` argument. For example: `tahoma my shutter kitchen --token 2343d8c7f23dd5f328de --pin 1234-1234-1234 --local`. This is useful if you have more than one Tahoma box.
- Automatic Token and Pin Provisioning:
- Token and pin numbers of the Tahoma box are automatically provided the first time you use the local API if you don’t configure them in tahoma -c.

- Explanations:
- Important: You will need to activate developer mode (www.somfy.com > My Account > Activate developer mode) to use the local API
- The local API allows controlling some devices without a cloud connection
- Execute `tahoma -c ` to specify the default API to use (local or remote)

VERY IMPORTANT:
After this update, please execute the following commands first:
`tahoma -c`
`tahoma -g`
These commands are necessary due to modifications made to the files.

Enhancements:
- Update README
- Bug fixes:
- Add the ability to distinguish between the categories of plug, spotalarm, and light
- Add the state for some plug sensors
- Add NewRelic to requirement.txt and enable anonymous statistics to improve the user experience
- Reduce to one update check per day
- Add a configuration option in `tahoma -c` to choose whether or not to be notified if an update is available
- Add the command `wait for <HOUR:MINUTE>` (24-hour format)
- Add the `toggle` action for plugs, lights, and spotalarms (IO devices only). Thanks to ingelumer!
- Code optimization

VERY IMPORTANT:
After this update, please execute the following commands first:
tahoma -c
tahoma -g
These commands are necessary due to modifications made to the login storage mechanism.

Enhancements:

- Changed the method for storing logins.
- Add lights to the list of available devices

VERY IMPORTANT:
After this update, please execute the following commands first:
tahoma -c
tahoma -g
These commands are necessary due to modifications made to the login storage mechanism.

Enhancements:
- Changed the method for storing logins.
- Add the ability to store logs
- Add an update's description when an update is available
- Add some plugs to the list of available devices thanks to ingelumer