ign -> gz Namespace Migration : sdformat (#1022)

* Migrate namespaces

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Add migration line

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Migrate includes to gz

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Mention gz headers in migration

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Update config.hh and migrate Export.hh macros

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Migrate namespaces

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Greedy macro migration

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Migrate more namespaces

Signed-off-by: methylDragon <methylDragon@gmail.com>

* `ignitionrobotics` -> `gazebosim` and `Ignition Robotics` -> `Gazebo`

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Update github links

Signed-off-by: methylDragon <methylDragon@gmail.com>

* Add in and migrate material forward ports

Signed-off-by: methylDragon <methylDragon@gmail.com>

* gz for new tests

Signed-off-by: Louise Poubel <louise@openrobotics.org>

Co-authored-by: Louise Poubel <louise@openrobotics.org>

Author: methylDragon

.github/ci/before_cmake.sh

@@ -7,7 +7,7 @@ BUILD_DIR=`pwd`
 cd /tmp
 
 # check that we can compile USD from sources (only Focal)
-# see https://github.com/ignitionrobotics/sdformat/issues/869
+# see https://github.com/gazebosim/sdformat/issues/869
 return_code=0
 if [ "$(lsb_release -r -s)" != "20.04" ]; then
   return_code=$(($return_code + 1))

CMakeLists.txt

@@ -65,7 +65,7 @@ if (BUILD_SDF)
 
   #################################################
   # Find ign command line utility:
-  find_program(IGN_PROGRAM ign)
+  find_program(GZ_PROGRAM ign)
 
   #################################################
   # Copied from catkin/cmake/empy.cmake

CODE_OF_CONDUCT.md

@@ -56,7 +56,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at [https://ignitionrobotics.org/support](https://ignitionrobotics.org/support). All
+reported by contacting the project team at [https://gazebosim.org/support](https://gazebosim.org/support). All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

CONTRIBUTING.md

@@ -1,3 +1,3 @@
 See the
-[Ignition Robotics contributing guide](https://ignitionrobotics.org/docs/all/contributing)
+[Gazebo contributing guide](https://gazebosim.org/docs/all/contributing)
 for how to contribute to SDFormat.

Changelog.md

@@ -12,6 +12,16 @@ forward programmatically.
 This document aims to contain similar information to those files
 but with improved human-readability..
 
+## libsdformat 12.x to 13.x
+
+### Deprecations
+
+- The `ignition` namespace is deprecated and will be removed in future versions.
+  Use `gz` instead.
+
+- Header files under `ignition/...` are deprecated and will be removed in future versions.
+  Use `gz/...` instead.
+
 ## libsdformat 11.x to 12.0
 
 An error is now emitted instead of a warning for a file containing more than
@@ -65,8 +75,8 @@ one root level model, actor or light.
     + void SetLocalModelName(const std::string &)
     + const std::optional<bool> &IsStatic() const
     + void SetIsStatic(bool)
-    + const std::optional<ignition::math::Pose3d> &IncludeRawPose() const
-    + void SetIncludeRawPose(const ignition::math::Pose3d &includeRawPose)
+    + const std::optional<gz::math::Pose3d> &IncludeRawPose() const
+    + void SetIncludeRawPose(const gz::math::Pose3d &includeRawPose)
     + const std::optional<std::string> &IncludePoseRelativeTo() const
     + void SetIncludePoseRelativeTo(const std::string &)
     + const std::optional<std::string> &PlacementFrame() const
@@ -81,19 +91,19 @@ one root level model, actor or light.
     + bool IgnoresParentElementAttribute() const;
 
 1. **sdf/World.hh**:
-    + const ignition::math::SphericalCoordinates * SphericalCoordinates() const;
-    + void SetSphericalCoordinates(const ignition::math::SphericalCoordinates &);
+    + const gz::math::SphericalCoordinates * SphericalCoordinates() const;
+    + void SetSphericalCoordinates(const gz::math::SphericalCoordinates &);
 
 ### Modifications
 
-1. **sdf/Element.hh**: The following methods now have an additional parameter of 
+1. **sdf/Element.hh**: The following methods now have an additional parameter of
    type `PrintConfig` with a default value
     + void PrintValues(std::string, const PrintConfig &\_config = PrintConfig()) const
     + void PrintValues(const std::string, bool, bool, const PrintConfig &\_config = PrintConfig()) const
     + std::string ToString(const std::string &, const PrintConfig &\_config = PrintConfig()) const
     + std::string ToString(const std::string &, bool, bool ,const PrintConfig &\_config = PrintConfig()) const
 
-1. **sdf/Param.hh**: The following methods now have an additional parameter of 
+1. **sdf/Param.hh**: The following methods now have an additional parameter of
    type `PrintConfig` with a default value
     + std::string GetAsString(const PrintConfig &\_config = PrintConfig()) const
     + std::string GetDefaultAsString(const PrintConfig &\_config = PrintConfig()) const
@@ -103,14 +113,14 @@ one root level model, actor or light.
     The following now has an additional bool parameter
     + bool SetFromString(const std::string &, bool \_ignoreParentAttributes);
 
-1. **sdf/SDFImpl.hh**: The following methods now have an additional parameter of 
+1. **sdf/SDFImpl.hh**: The following methods now have an additional parameter of
    type `PrintConfig` with a default value
     + void PrintValues(const PrintConfig &\_config = PrintConfig())
     + std::string ToString(const PrintConfig &\_config = PrintConfig()) const
 
-1. The string literals used to indicate non-file sources have been changed to 
-   `<data-string>` and `<urdf-string>` for SDFormat and URDF source 
-   respectively. Users are encouraged to use the constants `kSdfStringSource` 
+1. The string literals used to indicate non-file sources have been changed to
+   `<data-string>` and `<urdf-string>` for SDFormat and URDF source
+   respectively. Users are encouraged to use the constants `kSdfStringSource`
    and `kUrdfStringSource` instead of hard-coding the string literals.
 
 ### Removals
@@ -141,8 +151,8 @@ The following deprecated methods and classes have been removed.
 
 ### Deprecations
 
-1. **sdf/InterfaceElements.hh**: The struct `NestedInclude` has been converted 
-   to a class. Accessing data members directly is deprecated. Instead use the 
+1. **sdf/InterfaceElements.hh**: The struct `NestedInclude` has been converted
+   to a class. Accessing data members directly is deprecated. Instead use the
    corresponding member functions.
 
 ## libsdformat 11.1.0 to 11.2.0
@@ -256,8 +266,8 @@ ABI was broken for `sdf::Element`, and restored on version 11.2.1.
    + [Pull request 276](https://github.com/osrf/sdformat/pull/276)
 
 1. + Removed the deprecated `Pose()`, `SetPose()`, and `*PoseFrame()` API's in all DOM classes:
-   + const ignition::math::Pose3d &Pose()
-   + void SetPose(const ignition::math::Pose3d &)
+   + const gz::math::Pose3d &Pose()
+   + void SetPose(const gz::math::Pose3d &)
    + const std::string &PoseFrame()
    + void SetPoseFrame(const std::string &)
 
@@ -332,7 +342,7 @@ ABI was broken for `sdf::Element`, and restored on version 11.2.1.
     + sdf::SemanticPose SemanticPose() const
 
 1. **sdf/JointAxis.hh**
-    + Errors ResolveXyz(ignition::math::Vector3d &, const std::string &) const
+    + Errors ResolveXyz(gz::math::Vector3d &, const std::string &) const
 
 1. **sdf/Light.hh**
     + sdf::SemanticPose SemanticPose() const
@@ -384,12 +394,12 @@ ABI was broken for `sdf::Element`, and restored on version 11.2.1.
    + ***Replacement:*** None. Use the functions sdf::readFile or sdf::readString, which automatically convert URDF to SDFormat.
 
 1. All DOM classes with `Pose()` and `PoseFrame()` API's:
-   + ***Deprecation:*** const ignition::math::Pose3d &Pose()
-   + ***Replacement:*** const ignition::math::Pose3d &RawPose()
+   + ***Deprecation:*** const gz::math::Pose3d &Pose()
+   + ***Replacement:*** const gz::math::Pose3d &RawPose()
    + ***Deprecation:*** const std::string &PoseFrame()
    + ***Replacement:*** const std::string &PoseRelativeTo()
-   + ***Deprecation:*** void SetPose(const ignition::math::Pose3d &)
-   + ***Replacement:*** void SetRawPose(const ignition::math::Pose3d &)
+   + ***Deprecation:*** void SetPose(const gz::math::Pose3d &)
+   + ***Replacement:*** void SetRawPose(const gz::math::Pose3d &)
    + ***Deprecation:*** void SetPoseFrame(const std::string &)
    + ***Replacement:*** void SetPoseRelativeTo(const std::string &)
 
@@ -418,7 +428,7 @@ ABI was broken for `sdf::Element`, and restored on version 11.2.1.
 
 1. **sdf/Types.hh**
    + ***Deprecated:*** sdf::Color class
-   + ***Replacement:*** ignition::math::Color class
+   + ***Replacement:*** gz::math::Color class
 
 ## SDFormat 4.x to 5.x
 
@@ -448,15 +458,15 @@ ABI was broken for `sdf::Element`, and restored on version 11.2.1.
 
 1. **sdf/Types.hh**
     + ***Deprecation:*** sdf::Vector2i
-    + ***Replacement:*** ignition::math::Vector2i
+    + ***Replacement:*** gz::math::Vector2i
     + ***Deprecation:*** sdf::Vector2d
-    + ***Replacement:*** ignition::math::Vector2d
+    + ***Replacement:*** gz::math::Vector2d
     + ***Deprecation:*** sdf::Vector3
-    + ***Replacement:*** ignition::math::Vector3d
+    + ***Replacement:*** gz::math::Vector3d
     + ***Deprecation:*** sdf::Quaternion
-    + ***Replacement:*** ignition::math::Quaterniond
+    + ***Replacement:*** gz::math::Quaterniond
     + ***Deprecation:*** sdf::Pose
-    + ***Replacement:*** ignition::math::Pose3d
+    + ***Replacement:*** gz::math::Pose3d
 
 ## SDFormat 3.x to 4.x
 
@@ -481,35 +491,35 @@ ABI was broken for `sdf::Element`, and restored on version 11.2.1.
 ### Additions
 
 1. **camera.sdf**: New elements to configure segmentation and boundingbox cameras
-    + `//sensor/camera/segmentation_type` 
+    + `//sensor/camera/segmentation_type`
     + `//sensor/camera/box_type`
-    + [Pull request #592](https://github.com/ignitionrobotics/sdformat/pull/592)
+    + [Pull request #592](https://github.com/gazebosim/sdformat/pull/592)
 
 1. **forcetorque.sdf**: New elements to specify the noise characteristics of the force-torque sensor
     + `//sensor/force_torque/force`
-    + `//sensor/force_torque/torque` 
-    + [Pull request #669](https://github.com/ignitionrobotics/sdformat/pull/669)
+    + `//sensor/force_torque/torque`
+    + [Pull request #669](https://github.com/gazebosim/sdformat/pull/669)
 
 1. **model.sdf**: `//model/include/@merge` for merging included nested models into the containing model
-    + [Pull request #659](https://github.com/ignitionrobotics/sdformat/pull/659)
+    + [Pull request #659](https://github.com/gazebosim/sdformat/pull/659)
 
 1. **pose.sdf**: New attributes to support specifying angles in degrees and specifying rotations in quaternions
     + `//pose/@rotation_format`
     + `//pose/@degrees`
-    + [Pull request #690](https://github.com/ignitionrobotics/sdformat/pull/690)
-    + [Pull request #589](https://github.com/ignitionrobotics/sdformat/pull/589)
+    + [Pull request #690](https://github.com/gazebosim/sdformat/pull/690)
+    + [Pull request #589](https://github.com/gazebosim/sdformat/pull/589)
 
 1. **sensor.sdf**: New sensor types `boundingbox_camera`, `segmentation_camera`, and `custom`.
-    + [Pull request #592](https://github.com/ignitionrobotics/sdformat/pull/592)
+    + [Pull request #592](https://github.com/gazebosim/sdformat/pull/592)
 
 ### Removals
 
 1. **joint.sdf**
     + Deprecated elements `//joint/axis/initial_position` and `//joint/axis2/initial_position` have been removed
-    * [Pull request #622](https://github.com/ignitionrobotics/sdformat/pull/622)
+    * [Pull request #622](https://github.com/gazebosim/sdformat/pull/622)
 
 1. **spherical_coordinates**: Unsupported options `NED` and `NWU` have been removed from `//spherical_coordinates/world_frame_orientation`
-    * [Pull request #685](https://github.com/ignitionrobotics/sdformat/pull/685)
+    * [Pull request #685](https://github.com/gazebosim/sdformat/pull/685)
 
 ## SDFormat specification 1.7 to 1.8
 

Migration.md

@@ -32,7 +32,7 @@ TODO(eric.cousineau): Move terminology section to sdf_tutorials?
 ## Test coverage
 
 <!-- Note: The branch name in the codecov URL should be updated when forward porting -->
-[![codecov](https://codecov.io/gh/ignitionrobotics/sdformat/branch/main/graph/badge.svg)](https://codecov.io/gh/ignitionrobotics/sdformat/branch/main)
+[![codecov](https://codecov.io/gh/gazebosim/sdformat/branch/main/graph/badge.svg)](https://codecov.io/gh/gazebosim/sdformat/branch/main)
 
 # Installation
 
@@ -143,7 +143,7 @@ make uninstall
 
 Clone the repository
 ```sh
-git clone https://github.com/ignitionrobotics/sdformat -b sdf<#>
+git clone https://github.com/gazebosim/sdformat -b sdf<#>
 ```
 Be sure to replace `<#>` with a number value, such as 1 or 2, depending on
 which version you need.

README.md

@@ -41,7 +41,7 @@ <h2 style="text-align:center;">
         <dd><a href="http://sdf.com/wiki/Tutorials">Tutorials</a></dd>
         <dd><a href="http://sdf.com/downloads.html">Download</a></dd>
         -->
-        <dd><a href="https://github.com/ignitionrobotics/sdformat/issues/new">Report Documentation Issues</a></dd>
+        <dd><a href="https://github.com/gazebosim/sdformat/issues/new">Report Documentation Issues</a></dd>
       </dl>
     </div>
     <div>

doc/header.html

@@ -5,7 +5,7 @@
 Desctiption Format API. The code reference is divided into the groups below.
 Should you find problems with this documentation - typos, unclear phrases,
 or insufficient detail - please create a <a
-  href="https://github.com/ignitionrobotics/sdformat/issues/new">new GitHub issue</a>.
+  href="https://github.com/gazebosim/sdformat/issues/new">new GitHub issue</a>.
 Include sufficient detail to quickly locate the problematic documentation,
 and set the issue's fields accordingly: Assignee - blank; Kind - bug;
 Priority - minor; Version - blank.

doc/mainpage.html

@@ -3,7 +3,7 @@
 This example shows how to use sdformat's Python API.
 
 In the
-[examples/python](https://github.com/ignitionrobotics/sdformat/blob/main/examples/python)
+[examples/python](https://github.com/gazebosim/sdformat/blob/main/examples/python)
 folder there is a Python script that shows how to make use of this API.
 
 > If you compiled sdformat from source you should modify your `PYTHONPATH`: