Metadata-Version: 1.1
Name: drop
Version: 0.1.2
Summary: Uploads data to a remote www directory via scp and returns a public url.
Home-page: https://github.com/cod3monk/drop
Author: Julian Hammer
Author-email: julian.hammer@fau.de
License: AGPLv3
Description: drop
        ====
        
        Uploads data to a remote www directory via scp and returns a public url.
        
        Install
        -------
        Easiest way is to install via pip::
        
            pip install drop
        
        there are currently no dependencies other than python 2.7 or python 3.4.
        
        To install manually: copy drop/drop.py to any location of your preference
        
        Configure
        ---------
        A configuration file is required, it can be located at /etc/drop.cfg, ~/.drop.cfg or it's location passed via command line option --config-file.
        
        A sample config file would be::
            
            [DEFAULT]
            # reference to the default destination (section name):
            destination = hawo
        
            # You can set the following defaults:
            # Location of the scp command, can be relative or absolute path:
            scp = scp
            # default length (in characters) for hashfilenames (max. 28)
            hashlength = 28
            # default chmod to apply to uploaded files (already applied localy and uploaded with -p)
            # 436 this is 0o644
            chmod = 436
        
            # Destinations:
            [hawo]
            # remote server dns or alias from .ssh/config and may also include username (user@server):
            remoteserver = ente
            # remote directory can be relative (to home directory) or absolute:
            remotedir = public_html/d/
            # publishing url, this must represent the above directory:
            url = http://hawo.net/~sijuhamm/d/
            # all defaults can be overwritten for any destination. For example the hashlength:
            hashlength = 10
        
        The DEFAULT section configures default values for all other sections and the default destination. All other sections are so called destination sections. They can be selected via the --destination command line parameter.
        
        
        Usage
        -----
        You can pase a file by argument::
        
            $ drop defaults.cfg
            http://hawo.net/~sijuhamm/d/NcT0jFb5.cfg
            
        or any content via stdin::
        
            $ date | ./drop.py
            http://hawo.net/~sijuhamm/d/ephtK9DY
        
        The filename at the remote location is actually a partial sha1 checksum of the file. The length of the checksum can be set in the configuration file. The extension is preserved when possible and can also be overwritten with the --extension parameter.
        
        The full help message reads as follows::
        
            usage: drop [-h] [--destination DESTINATION] [--extension EXTENSION]
                        [--config-file CONFIG_FILE] [--test]
                        [infile]
        
            Uploads data to a remote www directory via scp and returns a public url.
        
            positional arguments:
              infile
        
            optional arguments:
              -h, --help            show this help message and exit
              --destination DESTINATION, -d DESTINATION
                                    Name of destination as found in configuration file.
              --extension EXTENSION, -e EXTENSION
                                    Overwrites extension on uploaded file.
              --config-file CONFIG_FILE, -c CONFIG_FILE
              --test                Runs a test on destination.
        
        TODOs
        -----
        Upcoming features:
         * automatic copying of url to clipboard
         * (maybe) support for other upload destinations
         * multiple file upload
         * compression and archiving before uploading (optional)
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Classifier: Topic :: Internet
Classifier: Environment :: Console
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS
Classifier: Operating System :: Unix
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
