Difference between revisions of "Autobuild Shell Functions"

From Second Life Wiki
Jump to navigation Jump to search
m (Try to improve formatting of version 1.0 warning)
(Update instructions about autobuild source_environment with AUTOBUILD vs. autobuild warning)
 
(2 intermediate revisions by the same user not shown)
Line 3: Line 3:
{{Warning|This page describes autobuild 1.0. As of 2015-03-20, autobuild 1.0 can be found in [https://bitbucket.org/lindenlab/autobuild-1.0/ this repository]; as of this date, [https://bitbucket.org/lindenlab/autobuild/ the official repository] and [https://pypi.python.org/pypi/autobuild the PyPI package] are still at autobuild 0.8.}}
{{Warning|This page describes autobuild 1.0. As of 2015-03-20, autobuild 1.0 can be found in [https://bitbucket.org/lindenlab/autobuild-1.0/ this repository]; as of this date, [https://bitbucket.org/lindenlab/autobuild/ the official repository] and [https://pypi.python.org/pypi/autobuild the PyPI package] are still at autobuild 0.8.}}


Autobuild offers a set of shell functions for use in <code>build-cmd.sh</code> scripts which can be added to the environment by inserting the following line into any build script:
You can install autobuild 1.0 (e.g. into a [http://docs.python-guide.org/en/latest/dev/virtualenvs/ virtualenv]) from the alternate repository using a command such as (bash):
 
pip install 'hg+http://bitbucket.org/lindenlab/autobuild-1.0#egg=autobuild'
 
or (Windows command prompt):
 
pip install  hg+http://bitbucket.org/lindenlab/autobuild-1.0#egg=autobuild
 
Autobuild offers a set of shell functions for use in <code>build-cmd.sh</code> scripts which can be added to the environment by inserting lines such as the following into your build script:
<br clear=all/>
<br clear=all/>
<source lang="bash">eval "$("$AUTOBUILD" source_environment)"</source>
<source lang="bash">
if [ "$OSTYPE" == "cygwin" ]
then autobuild="$(cygpath -u "$AUTOBUILD")"
else autobuild="$AUTOBUILD"
fi
eval "$("$autobuild" source_environment)"
</source>
 
{{Warning|The AUTOBUILD environment variable is passed through a number of different programs written in different languages. On Windows, it is essential that AUTOBUILD be a pathname in native syntax (e.g. <tt>c:\Users\Joe\autobuild.exe</tt> or <tt>c:/Users/Joe/autobuild.exe</tt>) rather than cygwin syntax (e.g. <tt>/cygdrive/c/Users/Joe/autobuild.exe</tt>).}}
 
When invoking autobuild from within your <tt>build-cmd.sh</tt>, you must convert it to cygwin syntax so that cygwin bash doesn't get confused. However, it is '''essential''' to avoid overwriting the AUTOBUILD environment variable itself, or various child programs will, in turn, be confused. Capture the converted autobuild pathname in a ''different'' environment variable local to your script. Since bash environment variables are case-sensitive, it works to use <tt>autobuild</tt> for the cygwin-form path, leaving <tt>AUTOBUILD</tt> for the native-form path.


The exact shell code that is injected into your environment upon execution of this command [https://bitbucket.org/lindenlab/autobuild-1.0/src/tip/autobuild/autobuild_tool_source_environment.py?at=default#cl-161 is here], with (for Windows) additional functions [https://bitbucket.org/lindenlab/autobuild-1.0/src/tip/autobuild/autobuild_tool_source_environment.py?at=default#cl-250 here].
The exact shell code that is injected into your environment upon execution of this command [https://bitbucket.org/lindenlab/autobuild-1.0/src/tip/autobuild/autobuild_tool_source_environment.py?at=default#cl-161 is here], with (for Windows) additional functions [https://bitbucket.org/lindenlab/autobuild-1.0/src/tip/autobuild/autobuild_tool_source_environment.py?at=default#cl-250 here].

Latest revision as of 13:03, 20 March 2015


Warning!

This page describes autobuild 1.0. As of 2015-03-20, autobuild 1.0 can be found in this repository; as of this date, the official repository and the PyPI package are still at autobuild 0.8.


You can install autobuild 1.0 (e.g. into a virtualenv) from the alternate repository using a command such as (bash):

pip install 'hg+http://bitbucket.org/lindenlab/autobuild-1.0#egg=autobuild'

or (Windows command prompt):

pip install  hg+http://bitbucket.org/lindenlab/autobuild-1.0#egg=autobuild

Autobuild offers a set of shell functions for use in build-cmd.sh scripts which can be added to the environment by inserting lines such as the following into your build script:

if [ "$OSTYPE" == "cygwin" ]
then autobuild="$(cygpath -u "$AUTOBUILD")"
else autobuild="$AUTOBUILD"
fi
eval "$("$autobuild" source_environment)"
Warning!

The AUTOBUILD environment variable is passed through a number of different programs written in different languages. On Windows, it is essential that AUTOBUILD be a pathname in native syntax (e.g. c:\Users\Joe\autobuild.exe or c:/Users/Joe/autobuild.exe) rather than cygwin syntax (e.g. /cygdrive/c/Users/Joe/autobuild.exe).


When invoking autobuild from within your build-cmd.sh, you must convert it to cygwin syntax so that cygwin bash doesn't get confused. However, it is essential to avoid overwriting the AUTOBUILD environment variable itself, or various child programs will, in turn, be confused. Capture the converted autobuild pathname in a different environment variable local to your script. Since bash environment variables are case-sensitive, it works to use autobuild for the cygwin-form path, leaving AUTOBUILD for the native-form path.

The exact shell code that is injected into your environment upon execution of this command is here, with (for Windows) additional functions here.

General functions

Shell functions provided by autobuild:

Function Description
pass Indicates build has succeeded
fail $comment Indicates build has failed, citing $comment in the output
fetch_archive $url $archive $md5 Uses curl to download $archive from the $url and checks the downloaded file hash against the $md5 provided.
extract $file Extracts contents of an archive appropriate for the tar extension of $file.
calc_md5 $file Calculate the md5 of $file

Windows-only commands

Windows-only shell commands (Cygwin):

Function Description
build_vcproj $vcproj $config Launches a Visual Studio build of $vcproj, building configuration $config.

If $USE_INCREDIBUILD is set, the same build is launched via BuildConsole, Incredibuild's command-line launcher.

build_sln $sln $config $project Launches a Visual Studio build using the solution file $sln, configuration $config, and specifying project $project.

If $project is omitted, then the entire solution will be built.

load_vsvars Import Visual Studio paths, includes and libs into the shell environment