python-dracclient
Julia Kreger
juliaashleykreger at gmail.com
Mon Jun 15 20:17:25 UTC 2020
Greetings,
Wow! Thanks for the heads up on this. It is kind of shockingly sparse...
and I think the docs are being incorrectly published for that library as
well.
Anyway, I _think_ what the original author meant was for "dracclient" to be
imported as "wsmanclient". The structure seems to match up with that.
Looking at the existing code, it states "dracclient.client.DRACClient".
That changed over four years ago so I think what you're viewing is a very
old copy of the documentation that was once published in the openstack
project namespace.
As for where, I don't think it is presently being published, which makes
this problem ultimately worse. I'm going to reach out to the maintainers
and inquire if they can fix the larger issue of their docs publishing.
Again, Thanks for the heads up.
-Julia
p.s. https://review.opendev.org/735674
On Mon, Jun 15, 2020 at 11:04 AM Ewan Hamilton <ewan.hamilton at managed.co.uk>
wrote:
> Hi guys,
>
>
>
> Your documentation for python-dracclient begins here:
> https://docs.openstack.org/python-dracclient/latest/usage.html with
>
>
>
>
>
> Usage
>
> Create a client object by providing the connection details of the DRAC
> card:
>
>
>
> client = wsmanclient.client.DRACClient('1.2.3.4', 'username', 's3cr3t')
>
>
>
>
>
> There is no import statement – and when I have searched google and found
> “import dracclient” because the assumed “import python-dracclient” doesn’t
> work due to a hyphen (why would you name your module with a hyphen in the
> first place?!), it doesn’t recognise “wsmanclient” in the editor still.
>
>
>
> Can you see just how frustrating this is for someone who expects
> documentation that actually works and explains how to actually use the
> module?
>
>
>
> This is a pathetic job here.
>
>
>
>
> Ewan Hamilton
> 3rd Line Networks Analyst
> t: 0800 033 4800
> ext. *2212* <2212> |
> m: 07772 001 625
> [image: LinkedIn] <https://www.linkedin.com/company/managed247-ltd/>
> [image: Twitter] <https://twitter.com/managed247> [image: Website]
> <http://www.managed.co.uk/>
> Technology House, 151 Silbury Boulevard, Milton Keynes, MK9 1LH
> managed. is a trading name of Managed247 Ltd
> Managed247 Ltd is a company registered in England and Wales under number
> 7019261
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20200615/5d038ba9/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image799935.png
Type: image/png
Size: 6379 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20200615/5d038ba9/attachment.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image682018.png
Type: image/png
Size: 833 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20200615/5d038ba9/attachment-0001.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image056713.png
Type: image/png
Size: 959 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20200615/5d038ba9/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image193517.png
Type: image/png
Size: 1196 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20200615/5d038ba9/attachment-0003.png>
More information about the openstack-discuss
mailing list