{ "info": { "author": "Sebastian M. Ernst", "author_email": "ernst@pleiszenburg.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "Intended Audience :: Science/Research", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Operating System :: MacOS", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3 :: Only", "Programming Language :: Python :: Implementation :: CPython", "Topic :: Scientific/Engineering", "Topic :: Software Development :: Libraries", "Topic :: Software Development :: Testing", "Topic :: System :: Archiving", "Topic :: System :: Filesystems", "Topic :: System :: Logging", "Topic :: System :: Monitoring", "Topic :: System :: Systems Administration", "Topic :: Utilities" ], "description": ".. |build_master| image:: https://img.shields.io/travis/pleiszenburg/loggedfs-python/master.svg?style=flat-square\n\t:target: https://travis-ci.org/pleiszenburg/loggedfs-python\n\t:alt: Build Status: master / release\n\n.. |build_develop| image:: https://img.shields.io/travis/pleiszenburg/loggedfs-python/develop.svg?style=flat-square\n\t:target: https://travis-ci.org/pleiszenburg/loggedfs-python\n\t:alt: Build Status: development branch\n\n.. |license| image:: https://img.shields.io/pypi/l/loggedfs.svg?style=flat-square\n\t:target: https://github.com/pleiszenburg/loggedfs/blob/master/LICENSE\n\t:alt: Project License: Apache License v2\n\n.. |status| image:: https://img.shields.io/pypi/status/loggedfs.svg?style=flat-square\n\t:target: https://github.com/pleiszenburg/loggedfs-python/milestone/1\n\t:alt: Project Development Status\n\n.. |pypi_version| image:: https://img.shields.io/pypi/v/loggedfs.svg?style=flat-square\n\t:target: https://pypi.python.org/pypi/loggedfs\n\t:alt: Available on PyPi - the Python Package Index\n\n.. |pypi_versions| image:: https://img.shields.io/pypi/pyversions/loggedfs.svg?style=flat-square\n\t:target: https://pypi.python.org/pypi/loggedfs\n\t:alt: Available on PyPi - the Python Package Index\n\n.. |loggedfs_python_logo| image:: http://www.pleiszenburg.de/loggedfs-python_logo.png\n\t:target: https://github.com/pleiszenburg/loggedfs-python\n\t:alt: LoggedFS-python repository\n\n|build_master| |build_develop| |license| |status| |pypi_version| |pypi_versions|\n\n|loggedfs_python_logo|\n\nSynopsis\n========\n\nLoggedFS-python is a FUSE-based filesystem which can log every operation that happens in it.\nIt is a pure Python re-implementation of `LoggedFS`_ by `R\u00e9mi Flament`_ maintaining CLI compatibility.\nThe project is heavily inspired by `Stavros Korokithakis`_' 2013 blog post entitled\n\"`Writing a FUSE filesystem in Python`_\" (`source code repository`_).\nThe filesystem is fully `POSIX`_ compliant, passing the `pjdfstest test-suite`_, a descendant of FreeBSD's `fstest`_.\nIt furthermore passes stress tests with fsx-linux based on the `fsx-flavor`_ released by the `Linux Test Project`_.\nIt is intended to be suitable for production systems.\n\n.. _LoggedFS: https://github.com/rflament/loggedfs\n.. _R\u00e9mi Flament: https://github.com/rflament\n.. _Stavros Korokithakis: https://github.com/skorokithakis\n.. _Writing a FUSE filesystem in Python: https://www.stavros.io/posts/python-fuse-filesystem/\n.. _source code repository: https://github.com/skorokithakis/python-fuse-sample\n.. _POSIX: https://en.wikipedia.org/wiki/POSIX\n.. _pjdfstest test-suite: https://github.com/pjd/pjdfstest\n.. _fstest: https://github.com/zfsonlinux/fstest\n.. _fsx-flavor: http://codemonkey.org.uk/projects/fsx/\n.. _Linux Test Project: https://github.com/linux-test-project/ltp\n\n\nCAVEATS\n=======\n\n* PROJECT STATUS: **BETA**\n* THE FILESYSTEM IS CURRENTLY **ONLY** BEING DEVELOPED FOR AND TESTED ON **LINUX**.\n ANYONE INTERESTED IN CONFIRMING MAC OS X AND/OR ADDING BSD SUPPORT?\n\n\nInstallation\n============\n\nFrom the `Python Package Index`_ (PyPI):\n\n.. code:: bash\n\n\tpip install loggedfs\n\nFrom GitHub:\n\n.. code:: bash\n\n\tpip install git+https://github.com/pleiszenburg/loggedfs-python.git@master\n\n**Supports Python 3.{4,5,6,7}.**\n\n**Supports Linux.**\nSupport for MAC OS X is implemented but has yet not been tested.\n\n.. _Python Package Index: https://pypi.org/\n\n\nSimple usage example\n====================\n\nTo start recording access to ``/tmp/TEST`` into ``/root/log.txt``, just do:\n\n.. code:: bash\n\n\tsudo loggedfs -p -s -l /root/log.txt /tmp/TEST\n\nTo stop recording, just unmount as usual:\n\n.. code:: bash\n\n\tsudo fusermount -u /tmp/TEST\n\n\nConfiguration\n=============\n\nLoggedFS-python can use an XML configuration file if you want it to log operations only for certain files, for certain users, or for certain operations. LoggedFS-python is fully compatible with configuration files in LoggedFS' original format. Yet it can also handle additional fields (e.g. the ``command`` field).\n\nHere is a sample configuration file :\n\n.. code:: xml\n\n\t\n\n\t\n\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\n\nThis configuration can be used to log everything except if it concerns a\n``*.bak`` file, or if the ``uid`` is 1000, or if the operation is ``getattr``.\n\n\nNeed help?\n==========\n\nFeel free to post questions in the `GitHub issue tracker`_ of this project.\n\n.. _GitHub issue tracker: https://github.com/pleiszenburg/loggedfs-python/issues\n\n\nBugs & issues\n=============\n\nPlease report bugs in LoggedFS-python here in its `GitHub issue tracker`_.\n\n\nMiscellaneous\n=============\n\n- Full project documentation\n\n - at `Read the Docs`_\n - at `LoggedFS-python repository`_\n\n- `License`_ (**Apache License 2.0**)\n- `Contributing`_ (**Contributions are highly welcomed!**)\n- `FAQ`_\n- `Authors`_\n- `Changes`_\n- `Long-term ideas`_\n- `Upstream issues`_ (relevant bugs in dependencies)\n\n.. _Read the Docs: http://loggedfs-python.readthedocs.io/en/latest/\n.. _LoggedFS-python repository: https://github.com/pleiszenburg/loggedfs-python/blob/master/docs/index.rst\n.. _License: https://github.com/pleiszenburg/loggedfs-python/blob/master/LICENSE\n.. _Contributing: https://github.com/pleiszenburg/loggedfs-python/blob/master/CONTRIBUTING.rst\n.. _FAQ: http://loggedfs-python.readthedocs.io/en/stable/faq.html\n.. _Authors: https://github.com/pleiszenburg/loggedfs-python/blob/master/AUTHORS.rst\n.. _Changes: https://github.com/pleiszenburg/loggedfs-python/blob/master/CHANGES.rst\n.. _Long-term ideas: https://github.com/pleiszenburg/loggedfs-python/milestone/2\n.. _Upstream issues: https://github.com/pleiszenburg/loggedfs-python/issues?q=is%3Aissue+is%3Aopen+label%3Aupstream\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "https://github.com/pleiszenburg/loggedfs-python/archive/v0.0.5.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/pleiszenburg/loggedfs-python", "keywords": "filesystem,fuse,logging,monitoring", "license": "Apache License 2.0", "maintainer": "", "maintainer_email": "", "name": "loggedfs", "package_url": "https://pypi.org/project/loggedfs/", "platform": "", "project_url": "https://pypi.org/project/loggedfs/", "project_urls": { "Download": "https://github.com/pleiszenburg/loggedfs-python/archive/v0.0.5.tar.gz", "Homepage": "https://github.com/pleiszenburg/loggedfs-python" }, "release_url": "https://pypi.org/project/loggedfs/0.0.5/", "requires_dist": [ "click (>=7.0)", "refuse (==0.0.2)", "xmltodict", "coverage ; extra == 'dev'", "psutil ; extra == 'dev'", "pytest ; extra == 'dev'", "python-language-server ; extra == 'dev'", "PyYAML ; extra == 'dev'", "setuptools ; extra == 'dev'", "Sphinx ; extra == 'dev'", "sphinx-rtd-theme ; extra == 'dev'", "tap.py ; extra == 'dev'", "twine ; extra == 'dev'", "wheel ; extra == 'dev'" ], "requires_python": "", "summary": "Filesystem monitoring with Fuse and Python", "version": "0.0.5" }, "last_serial": 5231966, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "590d36b7eca4285a4798b24b37c0ff98", "sha256": "7c03316ff01d71af2f01ad99f21903b4fc35e86fdb3197870e522b4e84238ae1" }, "downloads": -1, "filename": "loggedfs-0.0.1-py3-none-any.whl", "has_sig": true, "md5_digest": "590d36b7eca4285a4798b24b37c0ff98", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 20009, "upload_time": "2019-04-11T19:50:08", "url": "https://files.pythonhosted.org/packages/e4/8d/896070fca466452d10ccfbe2df31b65062a958f997c3ee5e3d2c82b99cba/loggedfs-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b7b33871da38ddf30eb5d743464187ee", "sha256": "18dcaf167c699e68edf6af75c50925937b6807263074dbcf0d2160249a916a72" }, "downloads": -1, "filename": "loggedfs-0.0.1.tar.gz", "has_sig": true, "md5_digest": "b7b33871da38ddf30eb5d743464187ee", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11409, "upload_time": "2019-04-11T19:50:14", "url": "https://files.pythonhosted.org/packages/64/63/c6b40ba9ee378db812180c62728b8cd5211d19586439756cf073ad4dbf80/loggedfs-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "71c28c0a74e1504c927b72dc6943719d", "sha256": "155a8063a5207d69e7b720cb2265334a997d35aece3290a90db99132a848aef7" }, "downloads": -1, "filename": "loggedfs-0.0.2.tar.gz", "has_sig": true, "md5_digest": "71c28c0a74e1504c927b72dc6943719d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18797, "upload_time": "2019-04-23T16:09:53", "url": "https://files.pythonhosted.org/packages/24/1f/39d5d720475570cebeb64d4754c0b266f456e9fe081e9cf071cc33ed4a51/loggedfs-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "064819081d64d56333c56f8de43beb85", "sha256": "1ba5f0118fd3af861ffa8dea5a888957c40184be6f7ed49440efc4ad773bfcd1" }, "downloads": -1, "filename": "loggedfs-0.0.3.tar.gz", "has_sig": true, "md5_digest": "064819081d64d56333c56f8de43beb85", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20331, "upload_time": "2019-05-01T09:47:01", "url": "https://files.pythonhosted.org/packages/e2/13/1dbef9cf999c2e9c8cc457dce8aa95ffae9eb60f73bd9f15af4e7fec16ea/loggedfs-0.0.3.tar.gz" } ], "0.0.4": [ { "comment_text": "", "digests": { "md5": "28d7799b8877174b62081550b4430c55", "sha256": "4a433e07afc9f1377f051659355bd3d6fb98e9016f3b4ce9249a71c702f1bea0" }, "downloads": -1, "filename": "loggedfs-0.0.4.tar.gz", "has_sig": true, "md5_digest": "28d7799b8877174b62081550b4430c55", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23327, "upload_time": "2019-05-01T19:04:33", "url": "https://files.pythonhosted.org/packages/b5/22/c4cbc1a0952bf9d0dc238968c93fb546942f011d1c3aa9da9dc794a01a63/loggedfs-0.0.4.tar.gz" } ], "0.0.5": [ { "comment_text": "", "digests": { "md5": "8fc1336930c8d2059a5d7f8369f9b2ec", "sha256": "575dfb8f0fbf9e1bd705c5db8439cb079cb7e706e89b97e8cd376156b0547c7f" }, "downloads": -1, "filename": "loggedfs-0.0.5-py3-none-any.whl", "has_sig": true, "md5_digest": "8fc1336930c8d2059a5d7f8369f9b2ec", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 27377, "upload_time": "2019-05-06T10:18:50", "url": "https://files.pythonhosted.org/packages/30/e0/06c3db92fede31eb3a89dda10e38b684bd608a013876f74d2eb74fdcdd85/loggedfs-0.0.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0eee58f271da4ee9f3474e678fe63814", "sha256": "fc72701bd5d23cef175390fe33b11df6bb7a62598e2811e461ee4cc79b80bd9b" }, "downloads": -1, "filename": "loggedfs-0.0.5.tar.gz", "has_sig": true, "md5_digest": "0eee58f271da4ee9f3474e678fe63814", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22403, "upload_time": "2019-05-06T10:18:53", "url": "https://files.pythonhosted.org/packages/b1/58/e7f2017fdb08a18186a1ef4205f9eeb5a96a2dc0754757765bf6cd4a7d06/loggedfs-0.0.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8fc1336930c8d2059a5d7f8369f9b2ec", "sha256": "575dfb8f0fbf9e1bd705c5db8439cb079cb7e706e89b97e8cd376156b0547c7f" }, "downloads": -1, "filename": "loggedfs-0.0.5-py3-none-any.whl", "has_sig": true, "md5_digest": "8fc1336930c8d2059a5d7f8369f9b2ec", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 27377, "upload_time": "2019-05-06T10:18:50", "url": "https://files.pythonhosted.org/packages/30/e0/06c3db92fede31eb3a89dda10e38b684bd608a013876f74d2eb74fdcdd85/loggedfs-0.0.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0eee58f271da4ee9f3474e678fe63814", "sha256": "fc72701bd5d23cef175390fe33b11df6bb7a62598e2811e461ee4cc79b80bd9b" }, "downloads": -1, "filename": "loggedfs-0.0.5.tar.gz", "has_sig": true, "md5_digest": "0eee58f271da4ee9f3474e678fe63814", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22403, "upload_time": "2019-05-06T10:18:53", "url": "https://files.pythonhosted.org/packages/b1/58/e7f2017fdb08a18186a1ef4205f9eeb5a96a2dc0754757765bf6cd4a7d06/loggedfs-0.0.5.tar.gz" } ] }