Metadata-Version: 2.1
Name: thumbtack
Version: 0.4.2
Summary: Service to manage disk image mounts.
Home-page: https://github.com/mitre/thumbtack
Author: The MITRE Corporation
Author-email: thumbtack@mitre.org
License: Apache 2.0
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Security
Classifier: Topic :: System :: Filesystems
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.4.0
Description-Content-Type: text/x-rst
Requires-Dist: Click
Requires-Dist: Flask-RESTful
Requires-Dist: Flask (==2.3.2)
Requires-Dist: gunicorn
Requires-Dist: imagemounter-mitre (==2023.9.5)
Requires-Dist: requests
Provides-Extra: dev
Requires-Dist: bumpversion ; extra == 'dev'
Requires-Dist: coverage ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: python-magic ; extra == 'dev'
Requires-Dist: pytsk3 ; extra == 'dev'
Requires-Dist: sphinx ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx ; extra == 'docs'
Provides-Extra: test
Requires-Dist: coverage ; extra == 'test'
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: pytest-cov ; extra == 'test'


.. image:: https://github.com/mitre/thumbtack/actions/workflows/thumbtack_workflow.yml/badge.svg?branch=master
    :target: https://github.com/mitre/thumbtack/actions

thumbtack
=========

Thumbtack is a web front-end providing a REST-ful API to mount and unmount
forensic disk images, built on top of the |imagemounter|_ library.

Documentation is available in the ``docs/`` directory or online at
https://thumbtack.readthedocs.io/en/latest.

Quick Start
-----------

.. code-block:: bash

    $ pip install thumbtack
    $ cd path/to/disk/image/files
    $ thumbtack
      * Serving Flask app "thumbtack" (lazy loading)
      * Environment: production
        WARNING: This is a development server. Do not use it in a production deployment.
        Use a production WSGI server instead.
      * Debug mode: off
      * Running on http://127.0.0.1:8208/ (Press CTRL+C to quit)

Then go to http://127.0.0.1:8208 and start mounting and unmounting images!

Find a full tutorial in ``docs/tutorial.rst``.

Quick Reference
---------------

.. code-block:: bash

    $ thumbtack --help
    Usage: thumbtack [OPTIONS]

    Options:
      -d, --debug                   Run the Thumbtack server in debug mode
      -h, --host TEXT               Host to run Thumbtack server on  [default: 127.0.0.1]
      -p, --port TEXT               Port to run Thumbtack server on  [default: 8208]
      -m, --mount-dir TEXT          Directory to mount disk images  [Default: /mnt/thumbtack]
      -i, --image-dir TEXT          Directory of disk images for Thumbtack server to
                                    monitor  [default: $CWD]
      --db TEXT                     SQLite database to store mount state  [default:
                                    database.db]
      -b, --base-url TEXT           Base URL where Thumbtack is hosted on the server
      --path-contains TEXT          Only select files containing specified string in the path
      -s, --skip-subdirectory TEXT  Subdirectory to ignore when monitoring files
      --help                        Show this message and exit.

LICENSE
-------

Thumbtack is licensed under the `Apache License, Version 2.0
<https://www.apache.org/licenses/LICENSE-2.0.html>`_. See the `LICENSE` file for
more information.

RELEASE STATEMENT
-----------------
Approved for Public Release; Distribution Unlimited. Public Release Case Number 19-0358.


.. |imagemounter| replace:: ``imagemounter``
.. _imagemounter: https://imagemounter.readthedocs.io/en/latest/


