*** jcoufal has joined #storyboard | 00:55 | |
*** jtomasek_ has joined #storyboard | 06:52 | |
*** jtomasek_ has quit IRC | 07:39 | |
*** openstackgerrit has quit IRC | 08:03 | |
*** openstackgerrit has joined #storyboard | 08:04 | |
Zara | morning! I intend to improve some docs today and put some of my sample python client scripts up someplace gerrity | 09:13 |
---|---|---|
*** bethwhite_ has joined #storyboard | 09:19 | |
* Zara vanishes early for 'lunch' (actually sleep; experienced all the insomnias) | 10:02 | |
SotK | I knew you'd accept that lunch is at 11 eventually :) | 11:08 |
Zara | I PUT IT IN QUOTE MARKS | 11:18 |
Zara | NOT REAL LUNCH | 11:18 |
Zara | also I did that thing where I couldn't sleep until the last 10 mins of the hour I'd allocated | 11:19 |
Zara | so still exhausted and will probably not make much headway learning sqlalchemy things today, which was the vague plan for after the docs. | 11:20 |
*** alexismonville has joined #storyboard | 11:37 | |
Zara | (re #infra, I'm not just imagining that, right? fairly sure it's been my default navigation method for ages) | 11:39 |
* SotK sees it too, pretty strange | 11:42 | |
*** alexismonville has quit IRC | 11:42 | |
Zara | I started second-guessing myself like 'maybe it was never there' but really I *know* it listed the 4 projects. | 11:46 |
Zara | oh, I was wondering where gerritbot had gone, but my patch was to infra manual... | 13:04 |
Zara | anyway, I updated the developer docs with the further info fungi requested. https://review.openstack.org/#/c/371515/ | 13:04 |
Zara | for now I'm going to put my sample python client scripts into a directory in python-storyboardclient/storyboardclient/v1 . I don't know that that's the right place for them, but at least they can be in gerrit that way (instead of dotted around various pastes) | 13:36 |
Zara | oh, and my CLI needs support for verify=False.... | 13:36 |
persia | Maybe create an /examples directory? | 13:37 |
persia | Maybe put them in the docs/ directory, and reference them from other docs? | 13:37 |
SotK | +1 to that | 13:39 |
Zara | sure, I was only thinking v1 as I dump things near there when using the client because it's a bit quicker to see the client code, but anywhere where storyboardclient can be found wfm. | 13:42 |
Zara | which should be anywhere if it's installed right :P | 13:42 |
persia | My experience is that example code tends to bitrot unless it is part of the test suite (and sometimes even then). | 13:43 |
persia | So mixing it with other code makes it hard to comprehend a new codebase. | 13:44 |
Zara | the bitrot was why I thought it might make sense to put it near the client code (not mixed in, but in an sample-scripts directory) | 13:45 |
Zara | it's slightly easier to update if it's not 5 directories away... but only slightly, really | 13:45 |
persia | If you really want to make sure it doesn't bitrot, add tests that run the example code and check that the output is correct (at least the correct format, given that you may not be able to control the data) | 13:49 |
Zara | that might be more trouble than it's worth at this stage (I'm not expecting big api changes to affect these any time soon, and we have some separate tests for the client). (tidying these scripts atm, already taken far longer than writing them xD) | 14:27 |
openstackgerrit | Zara proposed openstack-infra/python-storyboardclient: Add some sample pythonclient scripts https://review.openstack.org/371620 | 15:32 |
Zara | hah, some relics from where I reworded the odd thing | 15:34 |
openstackgerrit | Zara proposed openstack-infra/python-storyboardclient: Add some sample pythonclient scripts https://review.openstack.org/371620 | 15:38 |
Zara | hah, I'm so tired I seem to have missed out every other word... | 15:39 |
*** alexismonville has joined #storyboard | 15:43 | |
openstackgerrit | Zara proposed openstack-infra/python-storyboardclient: Add some sample pythonclient scripts https://review.openstack.org/371620 | 15:46 |
Zara | EVENTUALLY I will get rid of all that whitespace | 15:47 |
*** alexismonville has quit IRC | 15:48 | |
openstackgerrit | Zara proposed openstack-infra/python-storyboardclient: Add some sample pythonclient scripts https://review.openstack.org/371620 | 15:48 |
*** bethwhite_ has quit IRC | 16:10 | |
Zara | I think I got it, anyway :) | 16:35 |
*** openstackstatus has quit IRC | 19:58 | |
*** openstackstatus has joined #storyboard | 20:01 | |
*** ChanServ sets mode: +v openstackstatus | 20:01 | |
*** jcoufal has quit IRC | 20:18 |
Generated by irclog2html.py 2.14.0 by Marius Gedminas - find it at mg.pov.lt!