Update docs for newer devices and DeviceConfig

[sdb9696]

As per issue #600

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (460054c) 85.23% compared to head (0e47cd4) 85.23%.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #614   +/-   ##
=======================================
  Coverage   85.23%   85.23%           
=======================================
  Files          38       38           
  Lines        3475     3475           
  Branches      888      888           
=======================================
  Hits         2962     2962           
  Misses        432      432           
  Partials       81       81           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[rytilahti]

Looks much better, thanks 👍 just a minor maintenance nit that should be changed in all changed chunks if applicable.

[rytilahti]

Would you also mind adding somewhere a note that KASA_USERNAME and KASA_PASSWORD (or the hashed creds envvar) can be used instead of passing them always as command line arguments?

[sdb9696]

Would you also mind adding somewhere a note that KASA_USERNAME and KASA_PASSWORD (or the hashed creds envvar) can be used instead of passing them always as command line arguments?

Added to the cli.rst for KASA_USERNAME and KASA_PASSWORD. I didn't mention the hashed creds envvar because it 's more complicated there are three different potentail hash values, one for AES, one for Klap and one for Klap V2.

[rytilahti]

https://python-kasa--614.org.readthedocs.build/en/614/discover.html should be modified to contain at least some basic description about how the discovery works and how it should be used. Doesn't need to be anything fancy, but a quick description and a copy-pasteable code example that can be run as-is would be great.

Same would also be great in the smartdevice/common api, i.e., just a very simple ready-to-use example on how to get started if you have never used the lib.

[rytilahti]

If no command is given, the state command will be executed to query the device state.

The "Command-line usage" section in cli.rst should also be adapted to describe briefly the options related to authentication, no need to go deep into details but giving enough information get get one started from zero.

[sdb9696]

All comments now addressed.

[rytilahti]

This looks great, thanks! 🥇

I added a couple of very minor nits in places where I think rewording makes sense, feel free to adjust or keep it as it is, your call.

[sdb9696]

All comments now addressed

[rytilahti]

LGTM, thanks! 👍