travis(8)

NAME
travis - TracisCi local emulator

SYNOPSIS
travis [-hBC] [-c file] [-D number] [-d] [-EFfjk] [-L number] [-l dir] [-Mmn] [-O git-org] [-pqr] [-S false|true] [-Vv] [-X 0|1] [-Y file] [-y pyver] [-Z] [action sub sub2]

DESCRIPTION
travis can emulate TravisCi parsing the .travis.yml file in local Linux machine. You can test your application before pushing code to github.com web site.

Travis emulator can creates all the builds declared in .travis.yml; all builds are executed in sequential way. The directory ~/travis_log (see -l switch) keeps the logs of all created builds. Please note that log file is a binary file with escape ANSI screen code.
If you want to see the log use one of following command:

    travis show-log

A travis build executes the following steps:

    * Initialize from local .travis.conf (not in travis-ci.org)
    * Optional install packages apt addons (emulator does not install, it makes just the check)
    * Optional install packages cache
    * Set global values env global
    * Execute code from before_install
    * Execute matrix initialization, included python version
    * Execute build code from install
    * Execute build code from before_script
    * Execute build code from script
    * TravisCi executes build from before_cache (only if cache is effective, not emulated)
    * TravisCi executes build code from after_success (emulated) or after_failure (not emulated)
    * TravisCi execute optional code before_deploy (only if deployment is effective, not emulated)
    * TravisCi execute optional code deploy (not emulated)
    * TravisCi executes optional code after_deploy (only if deployment is effective, not emulated)
    * TravisCi executes code after_script (not emulated)
    * Wep from local .travis.conf (not in travis-ci.org)
Read furthermore info read travis job lifecycle (https://docs.travis-ci.com/user/job-lifecycle/)

Action is one of:
    * help
    * emulate
    * force-lint
    * lint
    * force-test
    * test
    * chkconfig
    * parseyaml
    * show-color
    * show-log
    * summary
    * wep_db

emulate
    Emulate TravisCi
    Start TravisCi emulator processing current .travis.yml file. This is the default action.

force-lint
    Start TravisCi emulator processing current .travis.yml file and setting LINT_CHECK variabile to value "1" and TESTS to value "0". In this way the build of linting is always executed.

force-test
    Start TravisCi emulator processing current .travis.yml file, setting TESTS to value "1" and LINT_CHECK variabile to value "0". In this way the build of test is always executed.

lint
    Start TravisCi emulator processing current .travis.yml file and execute just build with LINT_CHECK="1". In this way only the build of linting is executed.

show-color
    Show colored message meaning

show-log
    Show last log

summary
    Show last log summary

test
    Start TravisCi emulator processing current .travis.yml file and execute just build with TESTS="1". In this way only the build of test is executed.

web-db
    Remove virtual environments and postgres database created by previous travis emulator interupted

OPTIONS

-B --debug
    Run in debug mode without creating log file and enable pdb for local debug

-c --conf file
    Local travis configuration file (default .travis.conf)

-D debug-level
    Set travis_debug_mode: may be 0,1,2,8 or 9
    default value from .travis.yml

-d --osx
    Emulate Darwin osx operating system
    This mean readlink is replaced by greadlink

-k --keep
    Keep virtual environment and databases after builds are terminated

-L lint-level_level
    Set lint_check_level: may be minimal,reduced,average,nearby,oca
    default value from .travis.yml

-S --syspkg true|false
    use python system packages
    default value from .travis.yml

-V  Show version

-v  Verbose mode

EXAMPLES
travis

BUGS
No known bugs.

AUTHOR
Antonio Maria Vigliotti (antoniomaria.vigliotti@gmail.com)