{width="100px"}

catkin

Catkin is a collection of cmake macros and associated python code used to build some parts of ROS

Documentation

http://ros.org/doc/api/catkin/html/

Changelog for package catkin

0.7.16 (2019-03-12)

• protection against double -l in pkg-config files (#998)
• add error message to the setup.sh if devel space relocation is attempted (#997)

0.7.15 (2019-03-04)

• add local_setup files (#993)
• update docs to suggest \'test\' path instead of \'tests\'. (#990)
• generate CTest and dart config to avoid warnings (#987)
• fix PYTHONPATH missing in cached environment (#986)
• add double quotes around cmake_command to handle spaces (#976)
• strip \"-l\" from \"-lpthread\" library, to fix a build failure on ros-ros-comm (#975)
• correct Python executable in CMake files (#977)
• need to sanitize paths before cprint (#969)
• add friendly error message for ros/catkin#961 (#964)
• document how to install python subpackages (#962)
• add existing catkin logo to README (#959)
• fix warnings in docs
• install environment hooks into a package-specific directory (#953)
• fix race condition with catkin_tools in parallel builds (#955)
• use CATKIN_GLOBAL_ETC_DESTINATION instead of etc (#954)
• remove CMAKE_MODULE_PATH from list of \"forbidden\" variables (#951)
• Windows related:
  • add win_ros script wrappers to make Python scripts executable (#978)
  • fix python_distutils_install.bat.in (#992)
  • add script.bat.in template for general use (#981)
  • normalize paths in CMAKE_PREFIX_PATH for proper comparison (#979)
  • update windows.cmake to fix common build issues on Windows (#984)
  • update builder.py to add Windows support (#982)
  • ensure desired Python path is added into PATH in setup.bat (#983)
  • check both IMPORTED_IMPLIB_ and IMPORTED_LOCATION_ in catkin_libraries.cmake (#980)
  • enable catkin build use_nmake on Windows (#949)

0.7.14 (2018-06-06)

• terminal_color is now in catkin_pkg, regression from 0.7.13 (#943)
• fix permission of CMake file (#942)

0.7.13 (2018-05-31)

• add separate option CATKIN_INSTALL_INTO_PREFIX_ROOT (#940)
• find the Python version specified in ROS_PYTHON_VERSION (#939)
• move catkin_prepare_release script as well as dependencies to catkin_pkg (#941)

0.7.12 (2018-05-01)

• add CMake option for symlink install (#929)
• use verbatim on test target to fix testing with Ninja (#935)
• do not add_library() gmock and gtest if targets already exist (#927)
• modernize Python 2 code to get ready for Python 3 (#928)
• remove Python 3.3 specific code because it is end of life (#924)
• fix an error in the comment. (#930)
• fix typos (#934)

0.7.11 (2018-02-02)

• catkin_add_gtest: drop explicit add_dependencies(), rely on CMake. (#917)
• prevent reading non-whitelisted properties of interface targets (#916)
• fix logic when only gtest is present (#919)
• add option to pass specific version to catkin_prepare_release (#918)

0.7.10 (2018-01-24)

• support for googletest 1.8 and deduplicated code (#914)

0.7.9 (2018-01-22)

• add support for GMock (#897)
• provide default values to unbound variables in setup.sh.in (#907)
• cleanup environment changes reliably (#906)
• call the find PythonInterp with version in the arguments (#898)
• fix python3 support for builder.py (#903)
• fix Unicode write error (#902)

0.7.8 (2017-10-27)

• handle EOF on raw_input (#888)
• dynamically check gtest library type (#885)
• remove executable flag since file is not a script (#882)

0.7.7 (2017-07-27)

• fix warning in case devel space is nested in the build space (#880)
• remove workaround using -l:<libpath> necessary for older pkg-config versions (#879)
• replace exec call with runpy.run_path (#873)
• use environment variable to extend environment in plain shell (#862)
• prefer reporting problems to bugtracker / website before maintainer (#861)

0.7.6 (2017-02-17)

• skip gtest install rules for newer gtest versions (#857)

0.7.5 (2017-02-14)

• update --pkg help for catkin_make_isolated (#853)
• add skipped / disabled tests to catkin_test_results summary (#848)
• use functions instead of macros where possible to avoid leaking variables (#835)
• write output of parsing package xml as UTF-8 for Python 3 (#828)
• update documentation

0.7.4 (2016-09-25)

• fix regression in logic to select make / ninja for CMake packages from 0.7.2 (#826)

0.7.3 (2016-09-19)

• relax fixed DEPENDS check from last release (#825)

0.7.2 (2016-09-02)

• change warning to status when nosetests was not found (#823)
• maintain file context when invoking Python scripts through relay (#820)
• fix rollback logic for more than one value per environment variable and workspace (#819)
• add option to use NMake instead of Make (#816)
• fix check if DEPENDS was found (#813)
• fix quoting of paths to handle spaces (#808)
• update doc of catkin_package to clarify importance of case for variable names
• improve doc about catkin_package(CFG_EXTRAS) (#805)
• doc: fix format 2 howto to suggest to declare a build export dependency on \"message_runtime\"

0.7.1 (2016-03-18)

• expose format 2 style dependencies as CMake variables (#787)

0.7.0 (2016-03-04)

• remove CPATH from setup files (#783)
• use NO_MODULE to find exported catkin dependencies (#760)

0.6.17 (2016-03-03)

• fix docs: nosetest target names use periods (#781)
• add custom message explaining CMake find_package error messages (#780)
• fix regression with DESTDIR introduced in 0.6.16 (#755)
• avoid adding nonexistent paths to environment variables (#777)
• ensure that Python install destination exists (#775, https://github.com/ros/catkin/issues/776)
• set commonly predefines attributes when interrogating setup.py files (#770)
• align Python script directory recommendations with REP-0008 (#769)
• fix default value for _workspaces in find_in_workspaces (#768)
• improve robustness of exec call interogating setup.py files (#766 <https://github.com/ros/catkin/issues/766\>)
• fix reinstalling Python files installed by catkin_install_python after modifying them (#764)
• fix project specific clean_test_results targets (#762)
• update generated CMake API

0.6.16 (2015-11-09)

• remove -x in Python distutils shell script (#755)

0.6.15 (2015-09-19)

• adding check to prevent tool cross talk (#743)
• only clean the test result ending with .xml of the current project (#737)
• fix regression in find_in_workspaces (#739)
• fix setup.py package_dir location logic (#751)

0.6.14 (2015-04-20)

• support zsh with NOCLOBBER enabled (#734)

0.6.13 (2015-04-17)

• allow setting CATKIN_GLOBAL_LIBEXEC_DESTINATION to libexec (#713)

0.6.12 (2015-04-16)

• remove CATKIN_TEST_RESULTS_DIR environment variable (#728)
• catkin_test_results will output skipped xml files only when --all is being passed (#733)
• extract catkin_add_executable_with_gtest() from catkin_add_gtest() (#726)
• separate download function from tests (#633)
• only install environment hooks for catkin_make(_isolated) completion in the catkin package (#732)
• avoid warning with CMake 3.1 and newer (#731)
• quote command in \"Reproduce this error\" instructions (#730)
• fix Python error when working with non-ascii characters in catkin workspace path (#724)
• use \$TMPDIR for temporary _setup_util.py file if set (#710)
• fix regex for library config types (#723)
• fix potential race condition in download_checkmd5.py (#715)
• output package whitelist / blacklist if set (#714)
• add --verbose option to catkin_test_results to show the content of result files (#705)
• source in reset zsh emulation mode (#686)
• improve help text for --only-pkg-with-deps (#706)

0.6.11 (2014-12-29)

• fix return code for tests run by ctest (#703)

0.6.10 (2014-12-22)

• check changes to -D args CATKIN_DEVEL_PREFIX / CMAKE_INSTALL_PREFIX when considering to reinvoke cmake (#700)
• add --use-ninja option to catkin_make(_isolated) to use ninja instead of make (#693)
• remove \'emulate sh\' from setup.zsh (#686)
• set terminal title only when isatty (#687)
• add description to catkin_make for ignoring packages
• add suggestion to use catkin_make_isolated for non-homogeneous workspaces
• refactor code from run_tests.py into Python module (#678)

0.6.9 (2014-07-11)

• fix regression from 0.6.8 (#676)

0.6.8 (2014-07-10)

• make nosetests --xunit-file argument an absolute path to work around nose bug 779 (#659)
• fix handling of CMake packages which do not install any files (#665)
• fix gtest on Arch Linux and others (#663)
• improve generation of .catkin marker file (#671, #676)
• escape messages to avoid CMake warning (#667)
• fix CMake warning for doxygen target with CMake 3 (#660)
• avoid using ARGN for efficiency (#669)

0.6.7 (2014-06-16)

• reset CATKIN_SHELL in devel space generated env.sh files (#652, #655)
• ignore cd path echo when using CDPATH (#654)
• use PYTHON_EXECUTABLE for _setup_util.py (#646)
• expose PYTHON_EXECUTABLE to environment hook .em templates (#645)
• catkin_prepare_release:
  • add --no-push to catkin_prepare_release (#657)
  • flush stdin before asking for input (#658)

0.6.6 (2014-06-02)

• fix rollback of environment when workspace has been deleted (#641)
• fix argument handling when cm / cmi is invoked in a symlinked folder (#638)

0.6.5 (2014-05-25)

• fix regression in catkin_make_isolated from 0.6.4 (#624)
• fix problem when catkin_make / catkin_make_isolated is invoked in a symlinked folder (#638)

0.6.4 (2014-05-07)

• add architecture independent flag in package.xml (#625)
• add error message for circular dependencies in catkin_make_isolated and catkin_topological_order (#607, #608)
• add multiarch support for catkin environment files (#545)
• add workspace marker file for catkin_make / catkin_make_isolated (#304)
• allow better performance for repeated invocations of find_in_workspaces()
• consider test_depends for topolocial order (#612)
• invoke empy with specific Python interpreter (#620)
• support setting \${PROJECT_NAME}_LIBRARIES before invoking catkin_package() (#609)
• update package manifest to format 2 (#619)
• fixes:
  • fix catkin_find to not return path with \'/.\' suffix (#621)
  • fix python path setting for plain cmake workspaces (#618)
  • improve unicode handling (#615)
  • replace CMake usage of IMPORTED_IMPLIB with IMPORTED_LOCATION (#616)
  • do not call chpwd hooks in setup.zsh (#613)
  • set catkin* variables only when find_package(catkin COMPONENTS ...) (#629)

0.6.3 (2014-03-04)

• allow passing absolute INCLUDE_DIRS via catkin_package() into CMake config file in install space (#600, #601)
• improve error messages for wrong include dirs

0.6.2 (2014-02-24)

• use underlay workspaces when calculating topological order (#590)
• remove restriction to run unit test single threaded (#597)
• support using nosetests with Python3 (#593)
• remove invalid symbolic links of workspace level CMakeLists.txt file (#591)
• remove debug_message usage from generated pkgConfig.cmake files (#583)
• use catkin_install_python() to install Python scripts (#596)
• fix unicode error with japanese LANG (#578)
• fix gtest include dir when using gtest inside the workspace (#585)

0.6.1 (2014-01-29)

• remove more obsolete files (#582)

0.6.0 (2014-01-29)

• remove deprecated functionality (#582)
• remove eigen CMake config files (#492)
• fix EXPORTED_TARGETS argument for catkin_package() (#581)

0.5.80 (2014-01-27)

• fix library deduplication (#565)

0.5.79 (2014-01-09)

• fix handling of not found imported libraries (#565)

0.5.78 (2014-01-07)

• add support for py_modules in setup.py (#399)
• fix order and deduplication of of catkin_LIBRARIES (#558)
• update handling of library deduplication to support build configuration keywords in the whole process (#565)
• Python 3 related:
  • python 3 compatibility (#544)
  • add option to specify Python version (#570)
  • add catkin_install_python function (#573)
• catkin_make and catkin_make_isolated:
  • add --only-pkg-with-deps option
  • fix completion for -DCMAKE_BUILD_TYPE and -DCATKIN_ENABLE_TESTING
• catkin_make_isolated:
  • add empty line between packages for better readability
  • update command line doc (#534)
  • fix generated setup.sh for plain cmake package when path contains spaces
  • fix to actually build run_depends before the things that depend on them
  • fix check if environment exists with DESTDIR
• update setup scripts to use builtin cd command (#542)
• improve docs on system library dependencies (#552)
• install scripts under bin via setup.py (#555)
• update download script to resume downloads when server supports it (#559)
• add error handling when _setup_util.py fails, e.g. due to disk full (#561)
• add atomic_configure_file to work support parallel builds better (#566)
• update catkin_test_results usage message to mention return code (#576)
• prefix invocation of python script with PYTHON_EXECUTABLE (ros/genpy#23)
• update toplevel.cmake to use catkin_find_pkg instead of trying a fixed location to find catkin in the workspace
• modify gtest message level to only warn if gtest is not available but a package trys to register a gtest
• update run_tests to work robustly in parallel
• use sys.exit and not just exit
• catkin_prepare_release: undo quoting of commit messages

0.5.77 (2013-10-09)

• catkin_prepare_release: show tag name explicitly when using tag prefix (#528)
• catkin_make_isolated:
  • separate devel and install build folders for plain cmake packages cleanly without polluting namespace (#532)
  • fix build folder naming (regression from 0.5.75)
  • fix setup generation if last package in workspace is plain cmake (#530)
  • fix creating missing folder

0.5.76 (2013-10-06)

• fix regression in catkin_make from 0.5.75

0.5.75 (2013-10-04)

• add --all option to catkin_test_results
• improve svn support in catkin_prepare_release
• keep build folder of plain CMake packages completely isolated between devel and install (#374)
• fix handling of spaces in path (#519)
• fix generated setup.bash|zsh for isolated devel space (#520)
• fix env.sh for plain cmake packages to not define _CATKIN_SETUP_DIR (#521)
• fix crash when DESTDIR is specified but install not asked for (#526)
• update doc for downloading test data from download.ros.org
• update environment hook doc (#516)

0.5.74 (2013-09-18)

• support multiple package names for catkin_make --pkg (#504)
• improve help message on catkin_make_isolated --from-pkg
• fix include path in generated .pc files to be absolute (#506, regression of 0.5.72)
• fix handling DESTDIR in catkin_make_isolated for plain cmake packages (#499)
• fix catkin_python_setup to consider actual package names inside setup.py when signaling that an __init__.py file is installed to genmsg/dynamic_reconfigure (ros/genmsg#34)
• fix unsetting temporary variables - especially CATKIN_SETUP_DIR - to not influence next environment (#505)

0.5.73 (2013-08-23)

• fix include dirs in generated CMake config file when a non-catkin package depends on a catkin package (regression of #490)

0.5.72 (2013-08-21)

• make catkin packages relocatable (#490)
• catkin_prepare_release:
  • add tagging changelog sections (#489)
  • add warning when trying to release non-catkin packages (#478)
  • add --tag-prefix option (#447)
• catkin_make_isolated:
  • support installation with DESTDIR (#490)
  • handle missing install target gracefully
  • fix message with command to reproduce (#496)
• fix completion for catkin_make(_isolated) for older bash completion (#485)
• fix Python3.2 compatibility (#487)
• update documentation (#438, #467, #495, #497)

0.5.71 (2013-07-20)

• catkin_make_isolated: show progress in terminal title bar on Linux and Darwin (#482)
• catkin_prepare_release: add warning if package names contain upper case characters (#473)
• catkin_make: fix handling of non-ascii characters (#476)
• fix dry tests by disabling CTest for dry packages (#483)
• update documentation (#474)

0.5.70 (2013-07-14)

• add warning if versioned dependencies are not fulfilled (#472)
• catkin_prepare_release:
  • add checks for local changes in the working copy (#471)
  • remove \'--push\' option in favor of interactive questions
  • improve error message when branch is not tracked (#463)
  • colorize output for improved readability
• catkin_make_isolated:
  • suppress traceback when a package fails to build (#470)
  • improve output to include \'cd\' command to reproduce a failing command more easily
• fix initialization issue with CATKIN_ENABLE_TESTING variable (#464)
• find nosetest under different name on QNX (#461)
• update documentation (#438, #465, #468)

0.5.69 (2013-07-05)

• disable CTest on the farm since it breaks the binarydeb build with the current Debian rules files (#460)
• skip generating CATKIN_IGNORE marker file when build space equals source space (#459)
• fix warning message if gtest is not found (#458)

0.5.68 (2013-07-03)

• add option CATKIN_ENABLE_TESTING to configure without tests
• add CTest support for all registered test types: gtest, nosetest, rostest
• add the --from-pkg option to catkin_make_isolated
• catkin_prepare_release:
  • fix if git repo has multiple remotes (#450)
  • modify to not change the remote repo by default, add option --push for old behavior (#451)
• add \'prefix\' to generated pkg-config files (#444)
• add dummy target to catkin_EXPORTED_TARGETS if empty (#453)
• expose SETUPTOOLS_DEB_LAYOUT as option again (#418)
• suppress stacktrace when topologic_order raises within generating CMake files (#442)
• fixes:
  • update check in generated pkgConfig.cmake files to work independent of cmake policy CMD0012 (#452)
  • fix generating pkg-config files with empty -I directives (#445)
• update documentation, especially about testing
• for a complete list of changes see the commit log for 0.5.68

0.5.67 (2013-06-18)

• fix --build and --directory auto completion for catkin_make(_isolated) (#325)
• fix catkin_make(_isolated) auto completion on older versions of bash on OS X (#325)
• add how-to documentation
• for a complete list of changes see the commit log for 0.5.67

0.5.66 (2013-06-06)

• add new CMake function catkin_download_test_data, mark download_test_data as deprecated (#426, #431)
• catkin_make and catkin_make_isolated:
  • add bash autocompletion (#325)
  • allow passing MAKEFLAGS (#402)
• catkin_make_isolated:
  • allow building empty workspace (#423, #425)
  • add --catkin-make-args which enables calling \'catkin_make_isolated run_tests\' (#414)
• catkin_prepare_release:
  • execute the commands rather than printing them (#417)
  • warn about missing changelog files
  • validate metapackages (#404)
• auto detect former SETUPTOOLS_DEB_LAYOUT (#418)
• fixes:
  • fix error using sys.stdout.encoding without checking existance
  • remove linker flag -lrt for Android (#430)
  • fix resetting IFS shell variable when it was unset before (#427)
  • ensure to only return unique source paths from a workspace marker file (#424)
  • catkin_make_isolated:
    • fix chaining of plain cmake packages (#422)
    • fix --install error for non-catkin packages (#411)
    • only try to remove Makefile if it exists (#420, regression from 0.5.64)
    • fix detection of python paths for plain cmake packages
• update documentation:
  • update API doc of several CMake functions and macros
  • add generated CMake API to appear in the wiki (#384)
• add and install LICENSE file (#398)
• for a complete list of changes see the commit log for 0.5.66

0.5.65 (2013-03-21)

• remove including workspace.cmake if it exists, use -C and/or -DCMAKE_USER_MAKE_RULES_OVERRIDE instead (#377)
• change catkin_test_results return code based on failing tests (#392)
• apply CATKIN_BUILD_BINARY_PACKAGE for catkin (#395)
• modify extra file handling to make the generated code relocatable (#369)
• various improvements and fixes for Windows (#388, #390, #391, #393, ros-infrastructure/catkin_pkg#35)
• fixes:
  • fix --force-cmake for catkin_make_isolation (regression from 0.5.64)
  • fix catkin_package_version and catkin_prepare_release when no packages are found (#387)
  • fix catkin_prepare_release bumping wrong part of the version (#386)
  • handle dependencies that are imported libraries (#378)
• for a complete list of changes see the commit log for 0.5.65

0.5.64 (2013-03-08)

• disable env.sh without args (#370)
• add --bump to catkin_prepare_release
• add EXPORTED_TARGETS to catkin_package() for cross-package target dependencies (#368)
• enable cfg extras with absolute path and devel/install space specific
• enable additional cfg extra files via project specific global variable
• allow overriding CATKIN_TEST_RESULTS_DIR via cmake argument (#365)
• add options to skip generation of cmake config and pkg-config files (#360)
• catkin_make and catkin_make_isolated:
  • add --(c)make-args options to pass arbitrary arguments (#376)
• catkin_make:
  • enable to build individual package (#348)
  • enable to build metapackages without CMakeLists.txt (#349)
  • add colorization of several error messages
• catkin_make_isolated:
  • requires metapackages to have a CMakeLists.txt (#349)
  • force cmake for plain cmake packages when --install is toggled (#374)
  • switched default output from quiet to verbose (#331)
  • print full stacktrace to better diagnose internal problems (#373)
• various improvements and fixes for Windows (#276, #351, #358, #359)
• fixes:
  • catkin_make and catkin_make_isolated:
    • ignore install space and any subspaces when searching packages (#361)
  • catkin_make_isolated:
    • ensure that install space exists before trying to create a env.sh file for cmake projects (#340)
    • fix generated env.sh file if first package is plain cmake (#340)
    • remove old Makefile when cmake fails
  • fix sourcing some environment hooks multiple times
  • fix handling spaces in folder names (ros/catkin#375)
  • fix usage of ROS_PARALLEL_JOBS (#335)
  • prefix all temp variable in setup.sh (i.e. to not collide in zsh) (#338)
  • setup.sh: check that temp file was created successfully, call rm command instead of potential alias (#343)
• update documentation:
  • update doc on CFG_EXTRAS (#353)
  • general catkin docs (#357)
• for a complete list of changes see the commit log for 0.5.64

0.5.63 (2013-01-24)

• add sanity check to catkin_make that no CMakeLists.txt exists in the base path (#328)
• catkin_make and catkin_make_isolated:
  • add -lN besides -jN (#326)
  • support inverted color scheme (#323)
• catkin_make_isolated:
  • allow building individual packages (#322)
  • add support for -D options (#306)
  • generate setup.sh file (#327)
  • print instructions how to reproduce errors in case a command returns non-zero return code
• fixes:
  • readd old _setup_util.py to not break environment of workspaces built with 0.5.58 or older (#329)
  • fix sourcing environment hooks
  • improve several error messages in case of problems (#318, #320)
• for a complete list of changes see the commit log for 0.5.63

0.5.62 (2013-01-17)

• fixes:
  • add check to catkin_make to force cmake when cmake-specific arguments change
  • force cmake on workspace changes in catkin_make_isolated (#315)
  • source environment hooks for all workspace in correct order (#316)
  • fix PYTHON_PACKAGES_DIR and SETUPTOOLS_ARG_EXTRA to be up-to-date when passing -DSETUPTOOLS_DEB_LAYOUT=.. (#314)
• for a complete list of changes see the commit log for 0.5.62

0.5.61 (2013-01-16)

• yet another workaround for pkg-config handling static libraries (#300)
• for a complete list of changes see the commit log for 0.5.61

0.5.60 (2013-01-15)

• work around for pkg-config reordering libs with no -l prefix (#300)
• fix colorizing of unicode text in catkin_make and catkin_make_isolated (#310)
• for a complete list of changes see the commit log for 0.5.60

0.5.59 (2013-01-13)

• improve performance to source setup.sh for nested workspaces (#289)
• remove obsolete BUILD variables and find_package(ROS)
• improve error message when command execution or colorization fails (#298)
• catkin_make keeps track of previously build packages and forces cmake on changes (#290)
• fix pkg-config for absolute libraries (#300)
• fix catkin_toplogical_order (#299)
• make plain cmake install to devel when --install not present (#302)
• fix creating test_results folder before trying to use it when running tests
• for a complete list of changes see the commit log for 0.5.59

0.5.58 (2012-12-21)

• first public release for Groovy