https://github.com/pure-c/purec

C backend for PureScript
https://github.com/pure-c/purec

backends c clang functional-programming native programming-language purescript

Last synced: 2 months ago
JSON representation

C backend for PureScript

• Host: GitHub
• URL: https://github.com/pure-c/purec
• Owner: pure-c
• Created: 2018-08-09T01:41:36.000Z (over 6 years ago)
• Default Branch: next
• Last Pushed: 2021-02-27T00:31:11.000Z (almost 4 years ago)
• Last Synced: 2024-08-02T13:34:09.284Z (6 months ago)
• Topics: backends, c, clang, functional-programming, native, programming-language, purescript
• Language: PureScript
• Homepage:
• Size: 854 KB
• Stars: 231
• Watchers: 15
• Forks: 8
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: licenses/BSD-MIT

Awesome Lists containing this project

README

        
# Pure-C

An alternative backend for the PureScript programming language that targets C.

## Introduction

PureScript is a high-level, statically typed, functionally pure programming

language that enables various backends using its intermediate representation of

elaborated programs.

PureC provides a backend that transpiles to the C programming language, thus

enabling native, ahead-of-time compilation of PureScript programs. With a dead

simple FFI to C, performance critical sections can easily be implemented outside

of PureScript when the need arises.

For an example of how PureC could be used, take a look at

[purec-uv](https://github.com/pure-c/purec-uv), a project implementing both

purescript-aff and bindings to libuv on top of PureC.

## Features

* Write native programs in PureScript

* Simple FFI to C

* Generates readable, human- and machine-debuggable C

* Simple and efficient reference counted GC

* Opt-in tracing GC (Boehm–Demers–Weiser garbage collector)

## Usecases

* Scrap your node.js

* Write small, easy to distribute command line utilities

* No JS parsing, instant start up times, native performance

## Development

These instructions will get you a copy of the project up and running on your

local machine for development and testing purposes.

For now, the default makefiles use the clang compiler toolchain. So either

install clang (if not installed already), or open a PR adding support for other

compilers.

### Prerequisites

PureC is written in PureScript and currently not self-hoisting; A full node.js

runtime is required. With node.js installed (any recent version will work)

install the node.js dependencies to build purec.js: `npm install`.

Additionally, we require

* make

* libcmocka-dev

* valgrind

## Build the purec utility

Run `npm run build` to build the purec.js utility.

## Running the tests

```

npm t

```

## Contributing

Please read [CONTRIBUTING.md](#) for details on our code of

conduct, and the process for submitting pull requests to us.

## Versioning

This project is alpha quality and will likely remain alpha quality for a while.

That means for now there's one version, and that's `origin/HEAD`.

## Authors

* **Felix Schlitter** - *Initial work* - [felixschl](https://github.com/felixschl)

See also the list of [contributors](https://github.com/pure-c/pure-c/contributors) who participated in this project.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details

## Acknowledgments

* [uthash](https://github.com/troydhanson/uthash) - A hash table for C structures

* [vec](https://github.com/rxi/vec) - A type-safe dynamic array implementation for C

* [ccan](https://github.com/rustyrussell/ccan) - The C Code Archive Network

* [purescript-native](https://github.com/andyarvanitis/purescript-native) - An experimental C++11/native compiler backend for PureScript