Skip to main content

C/C++ build tool

Project description

JMake is a python makefile program that’s written to be both efficient and easy to use. Unlike GNU make, the syntax for JMake is very simple and easy to approach, while still being powerful. No deep understanding of g++’s hundreds of flags is required.

Additionally, JMake is designed to prevent doing more work than necessary whenever possible. Rather than specifying every file you want to compile, you specify files and directories you DON’T want to compile, so adding a new file to your project is as easy as creating it. And when compiling, JMake checks the header files in each of your source files, recompiling every necessary source file when an included header changes, but leaving alone the files that the header can’t affect. Further, it keeps md5 records of source and header files within the project, so that it doesn’t recompile files if the modified date has changed but the contents haven’t.

JMake is also intelligently multi-threaded and will use threads for compilation to enable maximum efficiency based on the hardware of your machine.

One very big advantage imparted by JMake is the intelligent use of the “Unity Build” concept, in an implementation I call “chunked build.” With chunked builds, the project is divided into larger compilation units, created by joining multiple source files into a single file. This speeds up compilation considerably when doing full builds; however, where unity builds often fail is in iterative programming involving multiple sequential small changes to few files, in which case unity builds often end up building far more than is necessary.

To avoid this issue, JMake takes a sequential approach to building. When doing a full build, JMake uses the unity approach, combining small compilation units into larger ones to increase the build time. However, when doing incremental builds, JMake takes advantage of small builds to split these larger units back down into their base components. When a build only consists of a small number of files, JMake will discard the chunk those files are in if it exists, and compile them as individual files - then the next time any file in that chunk is compiled, only it will be compiled, rather than the entire chunk. The end result is a build that starts out with the unity approach, and gradually shifts back to a more traditional approach over time. (However, any time you need to build a sufficiently large number of files in a chunk, JMake will return to building the whole chunk - so when working with header files, or when changing many files at once, you may find that the build shifts back and forth between chunks and individual files to try and keep all builds to the minimum possible time.)

Finally, JMake combines “./configure” and “make” into one call, checking dependencies as part of its build process and alerting at the very start of the build if it can’t find a required library, rather than waiting until the linker is invoked to alert of this.

Project details


Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page