Fetching contributors…
Cannot retrieve contributors at this time
110 lines (63 sloc) 2.78 KB

Management commands

Custom Django management commands for this library that help make things happen.


Bake out a site as flat files in the build directory, defined in by BUILD_DIR.

By default, this wipes the build directory if it exists, then builds any static files in the STATIC_ROOT to the STATIC_URL, any media files in the MEDIA_ROOT to the MEDIA_URL and all pages generated by the buildable views listed in BAKERY_VIEWS.

As a small bonus, files named robots.txt and favicon.ico will be placed at the build directory's root if discovered at the STATIC_ROOT.

Defaults can be modified with the following command options.

.. cmdoption:: --build_dir <path>

   Specify the path of the build directory. Will use ``settings.BUILD_DIR`` by default.

.. cmdoption:: --keep-build-dir

    Skip deleting and recreating the build directory before building files. By
    default the entire directory is wiped out.

.. cmdoption:: --skip-static

    Skip collecting the static files when building.

.. cmdoption:: --skip-media

    Skip collecting the media files when building.

$ python build

View names passed as arguments will override the BAKERY_VIEWS list.

$ python yourapp.views.DummyL­istView


Starts a variation of Django's runserver designed to serve the static files you've built in the build directory.

$ python buildserver


Syncs your Amazon S3 bucket to be identical to the local build directory. New files are uploaded, changed files are updated and absent files are deleted.

.. cmdoption:: --aws-bucket-name <name>

    Specify the AWS bucket to sync with. Will use settings.AWS_BUCKET_NAME by default.

.. cmdoption:: --build_dir <path>

    Specify the path of the build directory. Will use settings.BUILD_DIR by default.

.. cmdoption:: --force

    Force a re-upload of all files in the build directory to the AWS bucket.

.. cmdoption:: --dry-run

    Provide output of what the command would perform, but without changing anything.

.. cmdoption:: --no-delete

    Keep files in S3, even if they do not exist in the build directory. The
    default behavior is to delete files in the bucket that are not in the
    build directory.

$ python publish


Empties the build directory.

$ python unbuild


Empties the Amazon S3 bucket defined in

$ python unpublish