Metadata-Version: 1.1
Name: cfupload
Version: 0.5.1
Summary: A very simple Rackspace Cloud Files uploader
Home-page: https://github.com/DavidWittman/Simple-Cloud-Files-Uploader
Author: David Wittman
Author-email: david@wittman.com
License: BSD
Description: # Simple Cloud Files Uploader
        Python script to quickly upload files to [Rackspace Cloud Files](http://www.rackspace.com/cloud/files/) or [OpenStack Swift](http://swift.openstack.org). Originally developed to make one-liner uploads more manageable. Supports input via file arguments or standard input.
        
        ## Installation
        For the love of Guido, use [virtualenv](http://www.virtualenv.org/en/latest/index.html) with whichever of the following methods you choose:
        
        ### pip
        ``` bash
        $ pip install cfupload
        ```
        
        ### EasyInstall
        ``` bash
        $ easy_install cfupload
        ```
        
        ### setuptools
        ``` bash
        $ git clone git://github.com/DavidWittman/Simple-Cloud-Files-Uploader.git
        $ cd Simple-Cloud-Files-Uploader
        $ python setup.py install
        ```
        
        ## Usage
        
        ```
        usage: cfupload [-h] [-k <api key>] [-u <username>] [-a <auth_url>] [-s]
                        [-o <filename>] [-q] [-c]
                        container [files [files ...]]
        
        Upload files to Rackspace Cloud Files or Openstack Swift.
        
        positional arguments:
          container             Container name in Cloud Files or Openstack Swift
          files                 The file(s) to upload
        
        optional arguments:
          -h, --help            show this help message and exit
        
        Cloud Files Connection Information:
          -k <api key>, --apikey <api key>
                                API key. Defaults to env[CLOUD_FILES_APIKEY]
          -u <username>, --user <username>
                                Username. Defaults to env[CLOUD_FILES_USERNAME]
          -a <auth_url>, --auth <auth_url>
                                Authentication endpoint. Defaults to
                                env[CLOUD_FILES_AUTH_URL]
          -s, --snet            Use ServiceNet for connections
        
        Output options:
          -o <filename>, --file <filename>
                                Destination filename in Cloud Files or Openstack Swift
          -q                    Silence output
          -c, --cdn             Print CDN URL to stdout
        ```
        
        ## Examples
        
        Each of these examples assume you have the environment variables `CLOUD_FILES_AUTH_URL`, `CLOUD_FILES_USERNAME` and `CLOUD_FILES_APIKEY` exported. Alternatively, you can pass the username, auth_url and API key in as options with `-u`,`-a` and `-k`, respectively.
        
        ### Upload a single file
        
        ``` bash
        $ cfupload mycontainer ~/F4z2L.gif
        ```
        
        ### Upload multiple files
        
        ``` bash
        $ cfupload gifs ~/Pictures/*.gif
        ```
        
        ### Upload from stdin
        
        ``` bash
        $ tar cvzf - ~/important/* | cfupload -o backup-$(date '+%Y%m$d') backups
        ```
        
        ## Pro Tips
        * Export environment variables `CLOUD_FILES_{APIKEY,USERNAME,AUTH_URL}` in your bash_profile to prevent the need to specify these options each time you run cfupload
        * A destination filename must be provided with -o when uploading from standard input
        * Pipe your files from standard input to make cronjob backups stupid easy:
        `# mysqldump --all-databases | gzip -c | cfupload -o backup-$(date '+%Y%m%d').sql.gz container`
        
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: BSD License
