Fcalva/cyclone
1
0
Fork 0
mirror of https://github.com/justinethier/cyclone.git synced 2025-05-19 05:39:17 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
🌀 A brand-new compiler that allows practical application development using R7RS Scheme. We provide modern features and a stable system capable of generating fast native binaries.
1557 commits 73 branches 81 tags 26 MiB
Scheme 59.8%
C 39.8%
Makefile 0.3%
Shell 0.1%
Find a file
Justin Ethier c5a69112ba New files
2016-02-17 03:16:52 -05:00
debug Added (record?) 2016-02-06 03:19:36 -05:00
docs New files 2016-02-17 03:16:52 -05:00
examples Relocated 2016-02-05 22:55:16 -05:00
include/cyclone Relocated mutex primitives to srfi 18 lib 2016-02-16 23:51:28 -05:00
scheme Relocated mutex primitives to srfi 18 lib 2016-02-16 23:51:28 -05:00
srfi Integrate cond-variable wait with mutex-unlock! 2016-02-17 02:59:19 -05:00
test-lib New test file 2015-08-14 01:48:14 -04:00
tests Added lazy library 2016-02-11 22:18:51 -05:00
.gitignore Initial file 2015-02-21 22:25:06 -05:00
AUTHORS initial file 2016-02-11 22:54:41 -05:00
cyclone.scm Added header comment block. 2016-02-14 22:35:04 -05:00
gc.c Fixes to cond_var 2016-02-16 02:46:23 -05:00
generate-c.scm Added header comment block. 2016-02-14 22:35:04 -05:00
icyc.scm Added header comment block. 2016-02-14 22:35:04 -05:00
LICENSE Updated year 2015-07-22 21:30:15 -04:00
macro-testing.scm Stubs for parameter objects 2016-02-13 22:58:12 -05:00
Makefile new library 2016-02-13 22:36:49 -05:00
Makefile.config Use separate configs for X86 / ARM (pi 2) 2015-12-29 23:14:09 -05:00
Makefile.config.raspberry-pi-2 Use separate configs for X86 / ARM (pi 2) 2015-12-29 23:14:09 -05:00
README.md Link to GC paper 2016-01-29 23:09:26 -05:00
runtime.c Relocated mutex primitives to srfi 18 lib 2016-02-16 23:51:28 -05:00
sync.sh Initial file 2016-01-30 22:35:20 -05:00
TODO WIP 2016-02-13 02:41:07 -05:00

README.md

cyclone-scheme

Cyclone is an experimental Scheme-to-C compiler that uses a variant of the Cheney on the MTA technique to implement full tail recursion, continuations, and generational garbage collection. Unlike previous Cheney on the MTA compilers, Cyclone also allows execution of multiple native threads. A tracing garbage collector is used to manage the second-generation heap and perform major collections without "stopping the world".

Getting Started

  1. To install Cyclone on your machine for the first time use cyclone-bootstrap to build a set of binaries.

  2. After installing you can run the cyclone command to compile a single Scheme file:

     $ cyclone examples/fac.scm
 $ examples/fac
 3628800

    And the icyc command to start an interactive interpreter:

     $ icyc

               :@
             @@@
           @@@@:
         `@@@@@+
        .@@@+@@@      Cyclone
        @@     @@     An experimental Scheme compiler
       ,@             https://github.com/justinethier/cyclone
       '@
       .@
        @@     #@     (c) 2014 Justin Ethier
        `@@@#@@@.     Version 0.0.1 (Pre-release)
         #@@@@@
         +@@@+
         @@#
       `@.

 cyclone> (write 'hello-world)
 hello-world

    You can use rlwrap to make the interpreter more friendly, EG: rlwrap icyc.

  3. Read the documentation below for more information on how to use Cyclone.

Documentation

The User Manual covers in detail how to use Cyclone, and provides information and API documentation on the Scheme language features implemented by Cyclone.

Writing the Cyclone Scheme Compiler provides high-level details on how the compiler was written and how it works.

Cyclone's Garbage Collector is documented at a high-level. This document includes details on extending Cheney on the MTA to support multiple stacks and fusing that approach with a tri-color marking collector.

Finally, if you need another resource to start learning the Scheme language please try a classic textbook such as Structure and Interpretation of Computer Programs.

License

Copyright (C) 2014 Justin Ethier.

Cyclone is available under the MIT license.