About
Bin-Build is a small shell script to simplify compiling source file in C, C++ and Objective-C.
You will find below a list of it's features.
You will find below a list of it's features.
Bin-Build is realeased under the BSD License. Feel free to use it, and modify it at your convenience.
Documentation
Table of contents
Overview
The purpose of this script is to provide a simplified compilation command.
When compiling a source file, the invocation of the compiler is often a painful task, especially when specific options need to be passed, like compiler flags, error level, etc.
When compiling a source file, the invocation of the compiler is often a painful task, especially when specific options need to be passed, like compiler flags, error level, etc.
For instance, in order to compile a C file with GCC, you need to type the following kind of command:
gcc -Wall -Werror -Wextra -pedantic -std=c89 -Os -o file file.c
It can be a lot worse if using specific options.
With Bin-Build, you can replace the previous command with:
With Bin-Build, you can replace the previous command with:
bin-build file.c
It will generate a 'file' executable, from the 'file.c' source file, using the C compiler.
You will see the following kind of output:
You will see the following kind of output:
/usr/local/bin/bin-build: compiling file file.cSettings: - Language: C - Compiler: /usr/bin/gcc - Input file: /Users/macmade/Desktop/test.c - Output file: /Users/macmade/Desktop/testCompiler options: - std=c99 - Os - pedantic - Werror - Wall - Wextra - Wbad-function-cast - Wdeclaration-after-statement - Werror-implicit-function-declaration - Wmissing-braces - Wmissing-declarations - Wmissing-field-initializers - Wmissing-prototypes - Wnested-externs - Wold-style-definition - Wparentheses - Wreturn-type - Wshadow - Wsign-compare - Wstrict-prototypes - Wswitch - Wuninitialized - Wunknown-pragmas - Wunused-function - Wunused-label - Wunused-parameter - Wunused-value - Wunused-variableCompiling file...Compilation successfullDo you want to execute the produced binary now? [y/N]--------------------------------------------------------------------------------Executing /Users/macmade/Desktop/test----------------------------------------------------------------------------------------------------------------------------------------------------------------Process exit code: 0--------------------------------------------------------------------------------
As you can see, once the compilation is complete, the script ask you if you want to execute the produced prgram, and gives you the program's exit code, once executed.
Language detection
Bin-Build can be used seamlessly with C, C++ and Objective-C.
The script automatically detects the programming language, based on the file extension:
The script automatically detects the programming language, based on the file extension:
C: .c
C++: .cpp
Objective-C: .m
Specific compiler settings will be used for each language.
Language settings
Settings can be configured for each language, trough environment variables:
C: $BIN_BUILD_C
C++: $BIN_BUILD_CPP
Objective-C: $BIN_BUILD_OBJC
Settings consist of the compiler arguments, separated by a ':' sign.
For instance:
For instance:
export BIN_BUILD_C=-Wall:-Werror:-O2bin-build file.c
Settings can be set for the session, as in the previous example, or globally, in your '.bash_rc' or '.profile' file.
Installation
Simply copy the script in a directory that's included in your executable path (like /usr/local/bin/), and make sure the executable flag is set.
For instance:
sudo cp bin-build.sh /usr/local/bin/bin-buildsudo chmod 755 /usr/local/bin/bin-build
You'll then be able to call the script as a normal executable:
svn-util ~/file.c
Default settings
Here are the default settings, used for each language.
C
- std=c99
- Os
- pedantic
- Werror
- Wall
- Wextra
- Wbad-function-cast
- Wdeclaration-after-statement
- Werror-implicit-function-declaration
- Wmissing-braces
- Wmissing-declarations
- Wmissing-field-initializers
- Wmissing-prototypes
- Wnested-externs
- Wold-style-definition
- Wparentheses
- Wreturn-type
- Wshadow
- Wsign-compare
- Wstrict-prototypes
- Wswitch
- Wuninitialized
- Wunknown-pragmas
- Wunused-function
- Wunused-label
- Wunused-parameter
- Wunused-value
- Wunused-variable
C++
- Os
- pedantic
- Werror
- Wall
- Wextra
- Wmissing-braces
- Wmissing-field-initializers
- Wmissing-prototypes
- Wparentheses
- Wreturn-type
- Wshadow
- Wsign-compare
- Wswitch
- Wuninitialized
- Wunknown-pragmas
- Wunused-function
- Wunused-label
- Wunused-parameter
- Wunused-value
- Wunused-variable
Objective-C
- framework Cocoa
- std=c99
- Os
- pedantic
- Werror
- Wall
- Wextra
- Wbad-function-cast
- Wdeclaration-after-statement
- Werror-implicit-function-declaration
- Wmissing-braces
- Wmissing-declarations
- Wmissing-field-initializers
- Wmissing-prototypes
- Wnested-externs
- Wold-style-definition
- Wparentheses
- Wreturn-type
- Wshadow
- Wsign-compare
- Wstrict-prototypes
- Wstrict-selector-match
- Wswitch
- Wundeclared-selector
- Wuninitialized
- Wunknown-pragmas
- Wunused-function
- Wunused-label
- Wunused-parameter
- Wunused-value
- Wunused-variable