Metadata-Version: 1.1
Name: dropafile
Version: 0.1.1
Summary: Drop me a file on a webpage.
Home-page: https://github.com/ulif/dropafile/
Author: Uli Fouquet
Author-email: uli@gnufix.de
License: GPL 3.0
Description: dropafile
        =========
        
        Drop me a file, securely.
        
        |build-status|_ | `documentation <http://dropafile.readthedocs.org/>`_ | `sources <https://github.com/ulif/dropafile>`_ | `issues <https://github.com/ulif/dropafile/issues>`_
        
        .. |build-status| image:: https://travis-ci.org/ulif/dropafile.png?branch=master
        .. _build-status: https://travis-ci.org/ulif/dropafile
        
        
        `dropafile` provides an HTTPS-secured webapp where users can drop
        files.
        
        It is meant as a channel to deliver documents in a not-too-unsecure
        manner. For instance as a quickly installable workaround if people are
        not able or willing to use GnuPG or similar, although they have
        sensible documents to send.
        
        `dropafile` is written in Python (server parts) and uses the
        `dropzonejs`_ JavaScript library (client parts). The builtin server is
        based on Werkzeug_.
        
        Install
        -------
        
        As a user, run::
        
          $ pip install dropafile
        
        then, start the local server::
        
          $ dropafile
          Creating temporary self-signed SSL certificate...
          Done.
          Certificate in: /tmp/tmp1y2bgh/cert.pem
          Key in:         /tmp/tmp1y2bgh/cert.key
          Password is: H93rqnsrdEXD2ad3rQwdWqZ
           * Running on https://localhost:8443/ (Press CTRL+C to quit)
        
        The server will provide SSL. Users can access `dropafile` sevice
        pointing their browsers to the location given. The page is protected
        by basic auth. Users will have to provide an arbitrary user name and
        the password displayed on the commandline at startup (which changes
        with restart).
        
        The `--help` option will display all available options::
        
          $ dropfile --help
          usage: dropafile [-h] [--host HOST] [-p PORT] [-s PASSWORD]
        
          Start dropafile app.
        
          optional arguments:
            -h, --help            show this help message and exit
            --host HOST           Host we bind to. An IP address or DNS name.
                                  `localhost` by default.
            -p PORT, --port PORT  Port we listen at. An integer. 8443 by default.
            -s PASSWORD, --secret PASSWORD
                                  Password to access dropafile. If none is given we
                                  generate one.
        
        Whenever a user sends a file, the path is displayed on the
        commandline.
        
        
        Developer Install
        -----------------
        
        Developers should install a `virtualenv`_ first::
        
          $ virtualenv -p /usr/bin/python2.7 py27  # for Python2.7
        
        See `tox.ini` for all Python versions supported.
        
        Activate the virtualenv::
        
          $ source py27/bin/activate
          (py27) $
        
        Now build the devel environment::
        
          (py27) $ python setup.py dev
        
        You can run tests like this::
        
          (py27) $ py.test
        
        Tests for all supported (and locally available) Python vesions can be
        run by::
        
          (py27) $ pip install tox  # neccessary only once per virtualenv
          (py27) $ tox
        
        
        .. _virtualenv: https://virtualenv.pypa.io/
        .. _dropzonejs: http://www.dropzonejs.com/
        .. _Werkzeug: http://werkzeug.pocoo.org/
        
        Changes
        =======
        
        0.1.1 (2015-03-30)
        ------------------
        
        - Turned former `dropafile` module into a Python package. This is to
          fix installation behvior where data files are installed in different
          locations depending on install tool. See `diceware bug #1
          <https://github.com/ulif/diceware/issues/1>`_.
        
          The problem was revealed by `conorsch
          <https://github.com/conorsch>`_ for the `diceware
          <https://github.com/ulif/diceware>`_ package.
        
        
        0.1 (2015-03-22)
        ----------------
        
        - Initial release.
        
Keywords: web drop file wsgi
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: CGI Tools/Libraries
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: CPython
