assembl.fabfile module

This file specifies how to do a number of installation tasks for Assembl. It uses the Fabric (1.13) remote executor. In most projects, it is separate from the code package, but many tasks need to be executed in an environment when only the assembl package is available. Some of the tasks also need to be executed before assembl is installed. The fab command can take a path to this file with the -f flag, and this file can also work well if invoked through a symbolic link.

assembl.fabfile.app_db_install()

Install db the first time and fake migrations

assembl.fabfile.circus_process_start(process_name)

Starts a circusd process, and waits till it started to return

assembl.fabfile.circus_process_stop(process_name)

Assuming the circusd process is running, stop one of its processes

assembl.fabfile.clone_repository()

Clone repository

assembl.fabfile.combine_rc(rc_filename, overlay=None)

Take a rc filename, load it as fabric would.

If it specifies an _extends value, consider this file to be an overlay of the named file.

assembl.fabfile.filter_global_names(rc_data)

Returns a copy of the dict with normalized key names. Some keys in rc files are prefixed with * or _ for ini conversion purposes, those are stripped. If the value is ‘__delete_key__’, the pair is filtered out.

assembl.fabfile.install_basetools()

Install required base tools

assembl.fabfile.install_yarn(local=True)

Install yarn

assembl.fabfile.is_db_updated()

Return if the database is update or not

assembl.fabfile.load_rcfile_config()

Load the enviroment from the .rc file.

assembl.fabfile.printenv()

Print shell env

assembl.fabfile.sanitize_env()

Ensure boolean and list env variables are such

assembl.fabfile.tests()

Run all tests on remote

assembl.fabfile.updatemaincode()

Update code and/or switch branch

assembl.fabfile.webservers_start()

Start all webservers

assembl.fabfile.webservers_stop()

Stop all webservers