Hi guys, sorry for my tone in the post – I was extremely frustrated at how a simple thing can be missed out. I write documentation for staff at my work and I know just how basic you have to be in order for them to understand it.

I was able to get this working using:

from dracclient import client

service_instance = connect.SmartConnectNoSSL(host="x", user="x", pwd="x")

Looking into it further, the author has another project called python-wsmanclient so I think he just got confused writing the documentation examples.

My apologies again for my tone – I’m happy again now that it’s working!

Ewan

Ewan Hamilton

3rd Line Networks Analyst

t: 0800 033 4800

ext. 2212

|

m: 07772 001 625

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

From: Julia Kreger <juliaashleykreger@gmail.com>
Sent: 15 June 2020 21:17
To: Ewan Hamilton <ewan.hamilton@managed.co.uk>
Cc: openstack-discuss@lists.openstack.org
Subject: Re: python-dracclient

THIS MESSAGE ORIGINATED OUTSIDE YOUR ORGANISATION

---

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@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

|

m: 07772 001 625

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