Metadata-Version: 1.0
Name: floyd
Version: 0.0.3a2
Summary: A command line static website generator for popular cloud hosting providers
Home-page: http://github.com/nikcub/floyd
Author: Nik Cubrilovic <nikcub@gmail.com>
Author-email: nikcub@gmail.com
License: Copyright (c) 2010-2012, Nik Cubrilovic <nikcub@gmail.com> <http://nikcub.appspot.com>
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:

  1.  Redistributions of source code must retain the above copyright notice, 
      this list of conditions and the following disclaimer.

  2.  Redistributions in binary form must reproduce the above copyright notice, 
      this list of conditions and the following disclaimer in the documentation 
      and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> OR CONTRIBUTORS BE LIABLE FOR 
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON 
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Description: # Floyd v0.0.3-alpha
        
        An advanced MVC CMS that generates static sites for Google AppEngine and Amazon S3
        
        Usage: `floyd <sources> <outputdir>`
        
        # Features
        
        * Full MVC - define your routes, controllers, etc. and then generate
        * Full data model (eg. `floyd.db.Query('Posts').filter(post_type='page').order('-datetime').fetch()`)
        * Data model reads from flat source files
        * Convert text, markdown or HTML pages into HTML output
        * Automatically configures AppEngine sites
        * Supports different templating engine (defaults jinja2)
        
        # Install
        
        $ pip install floyd
        
        or if you don't have pip you can use easy_install (default on OS X and with python installations on other platforms)
        
        $ easy_install floyd
        
        # Usage
        
        $ cd /path/to/site
        $ floyd create
        [site created]
        $ floyd generate
        [site generated]
        $ floyd deploy appengine
        [site deployed] (in theory)
        
        # Help
        
        $ floyd help
        
        or for a command
        
        $ floyd help [command]
        
        # Upgrading to the latest stable release
        
        depends on your install method:
        
        $ pip install --upgrade floyd
        
        $ easy_install floyd
        
        $ git pull upstream
        $ python setup.py install
        
        # Latest Development Branch
        
        Using pip
        
        $ pip install -e git://github.com/nikcub/Floyd.git#egg=floyd
        
        Or straight from the git repository:
        
        $ git clone git://github.com/nikcub/Floyd floyd
        $ cd floyd
        $ python setup.py install
        
        # Google AppEngine Support
        
        * Download the [Google AppEngine SDK](http://code.google.com/appengine/downloads.html) for your platform and install it
        * Open the command line (Terminal in OS X, Command Prompt in Windows) and cd to the directory containing the generated site
        * Run: $ appcfg.py update .
        
        # Safe Password Storage
        
        If you have two-factor authentication activated with your Google ID, or you do not wish to store your Google password in configuration files (which is *strongly recommended*) then create a single-use password that is used in automatic deployments to Google App Engine from Floyd.
        
        To do this:
        
        1. Recommended: enable 2-step authentication by visiting the [Google Account](https://www.google.com/settings/) page and enabling the setting under 'Security' (switch '2-step verification' to on)
        1. Generate an application specific password by going to the [Authorized Access Settings Page](https://accounts.google.com/b/0/IssuedAuthSubTokens)
        1. Under the heading 'Application Specific Passwords' enter a name such as `floyd deploy` and generate a password
        1. Store the generated password in your Floyd configuration file under `password` (spaces are not important, they are there for legibility)
        
Keywords: website,appengine,s3,cms,blog
Platform: linux
Platform: osx
Platform: win32
