Nbdev discussion

jeremy · December 2, 2019, 11:42pm

Yes - fixed now. Thanks for letting us know.

jeremy · December 2, 2019, 11:42pm

I’ll be doing a video walk-thru soon of creating a project with nbdev - although it’ll be something much simpler than fastai v2!

ilovescience · December 3, 2019, 1:47am

Sounds great! Very interesting work! Looking forward to your walk-thru!

mllearner · December 3, 2019, 2:43am

Thanks for everything Loving the course information and videos.

ant3ng · December 3, 2019, 9:44am

Thanks for great cool tools. I’m so excited now.

I’m new to not just nbdev but github, so I have a question about README.

Is there any nbdev’s way to depict plotting image in README? Because I got stuck in following situation where plotting png appears in jupyter, but not in README.

moon · December 3, 2019, 1:28pm

for beginners editing settings.ini for nbdev:

the commented-out lines from “lib_name” down to “audience” and “language” should be uncommented and have reasonable values

Otherwise nbdev_build_lib will throw an error in regards to lib_path, which is the 2nd to last line referencing lib_name.

(The last two lines of settings.ini should not be changed by beginners. I was going to ask here for a solution to the error message "
configparser.InterpolationMissingOptionError: Bad value substitution: option ‘lib_path’ in section ‘DEFAULT’ contains an interpolation key ‘lib_name’ which is not a valid option name. Raw value: ‘%(lib_name)s’
" but found the solution while asking the question.)

sgaseretto · December 3, 2019, 2:00pm

How can I initialize nbdev in a repo that I already started and already has some notebooks?

kdorichev · December 3, 2019, 6:09pm

A PR with a minor fix to correct source link to repo of a user, not fastai.

givin.gg · December 3, 2019, 6:35pm

here is to praying that this plays nicely with MLFLow

mllearner · December 4, 2019, 12:44am

Thanks for this work fastAi team!!! I loved the D. Knuth books, even though I didn’t understand all of the material, I still learned a lot from his works.

Looking forward to tutorial videos and more example code/projects built using this.

nok · December 4, 2019, 1:50am

Thanks for releasing this tool! I am checking out the documentation.

nbdev_install_git_hooks ()
I believe these git hook should be general for most platform not limited to Github?

This command install git hooks to make sure notebooks are cleaned before you commit them to GitHub and automatically trusted at each merge. To be more specific, this creates:

sgugger · December 4, 2019, 2:33am

We don’t use anything else than github, so I don;t know if they work the same way on other platforms. Let us know if they are more general!

nok · December 4, 2019, 3:01am

Sure, I would like to test it with GitLab. I am trying to run nbdev_install_git_hooks in a local repository, it just hangs there and nothing got printed.

Here is what I have done.

pip install nbdev
make a new directory and create a dummy notebook
git init
nbdev_install_git_hooks
It hangs…

Maybe I am not using the command right?

sgugger · December 4, 2019, 3:14am

It’s likely the command would fail unless you have filled the setting.ini file (at least with lib_name at the very top).

nok · December 4, 2019, 5:47am

Thanks, I totally missed the part that it need to start with some template with config files.
Hooks works fine with local repository. The ReviewNB that Jeremy mentioned in the blog does not support GitLab, not sure if there are any alternatives for this.

Do you normally just use command line for things like git add? I tried to add files with the GUI of VS Code, it will cause error, but fine if I just add through command.

.

dzlob · December 4, 2019, 10:25am

Amazing package, just what I’ve been missing in my professional life.

I’ve been using it for about 10 hours now, and it has already made my professional life better.

qq: what is the best way to give feedback on bugs and functionality?

This forum or creating a github issue like this one?

donrcameron · December 4, 2019, 10:46am

Hi, big fan of fastai courses, so excited by nbdev. However, I am also a big fan of conda / Anaconda, and JupyterLab (next step after original Jupyter Notebooks)

Two questions:

1, will it be added to the Anaconda fastai channel, so its installation can be managed by conda?

will nbdev work with Notebooks produced by JupyterLab?

Thanks

dzlob · December 4, 2019, 11:04am

Hi Don, JupyterLab and Jupyter Notebooks are just ways for your browser to interact with files and kernels.

The underlying files (.ipynb) do not differ between them.

Hence, nbdev is already fully compatible with both Jupyterlab and Jupyter Notebook

donrcameron · December 4, 2019, 12:05pm

Hi David

I think that JupyterLab and original Jupyter have different extension interfaces (eg there are two black formatter extensions, one for lab, and one for plain Jupyter). However, I suspect that nbdev doesn’t use these interfaces, so I would agree that nbdev should be blind to the source of ipynb.

If nbdev is not be hosted on the fastai channel, that makes environment mgt a little harder for heavy users of conda (although I read that conda installs from a local tar file are possible, so maybe a tar file could be made available?)

Cheers

thiernodiop · December 4, 2019, 1:29pm

Hello, thanks for this awesome tool, was wondering how this can be used with gitlab, i know with github one can use nbreview to handle merge conflict but we use gitlab. any tips here. This is needed because we do code review. or do i have to use something like jupytext to still create py files and only commit the py files and not ipynb