/purec

C backend for PureScript
purescript c clang native functional-programming gcc
  1. PureScript 78.1%
  2. C 18.4%
  3. Makefile 2.2%
  4. Other 1.3%
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Felix Schlitter
Felix Schlitter Ensure dependencies are installed for examples 
Refer #56
Latest commit 7cac5ea Nov 28, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
ccan Add CCAN asprintf module Aug 14, 2018
examples Ensure dependencies are installed for examples Nov 28, 2018
licenses Add CCAN asprintf module Aug 14, 2018
mk Add level of indirection to generated targets Nov 28, 2018
runtime Add more record related functions for purescript-record Nov 16, 2018
scripts Add more completed deps to depgraph script Oct 4, 2018
src Change to '_$' suffix for all identifiers Nov 11, 2018
test Update tests to use psc-package Nov 27, 2018
upstream/tests Update tests to use psc-package Nov 27, 2018
vendor Get example2 running Oct 1, 2018
.gitignore Ignore .psc-package directories Nov 27, 2018
.travis.yml Fix running tests on travis Oct 23, 2018
Makefile Fix top-level 'make clean' to only consider files for .o and .out Nov 27, 2018
README.md Add introduction/features/usecases section to README Nov 11, 2018
bower.json Run AST traversals and the AST eq function through Trampoline Oct 17, 2018
config.h Add CCAN and managed UTF8 strings Aug 14, 2018
package.json Add stack unsafe `AST.everywhere` function Sep 25, 2018

README.md

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 pure-c, a project implementing both purescript-aff and bindings to libuv on top of PureC.

Features

  • Write programs in PureScript
  • Simple FFI to C
  • Generates readable, human- and machine-debuggable C
  • Garbage collected (Boehm)

Usecases

  • Scrap your node.js
  • Write small, easy to distribute command line utilities

Getting Started

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

  • Install node.js, including npm
make deps

Build the purec utility

make purec

Running the examples

Each example is an isolated example of how to use purec. You can cd into each of these directories and invoke make.

To build all examples:

make examples

To run a particular example:

# ./examples/<name>/main.out
# example:
./examples/example1/main.out

Running the tests

make test

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

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

  • uthash - A hash table for C structures
  • vec - A type-safe dynamic array implementation for C
  • ccan - The C Code Archive Network
  • purescript-native - An experimental C++11/native compiler backend for PureScript