Implement file ID service

[davidbrochart]

This is the counterpart of jupyter-server-fileid.

[kevin-bates]

I thought the path parameter to index() and get_id(), etc. was an api-path (i.e., a path relative to the root_dir or what would be termed as the content_root), but I don't see anywhere that is pre-pending a "root" to the api-path.

Does Jupyverse have the notion of a source root or are all paths absolute from the git-go? Does it support non-filesystem-based content? (I suppose this is purely a matter of "plugging in" a different contents module.)

[davidbrochart]

Does Jupyverse have the notion of a source root or are all paths absolute from the git-go?

Not yet, see #236.

Does it support non-filesystem-based content?

There is currently only a filesystem-based contents plugin, but this is definitely coming.

[kevin-bates]

Hi David. I hope its okay to provide some suggestions even while this is in draft mode.

[davidbrochart]

Hi David. I hope its okay to provide some suggestions even while this is in draft mode.

Thanks for the comments Kevin! They are all very relevant, I'll make the suggested changes 👍

[Wh1isper]

Out of curiosity, why not use os.stat_result.st_ino to identify whether the file is the original file (in the case of mv, etc.)

[Wh1isper]

Out of curiosity, why not use os.stat_result.st_ino to identify whether the file is the original file (in the case of mv, etc.)

For those of you who have the same questions as me, there doesn't seem to be a good solution across systems

jupyter-server/jupyter_server_fileid#2 (comment)

[davidbrochart]

There is this error on server shutdown:

[E 2022-11-23 15:51:17 asyncio] unhandled exception during asyncio.run() shutdown
task: <Task finished name='Task-3' coro=<FileIdManager.watch_files() done, defined at /home/david/github/davidbrochart/jupyverse/plugins/contents/fps_contents/fileid.py:84> exception=RuntimeError('Already borrowed')>
Traceback (most recent call last):
  File "/home/david/github/davidbrochart/jupyverse/plugins/contents/fps_contents/fileid.py", line 102, in watch_files
    async for changes in awatch("."):
  File "/home/david/.local/share/hatch/env/virtual/jupyverse/PUXaZIS7/dev.jupyterlab-noauth/lib/python3.10/site-packages/watchfiles/main.py", line 238, in awatch
    with RustNotify([str(p) for p in paths], debug, force_polling, poll_delay_ms, recursive) as watcher:
RuntimeError: Already borrowed

See these issues:

• Bug in RustNotify causing RuntimeError: Already borrowed on exit/signal samuelcolvin/watchfiles#200
• RuntimeError: Already borrowed when using context managers PyO3/pyo3#2525