|
|
|
|
|
by targafarian
1390 days ago
|
|
100% agreed. People use a great tool in a poor way and then broadly condemn the tool. And any tool that is sufficiently flexible to be broadly useful can be used in very poor ways. Jupyter is great, it gets me over the barrier potential for starting a task every time. I build and prove out an algorithm/task piece by piece. Once I'm happy, I move the meat of it to a function in a .py file, and move the code I used to test the algorithm to a unit test function. Delete the duplicated bits and replace with imports, and then what remains is a tutorial/demonstrator notebook using the function I wrote and maybe some nice plots to go along with that, that I wouldn't put in a unit test (nor that show up in docstrings). This can be converted to sphinx docs if the code gets big enough. What a great tool for incrementally building software! In my world, I build brick by brick, not all at once. Jupyter is a key to that process. |
|