dioxus/packages/autofmt/README.md

50 lines
1.9 KiB
Markdown
Raw Normal View History

2022-12-29 21:17:03 +00:00
# dioxus-autofmt
2022-12-29 21:17:03 +00:00
[![Crates.io][crates-badge]][crates-url]
[![MIT licensed][mit-badge]][mit-url]
[![Build Status][actions-badge]][actions-url]
[![Discord chat][discord-badge]][discord-url]
2022-07-05 05:53:08 +00:00
2022-12-29 21:17:03 +00:00
[crates-badge]: https://img.shields.io/crates/v/dioxus-autofmt.svg
[crates-url]: https://crates.io/crates/dioxus-autofmt
2022-07-05 17:31:26 +00:00
2022-12-29 21:17:03 +00:00
[mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg
[mit-url]: https://github.com/dioxuslabs/dioxus/blob/master/LICENSE
2022-07-05 17:31:26 +00:00
2022-12-29 21:17:03 +00:00
[actions-badge]: https://github.com/dioxuslabs/dioxus/actions/workflows/main.yml/badge.svg
[actions-url]: https://github.com/dioxuslabs/dioxus/actions?query=workflow%3ACI+branch%3Amaster
2022-12-29 21:17:03 +00:00
[discord-badge]: https://img.shields.io/discord/899851952891002890.svg?logo=discord&style=flat-square
[discord-url]: https://discord.gg/XgGxMSkvUM
2022-12-29 21:17:03 +00:00
[Website](https://dioxuslabs.com) |
[Guides](https://dioxuslabs.com/guide/) |
[API Docs](https://docs.rs/dioxus-autofmt/latest/dioxus_autofmt) |
2022-12-29 21:17:03 +00:00
[Chat](https://discord.gg/XgGxMSkvUM)
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
## Overview
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
`dioxus-autofmt` provides a pretty printer for the `rsx` syntax tree.
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
This is done manually with a via set of formatting rules. The output is not guaranteed to be stable between minor versions of the crate as we might tweak the output.
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
`dioxus-autofmt` provides an API to perform precision edits as well as just spit out a block of formatted RSX from any RSX syntax tree. This is used by the `rsx-rosetta` crate which can accept various input languages and output valid RSX.
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
## Contributing
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
- Report issues on our [issue tracker](https://github.com/dioxuslabs/dioxus/issues).
- Join the discord and ask questions!
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
## License
This project is licensed under the [MIT license].
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
[mit license]: https://github.com/DioxusLabs/dioxus/blob/master/LICENSE-MIT
2022-09-30 17:51:53 +00:00
2022-12-29 21:17:03 +00:00
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in Dioxus by you shall be licensed as MIT without any additional
2022-12-29 21:17:03 +00:00
terms or conditions.