https://github.com/IFS-HSR/SConsolidator
An Eclipse plug-in for the build system SCons (scons.org).
https://github.com/IFS-HSR/SConsolidator
Last synced: 3 months ago
JSON representation
An Eclipse plug-in for the build system SCons (scons.org).
- Host: GitHub
- URL: https://github.com/IFS-HSR/SConsolidator
- Owner: IFS-HSR
- Created: 2014-03-04T16:00:09.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2021-02-25T16:52:11.000Z (about 4 years ago)
- Last Synced: 2024-03-26T10:47:34.716Z (about 1 year ago)
- Language: Java
- Size: 954 KB
- Stars: 24
- Watchers: 13
- Forks: 10
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.txt
Awesome Lists containing this project
- trackawesomelist - Sconsolidator (⭐24) - Scons build system integration for Eclipse CDT. (Recently Updated / [Feb 05, 2025](/content/2025/02/05/README.md))
README
SConsolidator - An Eclipse plug-in for SCons
============================================
[](https://travis-ci.org/IFS-HSR/SConsolidator)
### Install it from our Eclipse Update Site at http://www.sconsolidator.com/update
## Introduction
SCons is an open source software build tool which tries to fix the
numerous weaknesses of Make clones like the missing automatic
dependency extraction, the complex syntax to describe build
properties and the cross-platform issues when using shell scripts.
SCons is a self-contained tool which is not dependent on any existing
platform utilities. Because it is based on Python the user has the
full power of a modern scripting language to deal with all build
related issues.
For the acceptance of a build tool it is very important to have a
comfortable integration into an IDE. Before now there was no
satisfying support for SCons in Eclipse. SConsolidator - a term project
at the University of Applied Sciences in Rapperswil - addresses this
and provides tool integration for SCons in Eclipse for a convenient
C/C++ development experience.
## Features
- Convertion of existing CDT managed build projects to SCons projects
- Import of existing SCons projects into Eclipse with wizard support
- Interactive mode to quickly build single C/C++ source files speeding up round-trip times
- A special view for a convenient build target management of all workspace projects
- Graph visualization of build dependencies that helps in debugging SCons build problems
## Documentation
See this [getting started guide](http://sconsolidator.com/projects/sconsolidator/wiki/Getting_Started) for help on how to use SConsolidator with your C++ projects.
## Contribution help
### Minimum requirements to contribute
- Java 7
- Eclipse 3.7 (Indigo)
- SCons
- Maven v3 (because we use Tycho)
### Eclipse project setup
- Install Eclipse and SCons
- Import projects into Eclipse with the project wizard
- Open target file `ch.hsr.ifs.sconsolidator.core.target` and install dependencies
through "Set as Target Platform"
### Build
We use Tycho and Maven to build the project artifacts:
$ mvn compile
### Run tests
$ mvn integration-test
or if you prefer to run the tests in a X screen buffer, you can use the following script:
$ runtests.sh
### Project layout
#### ch.hsr.ifs.sconsolidator.core
SConsoldator's core functionality including all UI stuff, project wizards, builders,
Python files for collection build information from existing projects, etc.
#### ch.hsr.ifs.sconsolidator.core.tests
All Junit tests for SConsolidator's core functionality as well as the tests for
collecting build information from existing projects
#### ch.hsr.ifs.sconsolidator.feature
Eclipse feature project for SConsolidator's core plug-in
#### ch.hsr.ifs.sconsolidator.depviz
SConsolidators dependency visualization plug-in that shows the dependencies between
C++ build entities like source, object and library files; based on the Eclipse's
Visualization Toolkit Zest
#### ch.hsr.ifs.sconsolidator.depviz.feature
Eclipse feature project for SConsolidator's dependency visualization plug-in
#### ch.hsr.ifs.sconsolidator.help
Eclipse project for SConsolidator's Eclipse help system (Getting started guide,
welcome page, etc.)
#### ch.hsr.ifs.sconsolidator.swtbottests
Some UI tests based on SWTBot
#### ch.hsr.ifs.sconsolidator.updates
Eclipse Update site project