Rename package and simplify package.xml & CMakeLists.txt

Rename the package to the more descriptive
'boost_python_catkin_example'.

Add some information in package.xml and remove unnecessary dependencies
and autogenerated stuff.

Set Python version to 2.7 (otherwise it may find Python 3 which does not
work).

Author: Felix Widmaier

CMakeLists.txt

@@ -1,18 +1,14 @@
 cmake_minimum_required(VERSION 2.8.3)
-project(boostpy_test)
+project(boost_python_catkin_example)
 
 ## Find catkin macros and libraries
 ## if COMPONENTS list like find_package(catkin REQUIRED COMPONENTS xyz)
 ## is used, also find other catkin packages
-find_package(catkin REQUIRED COMPONENTS
-  roscpp
-  rospy
-)
+find_package(catkin REQUIRED)
 
 ## System dependencies are found with CMake's conventions
 find_package(Boost REQUIRED COMPONENTS python)
-
-find_package(PythonLibs REQUIRED) # sets ${PYTHON_INCLUDE_DIRS}
+find_package(PythonLibs 2.7 REQUIRED) # sets ${PYTHON_INCLUDE_DIRS}
 
 
 ## Uncomment this if the package has a setup.py. This macro ensures
@@ -21,7 +17,6 @@ find_package(PythonLibs REQUIRED) # sets ${PYTHON_INCLUDE_DIRS}
 catkin_python_setup() # this sets up the path /devel/lib/python2.7/dist-packages/boostpy_test
 
 
-
 ###################################
 ## catkin specific configuration ##
 ###################################
@@ -54,7 +49,8 @@ include_directories(
 add_library(mycpplib SHARED
   src/mycpplib.cpp
 )
-# change output directory, so python can find the module
+# change output directory, so python can find the module, and set prefix to ""
+# to omit the default "lib".
 set_target_properties(mycpplib PROPERTIES
   PREFIX ""
   LIBRARY_OUTPUT_DIRECTORY ${CATKIN_DEVEL_PREFIX}/${CATKIN_PACKAGE_PYTHON_DESTINATION}

package.xml

@@ -1,57 +1,17 @@
 <?xml version="1.0"?>
 <package>
-  <name>boostpy_test</name>
-  <version>0.0.0</version>
-  <description>The boostpy_test package</description>
-
-  <!-- One maintainer tag required, multiple allowed, one person per tag --> 
-  <!-- Example:  -->
-  <!-- <maintainer email="jane.doe@example.com">Jane Doe</maintainer> -->
-  <maintainer email="felix@todo.todo">felix</maintainer>
-
-
-  <!-- One license tag required, multiple allowed, one license per tag -->
-  <!-- Commonly used license strings: -->
-  <!--   BSD, MIT, Boost Software License, GPLv2, GPLv3, LGPLv2.1, LGPLv3 -->
-  <license>TODO</license>
+  <name>boost_python_catkin_example</name>
+  <version>1.0.0</version>
+  <description>
+    A minimal example package on how to use Boost::Python with catkin.
+  </description>
 
+  <maintainer email="felix@todo.todo">Felix Widmaier</maintainer>
+  <license>GPLv2</license>
 
   <!-- Url tags are optional, but mutiple are allowed, one per tag -->
   <!-- Optional attribute type can be: website, bugtracker, or repository -->
-  <!-- Example: -->
-  <!-- <url type="website">http://wiki.ros.org/boostpy_test</url> -->
-
-
-  <!-- Author tags are optional, mutiple are allowed, one per tag -->
-  <!-- Authors do not have to be maintianers, but could be -->
-  <!-- Example: -->
-  <!-- <author email="jane.doe@example.com">Jane Doe</author> -->
+  <url type="website">https://github.com/luator/ros-boost-python</url>
 
-
-  <!-- The *_depend tags are used to specify dependencies -->
-  <!-- Dependencies can be catkin packages or system dependencies -->
-  <!-- Examples: -->
-  <!-- Use build_depend for packages you need at compile time: -->
-  <!--   <build_depend>message_generation</build_depend> -->
-  <!-- Use buildtool_depend for build tool packages: -->
-  <!--   <buildtool_depend>catkin</buildtool_depend> -->
-  <!-- Use run_depend for packages you need at runtime: -->
-  <!--   <run_depend>message_runtime</run_depend> -->
-  <!-- Use test_depend for packages you need only for testing: -->
-  <!--   <test_depend>gtest</test_depend> -->
   <buildtool_depend>catkin</buildtool_depend>
-  <build_depend>roscpp</build_depend>
-  <build_depend>rospy</build_depend>
-  <run_depend>roscpp</run_depend>
-  <run_depend>rospy</run_depend>
-
-
-  <!-- The export tag contains other, unspecified, tags -->
-  <export>
-    <!-- You can specify that this package is a metapackage here: -->
-    <!-- <metapackage/> -->
-
-    <!-- Other tools can request additional information be placed here -->
-
-  </export>
-</package>
+</package>

scripts/use_cpplib.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-import boostpy_test.mycpplib as cpp
+import boost_python_catkin_example.mycpplib as cpp
 
 # this is the equivalent to `main()` in c++
 if __name__ == '__main__':

setup.py

@@ -5,7 +5,7 @@
 
 # fetch values from package.xml
 setup_args = generate_distutils_setup(
-    packages=['boostpy_test'],
+    packages=['boost_python_catkin_example'],
     package_dir={'': 'src'},
 )