foodogsquared/wiki
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/wiki.git synced 2025-01-30 22:57:59 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
master
wiki/notebook/tools.swh-fuse.org
Gabriel Arazas 549f476c4c Update the notebook 
The topics I've covered so far for Linux, package managers, archiving,
and learning.

I also updated some formatting for other notes especially with the
command line references.
2021-07-29 23:26:51 +08:00

1.6 KiB
Raw Permalink Blame History

swh.fuse

A tool to interact with the Software Heritage Filesystem (SwhFS); you can see The Software Heritage Filesystem (SwhFS): Integrating Source Code Archival with Development paper for an introduction.

Some details about the tool itself…

  • It is mainly used with the swh fs subcommand.
  • To mount the filesystem itself, use swh fs mount DIRECTORY.

When mounted, the directory should have the following structure:

swhfs
├── archive/
├── cache/
├── origin/
└── README
  • archive/ is the entry point for the archived repos in the library; the files inside there cannot be listed (e.g., ls, file managers) but you can access the files inside of it (e.g., text editors, file openers)
  • cache/ contains on-disk representation of metadata
  • origin/ is where mounting of origins with an encoded URL

For up-to-date information, you can read the README file.

With the complete setup, you are now ready to interact with the filesystem. The point of interest here is the archive/ directory which holds all of the objects in the merkle tree. You can see the model data from their documentation.

You can interact with it by accessing one of the repo through their SWHID.

ls swhfs/archive/${SWHID}

The tool lazily loads the repo, saving bandwidth and disk space.