Carp

WARNING! This is a research project and a lot of information here might become outdated and misleading without any explanation. Don't use it for anything important!

Update (June 26, 2017): The total rewrite is now live; if you want to look at the old version, it's under the branch named "c" in this repository.

About

Carp is a small programming language designed to work well for interactive and performance sensitive use cases like games, sound synthesis and visualizations.

The key features of Carp are the following:

• Automatic and deterministic memory management (no garbage collector or VM)
• Inferred static types for great speed and reliability
• Ownership tracking enables a functional programming style while still using mutation of cache-friendly data structures under the hood
• No hidden performance penalties – allocation and copying are explicit
• Straightforward integration with existing C code

Learn more

• Installation - how to build and configure the Carp compiler
• The Compiler Manual - how to compile code and configure your projects
• Carp Language Guide - syntax and semantics of the language
• Libraries - how to work with libraries and modules
• Tooling - supported editors
• Game Example - an example of how to use SDL with Carp

The Carp REPL has built-in documentation, run (help) to access it!

A Small Example

(use IO)
(use Int)
(use String)

(defn main []
  (do (println "~ The number guessing game ~")
      (print "Please enter a number between 1 - 99: ")
      (let [play true
            answer (random-between 1 100)]
        (while play
          (let [guess (get-line)
                num (from-string &guess)]
            (if (= &guess "q\n")
              (do
                (println "Good bye...")
                (set! play false))
              (do
                (cond (< num answer) (println "Too low.")
                      (> num answer) (println "Too high.")
                      (println "Correct!"))
                (print "Please guess again: "))))))))

To build this example, save it to a file called 'example.carp' and load it with (load "example.carp"), then execute (build) to build an executable, and (run) to start.

Language Designer & Lead Developer

Erik Svedäng (@e_svedang)

Core Contributor

Veit Heller (@hellerve)

Contributors

• Markus Gustavsson
• Fyodor Shchukin
• Anes Lihovac
• Chris Hall
• Tom Smeding
• Dan Connolly
• Reini Urban
• Jonas Granquist

Are you missing from the contributors list? Please send a pull request!

License

Copyright 2016 - 2018 Erik Svedäng

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

The regular expression implementation as found in src/carp_regex.h are Copyright (C) 1994-2017 Lua.org, PUC-Rio under the terms of the MIT license. Details can be found in the License file LUA_LICENSE.