Comment #3 on issue 1685 by pekka.klarck: distutils/setuptools integration
http://code.google.com/p/robotframework/issues/detail?id=1685

Do I get it right that if above changes are applied and Robot installed, you just need to add

    [build_rf_docs]
    libraries = "OneLibrary TwoLibrary"

to your setup.cfg and library docs are generated if you run your own setup.py like

    python setup.py build_rf_docs

That sounds pretty neat and the code doesn't look too complicated either. I have few question/concerns about this, though:

1) Are entry points a setuptools feature? Robot's setup.py currently doesn't use setuptools (unless you use 'develop' mode) and I'm worried requiring it would be problematic for Jython and IronPython compatibility. Obviously entry points could be enabled conditionally, but I don't like making setup.py too dynamic and complicated.

2) This feature should be documented somewhere. Most likely we could add a section to Libdoc's docs in User Guide, but I'm slightly worried would anyone find it from there.

One way to resolve the above issues would be releasing this functionality as a separate pip-installable project. That would also have a benefit that this tool could be enhanced separately from Robot. What do you think about that? Would you be interested in creating such a project?

--
You received this message because this project is configured to send all issue notifications to this address.
You may adjust your notification preferences at:
https://code.google.com/hosting/settings

--

--- You received this message because you are subscribed to the Google Groups "robotframework-commit" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/d/optout.

Reply via email to