https://github.com/foxglove/omgidl
Monorepo offering packages for typescript support of OMG IDL schemas in Foxglove applications
https://github.com/foxglove/omgidl
cdr idl omg parser
Last synced: about 2 months ago
JSON representation
Monorepo offering packages for typescript support of OMG IDL schemas in Foxglove applications
- Host: GitHub
- URL: https://github.com/foxglove/omgidl
- Owner: foxglove
- License: mit
- Created: 2023-06-09T21:32:30.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-11T14:25:10.000Z (about 1 year ago)
- Last Synced: 2025-04-11T15:39:38.412Z (about 1 year ago)
- Topics: cdr, idl, omg, parser
- Language: TypeScript
- Homepage:
- Size: 1.34 MB
- Stars: 6
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Foxglove OMG IDL
This repo contains implementations of OMG IDL specifications used by [Foxglove](https://www.foxglove.dev). The parsers expect schemas according to the MCAP specifications: [ros2idl](https://mcap.dev/spec/registry#ros2idl), [omgidl](https://mcap.dev/spec/registry#omgidl).
| Package name | Description | Reference | Version |
| -------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `@foxglove/omgidl-parser` | Parse OMG IDL schemas – [README](./packages//omgidl-parser/README.md) | [Interface Definition Language Specification](https://www.omg.org/spec/IDL/4.2/PDF) | [](https://www.npmjs.com/package/@foxglove/omgidl-parser) |
| `@foxglove/omgidl-serialization` | De/Serialize data using IDL to CDR and CDR2 – [README](./packages/omgidl-serialization/README.md) | [Common Object Request Broker Architecture (CORBA) Specification, Part 2: CORBA Interoperability](https://www.omg.org/spec/CORBA/3.4/Interoperability/PDF), section 9.3 (CDR Transfer Syntax); [Extensible and Dynamic Types for DDS Specification](https://www.omg.org/spec/DDS-XTypes/1.3/PDF) | [](https://www.npmjs.com/package/@foxglove/omgidl-serialization) |
| `@foxglove/ros2idl-parser` | Parse the ROS 2 dialect of IDL – [README](./packages/ros2idl-parser/README.md) | [article](https://design.ros2.org/articles/idl_interface_definition.html), [repo](https://github.com/ros2/rosidl) | [](https://www.npmjs.com/package/@foxglove/ros2idl-parser) |
See known limitations here:
[Parser/Grammar Limitations](./packages/omgidl-parser/README.md#omg-idl-subset-support)
[Serialization Limitations](./packages/omgidl-serialization/README.md#known-limitations)
## Setup
```
corepack enable
yarn install
```
## Test
If it's your first time building, you'll need to run `yarn build`.
Then to run test cases across all packages run `yarn test` from the root directory.
Note: to ensure that tests from a downstream in-repo dependency are running against the latest upstream version of code, you'll have to run `yarn build` every time you change the upstream dependency.
The dependency flow is as follows:
- `@foxglove/omgidl-serialization` depends on `@foxglove/omgidl-parser`
- `@foxglove/ros2idl-parser` depends on `@foxglove/omgidl-parser`
## Deploy packages
1. Open a PR updating the version of the packages that have new versions that need to be deployed.
2. Land PR with change of version numbers and pull the latest on main locally
3. Add git tags for each package you'd like to publish using the following prefixes
- `@foxglove/omgidl-parser` -> `omgidl-parser/vX.X.X`
- `@foxglove/omgidl-serialization` -> `omgidl-serialization/vX.X.X`
- `@foxglove/ros2idl-parser` -> `ros2idl-parser/vX.X.X`
4. For example: if you're updating `@foxglove/omgidl-parser` to `v1.2.1` you would add the corresponding git tag by running `git tag omgidl-parser/v1.2.1`. For updating multiple packages on a single commit you can add multiple tags: `git tag omgidl-parser/v1.2.1 omgidl-serialization/v1.1.3` .
5. After adding the tag run `git push origin refs/tags/` to push the specific tag to the remote
## Stay in touch
Join our [Slack channel](https://foxglove.dev/slack) to ask questions, share feedback, and stay up to date on what our team is working on.
## License
foxglove/omgidl and its packages are licensed under the [MIT License](https://opensource.org/licenses/MIT).