Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mbasso/gccx
Transforms CPX (JSX like syntax) into asm-dom Virtual DOM
https://github.com/mbasso/gccx
asm-dom cpp cpx jsx virtual-dom
Last synced: 2 days ago
JSON representation
Transforms CPX (JSX like syntax) into asm-dom Virtual DOM
- Host: GitHub
- URL: https://github.com/mbasso/gccx
- Owner: mbasso
- License: mit
- Created: 2017-09-10T08:53:43.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-06-18T14:39:31.000Z (over 6 years ago)
- Last Synced: 2024-12-13T07:35:51.121Z (9 days ago)
- Topics: asm-dom, cpp, cpx, jsx, virtual-dom
- Language: JavaScript
- Size: 326 KB
- Stars: 262
- Watchers: 13
- Forks: 13
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# gccx
[![Build Status](https://travis-ci.org/mbasso/gccx.svg?branch=master)](https://travis-ci.org/mbasso/gccx)
[![npm version](https://img.shields.io/npm/v/gccx.svg)](https://www.npmjs.com/package/gccx)
[![npm downloads](https://img.shields.io/npm/dm/gccx.svg?maxAge=2592000)](https://www.npmjs.com/package/gccx)
[![MIT](https://img.shields.io/npm/l/gccx.svg)](https://github.com/mbasso/gccx/blob/master/LICENSE.md)> Transforms CPX (JSX like syntax) into asm-dom Virtual DOM
![Preview](preview.jpeg)
## Motivation
[asm-dom](https://github.com/mbasso/asm-dom) Virtual DOM is a little bit verbose to write, we need a lot, not to much readable, lines of code to create a view. In addition we have to convert some types, merge attributes, props and do other stuff like that every time. For this reason we have decided to create `gccx`, a parser that allows us to write a new simple syntax. We will call this syntax `CPX`, it is based on [JSX](https://facebook.github.io/jsx/) but it has some differences. Basically `gccx` will transform this syntax into standard C++. In this way we can write files that appear very similar to HTML and can be written and read easily.
## Installation
You can install gccx using [npm](https://www.npmjs.com/package/gccx):
```bash
npm install --save-dev gccx
```or, if you prefer, you can install gccx globally with:
```bash
npm install -g gccx
```## Usage
Once you have installed gccx, you can use it from the command line or from javascript. Here is an example of both:
```bash
gccx src --output dist --watch
```supposing a CommonJS environment, you can import gccx in this way and immediately use it with no configuration.
```js
import gccx from 'gccx';const code = `
#include "../asm-dom/asm-dom.hpp"
#include
#includeusing namespace asmdom;
int main() {
VNode* vnode =Hello world!
;patch(
emscripten::val::global("document").call(
"getElementById",
std::string("root")
),
vnode
);return 0;
};
`;const compiled = gccx.parse(code); // compiled code as string
```## Documentation
Visit [docs](https://github.com/mbasso/gccx/blob/master/docs) folder to find the complete doc of gccx.
## Examples
Examples are available in the [examples folder](https://github.com/mbasso/gccx/blob/master/examples). You will find examples of both, cli and javascript api usage.
If you want to see a complete example that uses gccx, you can check out [here](https://github.com/mbasso/asm-dom/tree/master/examples/todomvc%20-%20cpx) the TODOMVC.
## Change Log
This project adheres to [Semantic Versioning](http://semver.org/).
Every release, along with the migration instructions, is documented on the Github [Releases](https://github.com/mbasso/gccx/releases) page.## Authors
**Matteo Basso**
- [github/mbasso](https://github.com/mbasso)
- [@teo_basso](https://twitter.com/teo_basso)## Copyright and License
Copyright (c) 2017, Matteo Basso.gccx source code is licensed under the [MIT License](https://github.com/mbasso/gccx/blob/master/LICENSE.md).