Metadata-Version: 2.1
Name: swh.fuse
Version: 1.0.3
Summary: Software Heritage virtual file system
Home-page: https://forge.softwareheritage.org/source/swh-fuse
Author: Software Heritage developers
Author-email: swh-devel@inria.fr
License: UNKNOWN
Project-URL: Bug Reports, https://forge.softwareheritage.org/maniphest
Project-URL: Funding, https://www.softwareheritage.org/donate
Project-URL: Source, https://forge.softwareheritage.org/source/swh-fuse
Project-URL: Documentation, https://docs.softwareheritage.org/devel/swh-fuse/
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
Requires-Dist: PyYAML
Requires-Dist: aiosqlite
Requires-Dist: psutil
Requires-Dist: pyfuse3
Requires-Dist: python-daemon
Requires-Dist: requests
Requires-Dist: swh.core (>=0.10.0)
Requires-Dist: swh.model (>=0.7.0)
Requires-Dist: swh.web.client (>=0.2.5)
Provides-Extra: testing
Requires-Dist: pytest ; extra == 'testing'
Requires-Dist: requests ; extra == 'testing'
Requires-Dist: requests-mock ; extra == 'testing'

Software Heritage Filesystem (SwhFS)
====================================

User-space POSIX filesystem to browse the `Software Heritage
<https://www.softwareheritage.org/>`_ `archive
<https://archive.softwareheritage.org/>`_, as if it were locally available.

Built using the `FUSE <https://github.com/libfuse/libfuse>`_ framework.


Demo
----

A live demo of SwhFS in action is available as a `screencast
<https://www.youtube.com/watch?v=2L4ANVlICaE>`_.


Bibliography
------------

In addition to accompanying technical documentation, SwhFS is also described in
the following scientific paper. If you use SwhFS for your scientific results,
please acknowledge it by citing the paper as follows:

.. note::

  Thibault Allançon, Antoine Pietri, Stefano Zacchiroli. `The Software Heritage
  Filesystem (SwhFS): Integrating Source Code Archival with Development
  <https://arxiv.org/pdf/2102.06390.pdf>`_. In proceedings of `ICSE 2021
  <https://conf.researchr.org/home/icse-2021>`_: The 43rd International
  Conference on Software Engineering, May 2021, Madrid, Spain. IEEE 2021.

  Links: `preprint <https://arxiv.org/pdf/2102.06390.pdf>`_, `bibtex
  <https://upsilon.cc/~zack/research/publications/saner-2020-swh-graph.bib>`_.


