Skip to content

Commit

Permalink
add tests directory and update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
pgdurand committed May 23, 2016
1 parent 3b38738 commit 7f0b9a4
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 17 deletions.
6 changes: 5 additions & 1 deletion gatb-core/scripts/NewProject/NewProject.sh
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,8 @@ function createGatbCoreDirectory(){
cp -r $GATB_CORE_PATH/tools $PROJECT_DIR/thirdparty/gatb-core/ || ERR=1
cp $GATB_CORE_PATH/CMakeLists.txt $PROJECT_DIR/thirdparty/gatb-core/ || ERR=1
cp $GATB_CORE_PATH/LICENCE $PROJECT_DIR/thirdparty/gatb-core/ || ERR=1
cp $GATB_CORE_PATH/README.md $PROJECT_DIR/thirdparty/gatb-core/ || ERR=1
cp $GATB_CORE_PATH/../README.md $PROJECT_DIR/thirdparty/gatb-core/ || ERR=1
cp $GATB_CORE_PATH/RELEASES.md $PROJECT_DIR/thirdparty/gatb-core/ || ERR=1
cp $GATB_CORE_PATH/THIRDPARTIES.md $PROJECT_DIR/thirdparty/gatb-core/ || ERR=1
else
printf "$1- Preparing GATB-Core link...\n"
Expand All @@ -140,6 +141,7 @@ function createOtherFiles(){
ERR=0
local MSG1="Place here the documentation of your tool, then remove this file."
local MSG2="Place here any other third-party librairies this tool relies on."
local MSG3="Place here test suites: scripts and/or small/medium sized data files."

printf "$1- Copying other files...\n"
# We copy the default README
Expand All @@ -152,6 +154,8 @@ function createOtherFiles(){
fi
echo $MSG2 | tee $PROJECT_DIR/thirdparty/README || ERR=1
cp $GATB_CORE_PATH/THIRDPARTIES.md $PROJECT_DIR/thirdparty || ERR=1
mkdir $PROJECT_DIR/tests || ERR=1
echo $MSG3 | tee $PROJECT_DIR/tests/README || ERR=1
printf " done\n"
}

Expand Down
27 changes: 11 additions & 16 deletions gatb-core/scripts/NewProject/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
--------------------------------------------------------------------------------
# About XXX
#About XXX

This is a software tool relying on GATB-CORE library.

Expand All @@ -9,13 +8,15 @@ The architecture of the tool is as follows:
* a 'tools' directory holding a default source code using GATB-Core
* a 'scripts' directory holding a script to automatically package the tool
* a 'thirdparty' directory holding the gatb-core resources
* a 'doc' tool
* a 'doc' directory
* a 'tests' directory holding test procedures

The 'thirdparty' directory is only available for tool created outside the GATB-Tools repository.
Tools located within GATB-Tools rely on a common GATB-Core sub-module already available in this repository.

It is advised to use:

* 'tests' directory to hold test procedures: scripts and/or small sized data files
* 'scripts' directory to hold any scripts this tool relies on
* 'doc' directory to hold tool's documentation
* 'thirdparty' directory to hold any third-party librairies this tool relies on
Expand All @@ -29,20 +30,17 @@ each feature. Using this organisation has a big advantage: the provided CMakeLis
that, so you do not have to edit the CMake file when you add a new "sub-tool". As a real example, you
can have a look at the DiscoSNP software.

--------------------------------------------------------------------------------
# License
#License

Please not that GATB-Core is distributed under Affero-GPL license.

--------------------------------------------------------------------------------
# Dependencies
#Dependencies

The following third parties should be already installed:

* cmake (mandatory)
* cmake 2.8+ (mandatory)

--------------------------------------------------------------------------------
# Project build
#Project build

For building your project, you should do the following

Expand All @@ -53,8 +51,7 @@ Then, you should get a binary holding the name of the project within 'build/tool

Note: the first compilation should take some time since the GATB-CORE library is generated.

--------------------------------------------------------------------------------
# Project packaging
#Project packaging

You can prepare your tool for distribution using:

Expand All @@ -67,8 +64,7 @@ and the other the source codes.

Note: the script re-builds the entire tool from its sources to ensure a clean build process.

--------------------------------------------------------------------------------
# Examples
#Examples

The project is created with a default 'main' function that dumps some information about the library.

Expand All @@ -85,8 +81,7 @@ For instance:

WARNING: some examples use on purpose lambda expressions, so you will need a compiler supporting this feature for this examples.

--------------------------------------------------------------------------------
# Binaries from gatb-core
#Binaries from gatb-core

After the project build, some gatb-core binaries are available here: 'ext/gatb-core/bin'

Expand Down

0 comments on commit 7f0b9a4

Please sign in to comment.