Skip to content

Commit

Permalink
update README
Browse files Browse the repository at this point in the history
  • Loading branch information
gezp committed Oct 10, 2021
1 parent cdc76a3 commit 984032c
Showing 1 changed file with 9 additions and 5 deletions.
14 changes: 9 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,19 @@
# xmacro

**This package is refactor version of `xacro4sdf`. (WIP)**

`xmacro` is a simple tool to define and parse XML macro. it's inspired by [ros/xacro](https://github.com/ros/xacro) which is an XML macro language desiged for `urdf`, `xmacro` looks like simplified version of [ros/xacro](https://github.com/ros/xacro) , but it's more simple, and also more easy to use.

* `xmacro` is independent of ROS, you could install it by `pip` .
* XML namespaces isn't used in `xmacro` , and there are some reserved words for `xmacro` : `xmacro_include`, `xmacro_define_value`, `xmacro_define_block`, `xmacro_block`.
* it provides python api so that we could parse xml file in ROS2 launch file.
* it provides `xmacro4sdf` : general `xmacro` with some specific function for `sdf`.


## Usage

Installation

```bash
# install by pip
pip install xmacro
# install from source code
git clone https://github.com/gezp/xmacro.git
cd xmacro && sudo python3 setup.py install
Expand Down Expand Up @@ -159,7 +158,7 @@ xmacro.to_file(outputfile)

## XMLMacro4sdf Features

### pre-defined common.sdf.xmacro
pre-defined common.sdf.xmacro

```xml
<!--macro defination:inertia-->
Expand All @@ -175,7 +174,12 @@ xmacro.to_file(outputfile)
<xmacro_define_block name="visual_collision_with_mesh" params="prefix uri">
```

(TODO)
examples

```bash
# some examples in folder test/sdf
xmacro4sdf model.sdf.xmacro > model.sdf
```

## Maintainer and License

Expand Down

0 comments on commit 984032c

Please sign in to comment.