2019-03-28 21:22:48 +08:00
.PHONY : pretty clean ChangeLog .md release
2017-08-14 20:41:01 +08:00
2019-03-28 21:22:48 +08:00
##########################################################################
# configuration
##########################################################################
2018-01-29 18:21:11 +08:00
2019-01-13 22:31:22 +08:00
# directory to recent compiler binaries
COMPILER_DIR = /Users/niels/Documents/projects/compilers/local/bin
2019-03-28 21:22:48 +08:00
# find GNU sed to use `-i` parameter
SED := $( shell command -v gsed || which sed)
##########################################################################
# source files
##########################################################################
# the list of sources in the include folder
SRCS = $( shell find include -type f | sort)
# the single header (amalgamated from the source files)
AMALGAMATED_FILE = single_include/nlohmann/json.hpp
##########################################################################
# documentation of the Makefile's targets
##########################################################################
2017-08-14 20:41:01 +08:00
# main target
2016-11-27 23:19:26 +08:00
all :
2018-01-29 18:21:11 +08:00
@echo "amalgamate - amalgamate file single_include/nlohmann/json.hpp from the include/nlohmann sources"
2017-10-05 01:27:35 +08:00
@echo "ChangeLog.md - generate ChangeLog file"
@echo "check - compile and execute test suite"
2018-01-14 20:08:28 +08:00
@echo "check-amalgamation - check whether sources have been amalgamated"
2017-10-05 01:27:35 +08:00
@echo "check-fast - compile and execute test suite (skip long-running tests)"
@echo "clean - remove built files"
2017-10-05 06:17:09 +08:00
@echo "coverage - create coverage information with lcov"
2019-04-06 15:02:17 +08:00
@echo "coverage-fast - create coverage information with fastcov"
2017-10-05 01:27:35 +08:00
@echo "cppcheck - analyze code with cppcheck"
2019-03-17 07:30:08 +08:00
@echo "cpplint - analyze code with cpplint"
@echo "clang_tidy - analyze code with Clang-Tidy"
@echo "clang_analyze - analyze code with Clang-Analyzer"
2017-10-05 01:27:35 +08:00
@echo "doctest - compile example files and check their output"
@echo "fuzz_testing - prepare fuzz testing of the JSON parser"
2018-10-24 21:43:37 +08:00
@echo "fuzz_testing_bson - prepare fuzz testing of the BSON parser"
2017-10-05 01:27:35 +08:00
@echo "fuzz_testing_cbor - prepare fuzz testing of the CBOR parser"
@echo "fuzz_testing_msgpack - prepare fuzz testing of the MessagePack parser"
2018-01-28 01:38:11 +08:00
@echo "fuzz_testing_ubjson - prepare fuzz testing of the UBJSON parser"
2017-10-05 01:27:35 +08:00
@echo "json_unit - create single-file test executable"
@echo "pedantic_clang - run Clang with maximal warning flags"
@echo "pedantic_gcc - run GCC with maximal warning flags"
@echo "pretty - beautify code with Artistic Style"
2018-02-10 21:46:39 +08:00
@echo "run_benchmarks - build and run benchmarks"
2015-02-14 05:12:27 +08:00
2019-03-28 21:22:48 +08:00
2015-06-22 03:24:03 +08:00
##########################################################################
# unit tests
##########################################################################
2016-08-04 13:24:46 +08:00
# build unit tests
json_unit :
2016-11-27 23:19:26 +08:00
@$( MAKE) json_unit -C test
2015-06-22 03:24:03 +08:00
2016-08-04 13:24:46 +08:00
# run unit tests
2016-11-27 23:19:26 +08:00
check :
$( MAKE) check -C test
2015-02-14 05:12:27 +08:00
2019-03-28 21:22:48 +08:00
# run unit tests and skip expensive tests
2016-11-27 23:19:26 +08:00
check-fast :
$( MAKE) check -C test TEST_PATTERN = ""
2016-08-05 04:05:16 +08:00
2015-06-21 18:45:46 +08:00
2017-10-05 06:17:09 +08:00
##########################################################################
# coverage
##########################################################################
coverage :
2019-03-28 21:22:48 +08:00
rm -fr build_coverage
2017-10-05 06:17:09 +08:00
mkdir build_coverage
2019-04-03 23:28:47 +08:00
cd build_coverage ; CXX = g++-8 cmake .. -GNinja -DJSON_Coverage= ON -DJSON_MultipleHeaders= ON
2017-10-05 06:17:09 +08:00
cd build_coverage ; ninja
2018-03-21 01:49:10 +08:00
cd build_coverage ; ctest -E '.*_default' -j10
2017-10-05 06:17:09 +08:00
cd build_coverage ; ninja lcov_html
open build_coverage/test/html/index.html
2019-04-06 15:02:17 +08:00
coverage-fast :
2019-03-30 16:12:32 +08:00
rm -fr build_coverage
mkdir build_coverage
2019-07-29 00:40:11 +08:00
cd build_coverage ; CXX = g++-9 cmake .. -GNinja -DJSON_Coverage= ON -DJSON_MultipleHeaders= ON
2019-03-30 16:12:32 +08:00
cd build_coverage ; ninja
cd build_coverage ; ctest -E '.*_default' -j10
2019-04-06 15:02:17 +08:00
cd build_coverage ; ninja fastcov_html
2019-03-30 16:12:32 +08:00
open build_coverage/test/html/index.html
2017-10-05 06:17:09 +08:00
2016-02-14 23:42:48 +08:00
##########################################################################
# documentation tests
##########################################################################
# compile example files and check output
doctest :
2016-05-29 20:06:43 +08:00
$( MAKE) check_output -C doc
2017-02-23 01:14:29 +08:00
##########################################################################
# warning detector
##########################################################################
# calling Clang with all warnings, except:
2019-03-29 20:10:11 +08:00
# -Wno-c++2a-compat: u8 literals will behave differently in C++20...
# -Wno-deprecated-declarations: the library deprecated some functions
2017-02-23 01:14:29 +08:00
# -Wno-documentation-unknown-command: code uses user-defined commands like @complexity
2019-03-27 06:58:53 +08:00
# -Wno-exit-time-destructors: warning in json code triggered by NLOHMANN_JSON_SERIALIZE_ENUM
2019-03-29 20:10:11 +08:00
# -Wno-float-equal: not all comparisons in the tests can be replaced by Approx
2017-02-23 01:14:29 +08:00
# -Wno-keyword-macro: unit-tests use "#define private public"
2019-03-29 20:10:11 +08:00
# -Wno-padded: padding is nothing to warn about
2018-01-23 23:33:08 +08:00
# -Wno-range-loop-analysis: items tests "for(const auto i...)"
2017-10-05 01:27:35 +08:00
# -Wno-switch-enum -Wno-covered-switch-default: pedantic/contradicting warnings about switches
2019-03-29 20:10:11 +08:00
# -Wno-weak-vtables: exception class is defined inline, but has virtual method
2017-03-17 01:35:45 +08:00
pedantic_clang :
2019-07-28 20:30:17 +08:00
$( MAKE) json_unit CXX = c++ CXXFLAGS = " \
2017-06-21 05:05:37 +08:00
-std= c++11 -Wno-c++98-compat -Wno-c++98-compat-pedantic \
2017-02-23 01:14:29 +08:00
-Werror \
-Weverything \
2019-03-29 20:10:11 +08:00
-Wno-c++2a-compat \
-Wno-deprecated-declarations \
2017-02-23 01:14:29 +08:00
-Wno-documentation-unknown-command \
-Wno-exit-time-destructors \
2019-03-29 20:10:11 +08:00
-Wno-float-equal \
2017-02-23 01:14:29 +08:00
-Wno-keyword-macro \
2019-03-29 20:10:11 +08:00
-Wno-padded \
2017-04-03 00:46:21 +08:00
-Wno-range-loop-analysis \
2017-06-21 05:05:37 +08:00
-Wno-switch-enum -Wno-covered-switch-default \
2019-03-29 20:10:11 +08:00
-Wno-weak-vtables"
2017-02-23 01:14:29 +08:00
2017-03-17 01:35:45 +08:00
# calling GCC with most warnings
pedantic_gcc :
2019-07-28 20:30:17 +08:00
$( MAKE) json_unit CXX = /usr/local/bin/g++-9 CXXFLAGS = " \
2017-03-17 01:35:45 +08:00
-std= c++11 \
2019-03-17 07:30:08 +08:00
-Waddress \
-Waddress-of-packed-member \
-Waggressive-loop-optimizations \
-Waligned-new= all \
-Wall \
-Walloc-zero \
2017-03-17 01:35:45 +08:00
-Walloca \
2019-03-17 07:30:08 +08:00
-Warray-bounds \
2017-03-17 01:35:45 +08:00
-Warray-bounds= 2 \
2019-03-17 07:30:08 +08:00
-Wattribute-alias= 2 \
-Wattribute-warning \
-Wattributes \
-Wbool-compare \
-Wbool-operation \
-Wbuiltin-declaration-mismatch \
-Wbuiltin-macro-redefined \
-Wcannot-profile \
-Wcast-align \
-Wcast-function-type \
-Wcast-qual \
-Wcatch-value= 3 \
2017-03-17 01:35:45 +08:00
-Wchar-subscripts \
2019-03-17 07:30:08 +08:00
-Wclass-conversion \
-Wclass-memaccess \
-Wclobbered \
-Wcomment \
-Wcomments \
2017-03-17 01:35:45 +08:00
-Wconditionally-supported \
-Wconversion \
2019-03-17 07:30:08 +08:00
-Wconversion-null \
-Wcoverage-mismatch \
-Wcpp \
-Wctor-dtor-privacy \
-Wdangling-else \
2017-03-17 01:35:45 +08:00
-Wdate-time \
2019-03-17 07:30:08 +08:00
-Wdelete-incomplete \
-Wdelete-non-virtual-dtor \
2017-03-17 01:35:45 +08:00
-Wdeprecated \
2019-03-17 07:30:08 +08:00
-Wdeprecated-copy \
-Wdeprecated-copy-dtor \
-Wdeprecated-declarations \
2017-03-17 01:35:45 +08:00
-Wdisabled-optimization \
2019-03-17 07:30:08 +08:00
-Wdiv-by-zero \
2017-03-17 01:35:45 +08:00
-Wdouble-promotion \
-Wduplicated-branches \
-Wduplicated-cond \
2019-03-17 19:02:23 +08:00
-Weffc++ \
2019-03-17 07:30:08 +08:00
-Wempty-body \
-Wendif-labels \
-Wenum-compare \
2019-03-17 19:02:23 +08:00
-Wexpansion-to-defined \
2019-03-17 07:30:08 +08:00
-Werror \
-Wextra \
-Wextra-semi \
-Wfloat-conversion \
-Wformat \
-Wformat-contains-nul \
-Wformat-extra-args \
-Wformat-nonliteral \
2017-03-17 01:35:45 +08:00
-Wformat-overflow= 2 \
2019-03-17 07:30:08 +08:00
-Wformat-security \
2017-03-17 01:35:45 +08:00
-Wformat-signedness \
-Wformat-truncation= 2 \
2019-03-17 07:30:08 +08:00
-Wformat-y2k \
-Wformat-zero-length \
2017-03-17 01:35:45 +08:00
-Wformat= 2 \
2019-03-17 07:30:08 +08:00
-Wframe-address \
-Wfree-nonheap-object \
-Whsa \
-Wif-not-aligned \
-Wignored-attributes \
-Wignored-qualifiers \
2017-03-17 01:35:45 +08:00
-Wimplicit-fallthrough= 5 \
2019-03-17 07:30:08 +08:00
-Winherited-variadic-ctor \
-Winit-list-lifetime \
-Winit-self \
-Winline \
-Wint-in-bool-context \
-Wint-to-pointer-cast \
-Winvalid-memory-model \
-Winvalid-offsetof \
-Winvalid-pch \
-Wliteral-suffix \
-Wlogical-not-parentheses \
2017-03-17 01:35:45 +08:00
-Wlogical-op \
2019-03-17 07:30:08 +08:00
-Wlto-type-mismatch \
-Wmain \
-Wmaybe-uninitialized \
-Wmemset-elt-size \
-Wmemset-transposed-args \
-Wmisleading-indentation \
-Wmissing-attributes \
-Wmissing-braces \
2017-03-17 01:35:45 +08:00
-Wmissing-declarations \
2019-03-17 07:30:08 +08:00
-Wmissing-field-initializers \
2017-03-17 01:35:45 +08:00
-Wmissing-format-attribute \
-Wmissing-include-dirs \
2019-03-17 07:30:08 +08:00
-Wmissing-noreturn \
-Wmissing-profile \
-Wmultichar \
-Wmultiple-inheritance \
-Wmultistatement-macros \
-Wnarrowing \
-Wno-deprecated-declarations \
2019-04-03 23:44:09 +08:00
-Wno-float-equal \
2019-03-17 07:30:08 +08:00
-Wno-long-long \
-Wno-namespaces \
-Wno-padded \
-Wno-switch-enum \
-Wno-system-headers \
-Wno-templates \
-Wno-undef \
2017-03-17 01:35:45 +08:00
-Wnoexcept \
2019-03-17 07:30:08 +08:00
-Wnoexcept-type \
-Wnon-template-friend \
-Wnon-virtual-dtor \
2017-03-17 01:35:45 +08:00
-Wnonnull \
2019-03-17 07:30:08 +08:00
-Wnonnull-compare \
-Wnonportable-cfstrings \
-Wnormalized \
2017-03-17 01:35:45 +08:00
-Wnull-dereference \
2019-03-17 07:30:08 +08:00
-Wodr \
2017-03-17 01:35:45 +08:00
-Wold-style-cast \
2019-03-17 07:30:08 +08:00
-Wopenmp-simd \
-Woverflow \
-Woverlength-strings \
2017-03-17 01:35:45 +08:00
-Woverloaded-virtual \
2019-03-17 07:30:08 +08:00
-Wpacked \
-Wpacked-bitfield-compat \
-Wpacked-not-aligned \
2017-03-17 01:35:45 +08:00
-Wparentheses \
2019-03-17 07:30:08 +08:00
-Wpedantic \
-Wpessimizing-move \
2017-03-17 01:35:45 +08:00
-Wplacement-new= 2 \
2019-03-17 07:30:08 +08:00
-Wpmf-conversions \
-Wpointer-arith \
-Wpointer-compare \
-Wpragmas \
-Wprio-ctor-dtor \
-Wpsabi \
2017-03-17 01:35:45 +08:00
-Wredundant-decls \
2019-03-17 07:30:08 +08:00
-Wredundant-move \
-Wregister \
2017-03-17 01:35:45 +08:00
-Wreorder \
-Wrestrict \
2019-03-17 07:30:08 +08:00
-Wreturn-local-addr \
-Wreturn-type \
-Wscalar-storage-order \
-Wsequence-point \
-Wshadow \
-Wshadow-compatible-local \
-Wshadow-local \
-Wshadow= compatible-local \
2017-03-17 01:35:45 +08:00
-Wshadow= global \
2019-03-17 07:30:08 +08:00
-Wshadow= local \
-Wshift-count-negative \
-Wshift-count-overflow \
-Wshift-negative-value \
2017-03-17 01:35:45 +08:00
-Wshift-overflow= 2 \
2019-03-17 07:30:08 +08:00
-Wsign-compare \
2017-03-17 01:35:45 +08:00
-Wsign-conversion \
-Wsign-promo \
-Wsized-deallocation \
2019-03-17 07:30:08 +08:00
-Wsizeof-array-argument \
-Wsizeof-pointer-div \
-Wsizeof-pointer-memaccess \
-Wstack-protector \
-Wstrict-aliasing= 3 \
-Wstrict-null-sentinel \
2017-03-17 01:35:45 +08:00
-Wstrict-overflow= 5 \
2019-03-17 07:30:08 +08:00
-Wstringop-overflow= 4 \
-Wstringop-truncation \
-Wsubobject-linkage \
-Wsuggest-attribute= cold \
2017-03-17 01:35:45 +08:00
-Wsuggest-attribute= const \
-Wsuggest-attribute= format \
2019-03-17 07:30:08 +08:00
-Wsuggest-attribute= malloc \
2017-03-17 01:35:45 +08:00
-Wsuggest-attribute= noreturn \
-Wsuggest-attribute= pure \
-Wsuggest-final-methods \
-Wsuggest-final-types \
-Wsuggest-override \
2019-03-17 07:30:08 +08:00
-Wswitch \
-Wswitch-bool \
2019-03-17 19:02:23 +08:00
-Wswitch-default \
2019-03-17 07:30:08 +08:00
-Wswitch-unreachable \
-Wsync-nand \
-Wsynth \
-Wtautological-compare \
-Wterminate \
-Wtrampolines \
2017-03-17 01:35:45 +08:00
-Wtrigraphs \
2019-03-17 07:30:08 +08:00
-Wtype-limits \
-Wuninitialized \
-Wunknown-pragmas \
-Wunreachable-code \
-Wunsafe-loop-optimizations \
2017-03-17 01:35:45 +08:00
-Wunused \
2019-03-17 07:30:08 +08:00
-Wunused-but-set-parameter \
-Wunused-but-set-variable \
2017-03-17 01:35:45 +08:00
-Wunused-const-variable= 2 \
2019-03-17 07:30:08 +08:00
-Wunused-function \
-Wunused-label \
-Wunused-local-typedefs \
2017-03-17 01:35:45 +08:00
-Wunused-macros \
-Wunused-parameter \
2019-03-17 07:30:08 +08:00
-Wunused-result \
-Wunused-value \
-Wunused-variable \
2017-03-17 01:35:45 +08:00
-Wuseless-cast \
2019-03-17 07:30:08 +08:00
-Wvarargs \
2018-09-06 13:25:19 +08:00
-Wvariadic-macros \
2019-03-17 07:30:08 +08:00
-Wvector-operation-performance \
-Wvirtual-inheritance \
-Wvirtual-move-assign \
-Wvla \
-Wvolatile-register-var \
-Wwrite-strings \
-Wzero-as-null-pointer-constant \
"
2017-02-23 01:14:29 +08:00
2018-02-10 21:46:39 +08:00
##########################################################################
# benchmarks
##########################################################################
run_benchmarks :
2019-03-28 21:22:48 +08:00
rm -fr build_benchmarks
2018-02-10 21:46:39 +08:00
mkdir build_benchmarks
2019-03-28 21:22:48 +08:00
cd build_benchmarks ; cmake ../benchmarks -GNinja -DCMAKE_BUILD_TYPE= Release
cd build_benchmarks ; ninja
2018-02-10 21:46:39 +08:00
cd build_benchmarks ; ./json_benchmarks
2016-02-12 17:35:08 +08:00
##########################################################################
# fuzzing
##########################################################################
2016-02-15 01:38:29 +08:00
# the overall fuzz testing target
fuzz_testing :
rm -fr fuzz-testing
mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
2016-12-22 18:09:26 +08:00
$( MAKE) parse_afl_fuzzer -C test CXX = afl-clang++
2016-12-22 19:08:36 +08:00
mv test/parse_afl_fuzzer fuzz-testing/fuzzer
2016-05-11 08:25:54 +08:00
find test/data/json_tests -size -5k -name *json | xargs -I{ } cp "{}" fuzz-testing/testcases
2016-12-22 18:09:26 +08:00
@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
2016-02-15 01:38:29 +08:00
2018-10-24 21:43:37 +08:00
fuzz_testing_bson :
rm -fr fuzz-testing
mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
$( MAKE) parse_bson_fuzzer -C test CXX = afl-clang++
mv test/parse_bson_fuzzer fuzz-testing/fuzzer
find test/data -size -5k -name *.bson | xargs -I{ } cp "{}" fuzz-testing/testcases
@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
2016-12-22 19:08:36 +08:00
fuzz_testing_cbor :
rm -fr fuzz-testing
mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
$( MAKE) parse_cbor_fuzzer -C test CXX = afl-clang++
mv test/parse_cbor_fuzzer fuzz-testing/fuzzer
2016-12-25 23:07:10 +08:00
find test/data -size -5k -name *.cbor | xargs -I{ } cp "{}" fuzz-testing/testcases
2016-12-22 19:08:36 +08:00
@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
2016-12-25 23:18:56 +08:00
fuzz_testing_msgpack :
rm -fr fuzz-testing
mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
$( MAKE) parse_msgpack_fuzzer -C test CXX = afl-clang++
mv test/parse_msgpack_fuzzer fuzz-testing/fuzzer
find test/data -size -5k -name *.msgpack | xargs -I{ } cp "{}" fuzz-testing/testcases
@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
2018-01-28 01:38:11 +08:00
fuzz_testing_ubjson :
rm -fr fuzz-testing
mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
$( MAKE) parse_ubjson_fuzzer -C test CXX = afl-clang++
mv test/parse_ubjson_fuzzer fuzz-testing/fuzzer
find test/data -size -5k -name *.ubjson | xargs -I{ } cp "{}" fuzz-testing/testcases
@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
2016-12-25 23:36:43 +08:00
fuzzing-start :
afl-fuzz -S fuzzer1 -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer > /dev/null &
afl-fuzz -S fuzzer2 -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer > /dev/null &
afl-fuzz -S fuzzer3 -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer > /dev/null &
afl-fuzz -S fuzzer4 -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer > /dev/null &
afl-fuzz -S fuzzer5 -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer > /dev/null &
afl-fuzz -S fuzzer6 -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer > /dev/null &
afl-fuzz -S fuzzer7 -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer > /dev/null &
afl-fuzz -M fuzzer0 -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer
fuzzing-stop :
-killall fuzzer
-killall afl-fuzz
2016-02-12 17:35:08 +08:00
2019-03-28 21:22:48 +08:00
2015-06-22 03:24:03 +08:00
##########################################################################
2019-03-28 21:22:48 +08:00
# Static analysis
2015-06-22 03:24:03 +08:00
##########################################################################
2015-02-14 05:12:27 +08:00
2019-03-28 21:22:48 +08:00
# call cppcheck <http://cppcheck.sourceforge.net>
# Note: this target is called by Travis
2015-02-14 05:12:27 +08:00
cppcheck :
2019-07-30 00:49:21 +08:00
cppcheck --enable= warning --inline-suppr --inconclusive --force --std= c++11 $( AMALGAMATED_FILE) --error-exitcode= 1
2015-06-22 03:24:03 +08:00
2019-03-28 21:22:48 +08:00
# call Clang Static Analyzer <https://clang-analyzer.llvm.org>
2018-03-01 02:59:54 +08:00
clang_analyze :
rm -fr clang_analyze_build
mkdir clang_analyze_build
2019-01-13 22:31:22 +08:00
cd clang_analyze_build ; CCC_CXX = $( COMPILER_DIR) /clang++ CXX = $( COMPILER_DIR) /clang++ $( COMPILER_DIR) /scan-build cmake .. -GNinja
2019-03-28 21:22:48 +08:00
cd clang_analyze_build ; \
$( COMPILER_DIR) /scan-build \
-enable-checker alpha.core.BoolAssignment,alpha.core.CallAndMessageUnInitRefArg,alpha.core.CastSize,alpha.core.CastToStruct,alpha.core.Conversion,alpha.core.DynamicTypeChecker,alpha.core.FixedAddr,alpha.core.PointerArithm,alpha.core.PointerSub,alpha.core.SizeofPtr,alpha.core.StackAddressAsyncEscape,alpha.core.TestAfterDivZero,alpha.deadcode.UnreachableCode,core.builtin.BuiltinFunctions,core.builtin.NoReturnFunctions,core.CallAndMessage,core.DivideZero,core.DynamicTypePropagation,core.NonnilStringConstants,core.NonNullParamChecker,core.NullDereference,core.StackAddressEscape,core.UndefinedBinaryOperatorResult,core.uninitialized.ArraySubscript,core.uninitialized.Assign,core.uninitialized.Branch,core.uninitialized.CapturedBlockVariable,core.uninitialized.UndefReturn,core.VLASize,cplusplus.InnerPointer,cplusplus.Move,cplusplus.NewDelete,cplusplus.NewDeleteLeaks,cplusplus.SelfAssignment,deadcode.DeadStores,nullability.NullableDereferenced,nullability.NullablePassedToNonnull,nullability.NullableReturnedFromNonnull,nullability.NullPassedToNonnull,nullability.NullReturnedFromNonnull \
--use-c++= $( COMPILER_DIR) /clang++ -analyze-headers -o report ninja
open clang_analyze_build/report/*/index.html
# call cpplint <https://github.com/cpplint/cpplint>
# Note: some errors expected due to false positives
2019-03-17 07:30:08 +08:00
cpplint :
2019-03-28 21:22:48 +08:00
third_party/cpplint/cpplint.py \
--filter= -whitespace,-legal,-readability/alt_tokens,-runtime/references,-runtime/explicit \
--quiet --recursive $( SRCS)
2019-03-17 07:30:08 +08:00
2019-03-28 21:22:48 +08:00
# call Clang-Tidy <https://clang.llvm.org/extra/clang-tidy/>
2019-03-17 07:30:08 +08:00
clang_tidy :
2019-07-30 00:49:21 +08:00
$( COMPILER_DIR) /clang-tidy $( AMALGAMATED_FILE) -- -Iinclude -std= c++11
2019-03-17 07:30:08 +08:00
2019-03-28 21:22:48 +08:00
# call PVS-Studio Analyzer <https://www.viva64.com/en/pvs-studio/>
2019-03-17 07:30:08 +08:00
pvs_studio :
rm -fr pvs_studio_build
mkdir pvs_studio_build
cd pvs_studio_build ; cmake .. -DCMAKE_EXPORT_COMPILE_COMMANDS= On
cd pvs_studio_build ; pvs-studio-analyzer analyze -j 10
cd pvs_studio_build ; plog-converter -a'GA:1,2;64:1;CS' -t fullhtml PVS-Studio.log -o pvs
open pvs_studio_build/pvs/index.html
2019-03-28 21:22:48 +08:00
# call Infer <https://fbinfer.com> static analyzer
2019-03-18 07:19:28 +08:00
infer :
rm -fr infer_build
mkdir infer_build
cd infer_build ; infer compile -- cmake .. ; infer run -- make -j 4
2019-03-28 21:22:48 +08:00
# call OCLint <http://oclint.org> static analyzer
2019-03-18 07:19:28 +08:00
oclint :
oclint $( SRCS) -report-type html -enable-global-analysis -o oclint_report.html -max-priority-1= 10000 -max-priority-2= 10000 -max-priority-3= 10000 -- -std= c++11 -Iinclude
open oclint_report.html
2019-03-28 21:22:48 +08:00
# execute the test suite with Clang sanitizers (address and undefined behavior)
clang_sanitize :
rm -fr clang_sanitize_build
mkdir clang_sanitize_build
cd clang_sanitize_build ; CXX = $( COMPILER_DIR) /clang++ cmake .. -DJSON_Sanitizer= On -DJSON_MultipleHeaders= ON -GNinja
cd clang_sanitize_build ; ninja
cd clang_sanitize_build ; ctest -E '.*_default' -j10
2015-06-22 03:24:03 +08:00
##########################################################################
2019-03-28 21:22:48 +08:00
# Code format and source amalgamation
2015-06-22 03:24:03 +08:00
##########################################################################
2019-03-28 21:22:48 +08:00
# call the Artistic Style pretty printer on all source files
2015-02-14 05:12:27 +08:00
pretty :
2019-03-28 21:22:48 +08:00
astyle \
--style= allman \
--indent= spaces = 4 \
--indent-modifiers \
--indent-switches \
--indent-preproc-block \
--indent-preproc-define \
--indent-col1-comments \
--pad-oper \
--pad-header \
--align-pointer= type \
--align-reference= type \
--add-brackets \
--convert-tabs \
--close-templates \
--lineend= linux \
--preserve-date \
--suffix= none \
--formatted \
$( SRCS) $( AMALGAMATED_FILE) test/src/*.cpp benchmarks/src/benchmarks.cpp doc/examples/*.cpp
2016-01-27 05:59:57 +08:00
2018-01-10 06:15:06 +08:00
# create single header file
2018-01-29 18:21:11 +08:00
amalgamate : $( AMALGAMATED_FILE )
2018-01-10 06:15:06 +08:00
2019-03-28 21:22:48 +08:00
# call the amalgamation tool and pretty print
2018-01-29 18:21:11 +08:00
$(AMALGAMATED_FILE) : $( SRCS )
third_party/amalgamate/amalgamate.py -c third_party/amalgamate/config.json -s . --verbose= yes
2018-01-10 06:15:06 +08:00
$( MAKE) pretty
2019-03-28 21:22:48 +08:00
# check if file single_include/nlohmann/json.hpp has been amalgamated from the nlohmann sources
# Note: this target is called by Travis
2018-01-14 20:08:28 +08:00
check-amalgamation :
2018-01-29 18:21:11 +08:00
@mv $( AMALGAMATED_FILE) $( AMALGAMATED_FILE) ~
2018-01-14 17:10:23 +08:00
@$( MAKE) amalgamate
2018-01-29 18:21:11 +08:00
@diff $( AMALGAMATED_FILE) $( AMALGAMATED_FILE) ~ || ( echo "===================================================================\n Amalgamation required! Please read the contribution guidelines\n in file .github/CONTRIBUTING.md.\n===================================================================" ; mv $( AMALGAMATED_FILE) ~ $( AMALGAMATED_FILE) ; false )
@mv $( AMALGAMATED_FILE) ~ $( AMALGAMATED_FILE)
2018-01-14 17:10:23 +08:00
2019-03-28 21:22:48 +08:00
# check if every header in nlohmann includes sufficient headers to be compiled individually
2018-01-28 22:36:56 +08:00
check-single-includes :
2019-01-13 22:31:22 +08:00
@for x in $( SRCS) ; do \
echo " Checking self-sufficiency of $$ x... " ; \
2018-01-29 18:21:11 +08:00
echo " #include < $$ x>\nint main() {}\n " | sed 's|include/||' > single_include_test.cpp; \
$( CXX) $( CXXFLAGS) -Iinclude -std= c++11 single_include_test.cpp -o single_include_test; \
2019-01-13 22:31:22 +08:00
rm -f single_include_test.cpp single_include_test; \
2018-01-28 22:36:56 +08:00
done
2017-08-15 02:45:33 +08:00
2019-03-28 21:22:48 +08:00
2016-01-27 05:59:57 +08:00
##########################################################################
2019-03-28 21:22:48 +08:00
# CMake
2016-01-27 05:59:57 +08:00
##########################################################################
2019-03-28 21:22:48 +08:00
# grep "^option" CMakeLists.txt test/CMakeLists.txt | sed 's/(/ /' | awk '{print $2}' | xargs
# check if all flags of our CMake files work
check_cmake_flags_do :
$( CMAKE_BINARY) --version
for flag in '' JSON_BuildTests JSON_Install JSON_MultipleHeaders JSON_Sanitizer JSON_Valgrind JSON_NoExceptions JSON_Coverage; do \
rm -fr cmake_build; \
mkdir cmake_build; \
echo " $( CMAKE_BINARY) .. -D $$ flag=On " ; \
cd cmake_build ; \
CXX = g++-8 $( CMAKE_BINARY) .. -D$$ flag = On -DCMAKE_CXX_COMPILE_FEATURES= "cxx_std_11;cxx_range_for" -DCMAKE_CXX_FLAGS= "-std=gnu++11" ; \
test -f Makefile || exit 1 ; \
cd .. ; \
done ;
# call target `check_cmake_flags_do` twice: once for minimal required CMake version 3.1.0 and once for the installed version
check_cmake_flags :
wget https://github.com/Kitware/CMake/releases/download/v3.1.0/cmake-3.1.0-Darwin64.tar.gz
tar xfz cmake-3.1.0-Darwin64.tar.gz
CMAKE_BINARY = $( abspath cmake-3.1.0-Darwin64/CMake.app/Contents/bin/cmake) $( MAKE) check_cmake_flags_do
CMAKE_BINARY = $( shell which cmake) $( MAKE) check_cmake_flags_do
##########################################################################
# ChangeLog
##########################################################################
# Create a ChangeLog based on the git log using the GitHub Changelog Generator
# (<https://github.com/github-changelog-generator/github-changelog-generator>).
# variable to control the diffs between the last released version and the current repository state
2016-07-31 19:37:04 +08:00
NEXT_VERSION ?= "unreleased"
2016-01-27 05:59:57 +08:00
ChangeLog.md :
2016-07-31 19:37:04 +08:00
github_changelog_generator -o ChangeLog.md --simple-list --release-url https://github.com/nlohmann/json/releases/tag/%s --future-release $( NEXT_VERSION)
2019-03-28 21:22:48 +08:00
$( SED) -i 's|https://github.com/nlohmann/json/releases/tag/HEAD|https://github.com/nlohmann/json/tree/HEAD|' ChangeLog.md
$( SED) -i '2i All notable changes to this project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org/).' ChangeLog.md
2018-02-04 20:29:23 +08:00
##########################################################################
2019-03-28 21:22:48 +08:00
# Release files
2018-02-04 20:29:23 +08:00
##########################################################################
2019-07-28 23:55:01 +08:00
# Create the files for a release and add signatures and hashes. We use `-X` to make the resulting ZIP file
2019-03-28 21:22:48 +08:00
# reproducible, see <https://content.pivotal.io/blog/barriers-to-deterministic-reproducible-zip-files>.
2018-02-04 20:29:23 +08:00
release :
2019-03-28 21:22:48 +08:00
rm -fr release_files
2018-02-11 23:50:01 +08:00
mkdir release_files
2019-07-28 23:55:01 +08:00
zip -9 --recurse-paths -X include.zip $( SRCS)
2018-02-04 20:29:23 +08:00
gpg --armor --detach-sig include.zip
2018-02-11 23:50:01 +08:00
mv include.zip include.zip.asc release_files
2019-03-28 21:22:48 +08:00
gpg --armor --detach-sig $( AMALGAMATED_FILE)
cp $( AMALGAMATED_FILE) release_files
mv $( AMALGAMATED_FILE) .asc release_files
2018-02-11 23:50:01 +08:00
cd release_files ; shasum -a 256 json.hpp > hashes.txt
cd release_files ; shasum -a 256 include.zip >> hashes.txt
2019-03-28 21:22:48 +08:00
##########################################################################
# Maintenance
##########################################################################
# clean up
clean :
rm -fr json_unit json_benchmarks fuzz fuzz-testing *.dSYM test/*.dSYM oclint_report.html
rm -fr benchmarks/files/numbers/*.json
rm -fr cmake-3.1.0-Darwin64.tar.gz cmake-3.1.0-Darwin64
rm -fr build_coverage build_benchmarks fuzz-testing clang_analyze_build pvs_studio_build infer_build clang_sanitize_build cmake_build
$( MAKE) clean -Cdoc
$( MAKE) clean -Ctest
2019-07-02 04:24:39 +08:00
2019-07-02 04:37:30 +08:00
##########################################################################
# Thirdparty code
##########################################################################
2019-07-02 04:24:39 +08:00
update_hedley :
rm -f include/nlohmann/thirdparty/hedley/hedley.hpp include/nlohmann/thirdparty/hedley/hedley_undef.hpp
curl https://raw.githubusercontent.com/nemequ/hedley/master/hedley.h -o include/nlohmann/thirdparty/hedley/hedley.hpp
2019-07-02 04:37:30 +08:00
gsed -i 's/HEDLEY_/JSON_HEDLEY_/g' include/nlohmann/thirdparty/hedley/hedley.hpp
2019-07-02 04:29:21 +08:00
grep "[[:blank:]]*#[[:blank:]]*undef" include/nlohmann/thirdparty/hedley/hedley.hpp | grep -v "__" | sort | uniq | gsed 's/ //g' | gsed 's/undef/undef /g' > include/nlohmann/thirdparty/hedley/hedley_undef.hpp
2019-07-02 04:24:39 +08:00
$( MAKE) amalgamate