Helping me help myself (library versions)

Third party integrations
1

Hi,

First off: I’ve been getting into smartifying my home lately and so far I’ve loved home assistant. You guys are doing a great job. I do have a question about the home assistant docs though.

I have been looking for a list of versions of libraries used by home-assistant and the “core” addons. I’ve noticed many of them are using external libraries to achieve their respective functionality. I’ve also noticed none of them list specific versions of these libraries they are based on. For example: Zwave is based on OpenZwave. The documentation mentions something like: “if a device doesn’t work it is possibly caused by our OpenZwave version being a few months old”. So i’m thinking: No biggy, i’ll just check the version of OpenZwave in the documentation. Now unfortunately I’ve been unable to find the version anywhere in the components docs.

I would like to suggest the components be “required” to list their key dependencies (and their versions) in the components documentation. This allows users the do a little big of research about which devices are going to work with home-assistant and which just plain simply aren’t. (I’d even be willing to do some of the leg-work to get this started)

2

For components, that information is in the source, where a version is pinned (it isn’t always). If you’re wanting to do that, the only sensible approach would be to pull that from the source when the docs are rebuilt, in an automated manner. Mostly the details are linked from the component page, though it may take a bit of poking around to find it.

Add-ons are another thing entirely, they’re not core to Home Assistant itself, but the same theory would apply for the (documented) core add-ons.

This is the kind of thing that would be best discussed in #documentation on the Discord server I suspect, if you’re in a position to submit PRs to make it happen. Otherwise it’s a #feature-requests post here.

1 Like
3

For most (if not all) of out integrations, the version of an external library is listed in the manifest.json file at the root of that integration in the main repository.

For your specific example (Z-Wave) this is how you can get to it.

find_manifest
find_manifest1266×939 448 KB

1 Like
4

Yes, i am in a position tot make that happen. I’ll join the discord server on a rainy day tot discuss this further. :slight_smile: