Closed Helveg closed 4 years ago
For having such a small amount of files, the package structure is quite alien to me, where are the tests? 😄
Thanks for your interest in colour
package. I read your code, what is your rationale for this addition ? While I can see the functionality, I'm afraid of a few points:
pick_for
, picker
arguments, which are documented are probably very very close to what you want. In particular, RGB_color_picker()
is quite close to your implementation. I still understand that you might NOT need to pick a color for a specific entity in your code, but I would really be happy to hear more about such usage.In general, maybe you could have answered to these questions already by writing and documenting the functionality itself in README.rst
or in the doc of your functions/methods so as to convey to users and to reviewers your intention. This is of course missing (we need test and doc) and maybe stems from your ignorance of where are the tests... Well, there is 99% of coverage because every functionality is documented in the README.rst
and also in docs provided along methods, or objects in colour.py
, all this is automatically run by CI to insure us that every functionality is correctly presented in intention to users and that this doc is correctly tested. This is doctest
.
To run all these tests you can use: nosetests -sx .
The rationale is that it's more intuitive and convenient but I'll just keep this in my fork
I'm sorry if my answer seemed dry or offended you in any way. I hope I succeeded in sharing about how code inclusion can be added to the project (rationale in docs and tests). Any discussion is welcome here. I'm still curious and interested to hear more about the rationale (example of usage, and why you would need a random color without affecting it to at least an identifier), I feel these could be existing, but can't figure how exactly. While I can understand why you would qualify your proposal as "more intuitive and convenient", I'm not sure it can be alone answering the multiple points I have taken the time to pinpoint.
Oh I closed it because I'm not experienced enough in either nosetests (I'm used to unit tests) or colors to adequately address your points and turn this into a qualitative pull request :) Thanks for taking your time to look into this.
Codecov Report
96.28% <30.00%> (-2.86%)
Continue to review full report at Codecov.