Added Python interfaces to some Ignition Gazebo methods

CMakeLists.txt

@@ -15,6 +15,7 @@ find_package(ignition-cmake2 2.8.0 REQUIRED)
 # Configure the project
 #============================================================================
 ign_configure_project(VERSION_SUFFIX)
+set (CMAKE_CXX_STANDARD 17)
 
 #============================================================================
 # Set project-specific options
@@ -186,6 +187,8 @@ add_subdirectory(examples)
 #============================================================================
 ign_create_packages()
 
+add_subdirectory(python)
+
 #============================================================================
 # Configure documentation
 #============================================================================

examples/python/gravity.sdf

@@ -0,0 +1,22 @@
+<?xml version="1.0" ?>
+<sdf version="1.6">
+  <world name="gravity">
+    <plugin
+      filename="ignition-gazebo-physics-system"
+      name="ignition::gazebo::systems::Physics">
+    </plugin>
+
+    <model name="falling">
+      <link name="link">
+        <inertial>
+          <inertia>
+            <ixx>0.4</ixx>
+            <iyy>0.4</iyy>
+            <izz>0.4</izz>
+          </inertia>
+          <mass>1.0</mass>
+        </inertial>
+      </link>
+    </model>
+  </world>
+</sdf>

examples/python/helperFixture.py

@@ -0,0 +1,75 @@
+#!/usr/bin/python3
+# Copyright (C) 2021 Open Source Robotics Foundation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from ignition.common import set_verbosity
+from ignition.gazebo import HelperFixture, World
+from ignition.math import Vector3d
+
+
+set_verbosity(4)
+
+file_path = os.path.dirname(os.path.realpath(__file__))
+
+helper = HelperFixture(os.path.join(file_path, 'gravity.sdf'))
+
+post_iterations = 0
+iterations = 0
+pre_iterations = 0
+
+
+def on_configure_cb(worldEntity, _ecm):
+    print('World entity is ', worldEntity)
+    w = World(worldEntity)
+    v = w.gravity(_ecm)
+    print('Gravity ', v)
+    modelEntity = w.model_by_name(_ecm, 'falling')
+    print('Entity for falling model is: ', modelEntity)
+
+
+def on_post_udpate_cb(_info, _ecm):
+    global post_iterations
+    post_iterations += 1
+    # print(_info.sim_time)
+
+
+def on_pre_udpate_cb(_info, _ecm):
+    global pre_iterations
+    pre_iterations += 1
+
+
+def on_udpate_cb(_info, _ecm):
+    global iterations
+    iterations += 1
+
+
+helper.on_post_update(on_post_udpate_cb)
+helper.on_update(on_udpate_cb)
+helper.on_pre_update(on_pre_udpate_cb)
+helper.on_configure(on_configure_cb)
+
+helper.finalize()
+
+server = helper.server()
+server.run(False, 1000, False)
+
+while(server.is_running()):
+    time.sleep(0.1)
+
+print('iterations ', iterations)
+print('post_iterations ', post_iterations)
+print('pre_iterations ', pre_iterations)

python/CMakeLists.txt

@@ -0,0 +1,99 @@
+if(WIN32 AND CMAKE_BUILD_TYPE STREQUAL "Debug")
+  # pybind11 logic for setting up a debug build when both a debug and release
+  # python interpreter are present in the system seems to be pretty much broken.
+  # This works around the issue.
+  set(PYTHON_LIBRARIES "${PYTHON_DEBUG_LIBRARIES}")
+endif()
+
+
+if(USE_SYSTEM_PATHS_FOR_PYTHON_INSTALLATION)
+  if(${CMAKE_VERSION} VERSION_LESS "3.12.0")
+    execute_process(
+      COMMAND "${PYTHON_EXECUTABLE}" -c "if True:
+  from distutils import sysconfig as sc
+  print(sc.get_python_lib(plat_specific=True))"
+      OUTPUT_VARIABLE Python3_SITEARCH
+      OUTPUT_STRIP_TRAILING_WHITESPACE)
+  else()
+    # Get install variable from Python3 module
+    # Python3_SITEARCH is available from 3.12 on, workaround if needed:
+    find_package(Python3 COMPONENTS Interpreter)
+  endif()
+
+  if(USE_DIST_PACKAGES_FOR_PYTHON)
+    string(REPLACE "site-packages" "dist-packages" IGN_PYTHON_INSTALL_PATH ${Python3_SITEARCH})
+  else()
+    # custom cmake command is returning dist-packages
+    string(REPLACE "dist-packages" "site-packages" IGN_PYTHON_INSTALL_PATH ${Python3_SITEARCH})
+  endif()
+else()
+  # If not a system installation, respect local paths
+  set(IGN_PYTHON_INSTALL_PATH ${IGN_LIB_INSTALL_DIR}/python)
+endif()
+
+set(IGN_PYTHON_INSTALL_PATH "${IGN_PYTHON_INSTALL_PATH}/ignition")
+
+set(PYBIND11_PYTHON_VERSION 3)
+
+find_package(pybind11 2.2 QUIET)
+
+if (NOT ${pybind11_FOUND})
+  if(${CMAKE_VERSION} VERSION_GREATER_EQUAL "3.11.0")
+    include(FetchContent)
+    FetchContent_Declare(
+        pybind11
+        GIT_REPOSITORY https://github.com/pybind/pybind11
+        GIT_TAG        v2.8.1
+    )
+
+    FetchContent_GetProperties(pybind11)
+    if(NOT pybind11_POPULATED)
+        FetchContent_Populate(pybind11)
+        add_subdirectory(${pybind11_SOURCE_DIR} ${pybind11_BINARY_DIR})
+    endif()
+    set(pybind11_FOUND TRUE)
+  endif()
+endif()
+
+if (${pybind11_FOUND})
+
+  # Set the build location and install location for a CPython extension
+  function(configure_build_install_location _library_name)
+    # Install library for actual use
+    install(TARGETS ${_library_name}
+      DESTINATION "${IGN_PYTHON_INSTALL_PATH}/"
+    )
+  endfunction()
+
+  pybind11_add_module(gazebo SHARED
+    src/ignition/gazebo/_ignition_gazebo_pybind11.cc
+    src/ignition/gazebo/Destroyable.cc
+    src/ignition/gazebo/EntityComponentManager
+    src/ignition/gazebo/EventManager.cc
+    src/ignition/gazebo/HelperSystem.cc
+    src/ignition/gazebo/Server.cc
+		src/ignition/gazebo/ServerConfig.cc
+    src/ignition/gazebo/UpdateInfo.cc
+    src/ignition/gazebo/World.cc
+  )
+
+  target_link_libraries(gazebo PRIVATE
+    ${PROJECT_LIBRARY_TARGET_NAME}
+    sdformat${SDF_VER}::sdformat${SDF_VER}
+    ignition-common${IGN_COMMON_VER}::ignition-common${IGN_COMMON_VER}
+  )
+
+  # TODO(ahcorde): Move this module to ign-common
+  pybind11_add_module(common SHARED
+    src/ignition/common/_ignition_common_pybind11.cc
+    src/ignition/common/Console.cc
+  )
+
+  target_link_libraries(common PRIVATE
+    ignition-common${IGN_COMMON_VER}::ignition-common${IGN_COMMON_VER}
+  )
+
+  configure_build_install_location(gazebo)
+  configure_build_install_location(common)
+
+endif()

python/src/ignition/common/Console.cc

@@ -0,0 +1,31 @@
+// Copyright 2021 Open Source Robotics Foundation, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include <ignition/common/Console.hh>
+
+#include "Console.hh"
+
+namespace ignition
+{
+  namespace common
+  {
+    namespace python
+    {
+      void SetVerbosity(int _verbosity)
+      {
+        ignition::common::Console::SetVerbosity(_verbosity);
+      }
+    }
+  }
+}

python/src/ignition/common/Console.hh

@@ -0,0 +1,31 @@
+// Copyright 2021 Open Source Robotics Foundation, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef IGNITION_GAZEBO_PYTHON__CONSOLE_HH_
+#define IGNITION_GAZEBO_PYTHON__CONSOLE_HH_
+
+#include <pybind11/pybind11.h>
+
+namespace ignition
+{
+  namespace common
+  {
+    namespace python
+    {
+      void SetVerbosity(int _verbosity);
+    }
+  }
+}
+
+#endif

python/src/ignition/common/_ignition_common_pybind11.cc

@@ -0,0 +1,25 @@
+// Copyright 2021 Open Source Robotics Foundation, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#include <pybind11/pybind11.h>
+
+#include "Console.hh"
+
+PYBIND11_MODULE(common, m) {
+  m.doc() = "Ignition Common Python Library.";
+
+  m.def(
+    "set_verbosity", &ignition::common::python::SetVerbosity,
+    "Set verbosity level.");
+}