= Codelite Workspace Layout for building Cobra compiler =

The files in the [wiki:CodeLite1 tarfile cobrac-workspace.tar.gz] and on [http://bitbucket.org/hops/cobra/src/tip/IDE/CodeLite/ bitbucket/CodeLite] contain a codelite-workspace directory tree under directory 'codelite' that 
contains a '''cobrac''' workspace and associated project and support files that provides a cobra compiler building workspace.

This directory should be installed in the root of your cobra build directory (as a sibling to directories 'Developer', 'Source', '!HowTo', etc)
giving 
{{{
637 xx:...src/cobra/wkspace> lsd
Developer/
HowTo/
Reusables/
Samples/
SamplesInProgress/
Source/
Supplements/
Tests/
codelite/
638 xx:...src/cobra/wkspace> ls -1 codelite
 ls -1 codelite
BuildAll.project
Cobra.Lang.project
Tests.project
build-files
cobra.project
cobrac.project
cobrac.tags
cobrac.workspace
lib-build-files
main.cobra
tags
testify.project
639 xx:...src/cobra/wkspace>
}}}

Run !CodeLite and get it to open the workspace file in the <above directory>/codelite/cobrac.workspace[[BR]]

Viola - cobra compiler inna IDE. Browse, edit, build...

== Contents ==

One workspace cobrac

Three projects
 * cobra - compiler
 * Cobra.Lang - compiler runtime Library
 * testify - compiler tests
 * ( should be an additional project for building compiler !ObjectExplorer

The cobra project uses the Snapshot compiler and libs to build itself. The build uses provided build filelist from 'files-to-compile.text'.

Cobra.Lang has dependency on cobra and builds Cobra.Lang.dll uses build filelist Cobra.Lang/files.text.

testify runs through Test directory sources building and running everything - results stored in file r-testify

== cobra ==
Builds compiler from 'Source' directory and associated subdirectories (shown as sibling virtual directories).
 * 00-Resources - build files list, small sample app, test output file.
 * 01-Batchfiles - Windows batchfiles for commandline build on windows
 * 01-Scripts - bash scripts for a linux build
 * 02-Doc - (Developer) Documentation files, License and Readme for project
 * 04-!HowTo - Sources showing hoto do various things in cobra
 * 06-Samples - sample sources showing some examples of larger apps.

== Cobra.Lang ==
Resources virtual dir has build files list. Remaining sources are listed under srcs virtual directory.

The '''Build''' (project popup) menu item creates Cobra.Lang.dll in the Source directory.



== testify ==
One virtual directory for each dir in ./Tests.

Run all tests with '''Build''' menu item  on testify project.

Can test run a single file with '''Compile''' menu item on a single file.

Can run tests for all files in a particular directory by selecting the 'Preprocess' menu item on any file in the directory.
( unfortunately no build/compile options for a !CodeLite virtual directory)