cling

Cling - The Interactive C++ Interpreter

Go to file

Anirudha Bose 3b8577fc5f Auto-detect Clang version. Remove hard-coded Clang version in dist-files.mk		2014-10-04 11:47:04 +02:00
demo	Remove trailing spaces	2014-08-13 16:08:36 +02:00
docs	Make Python scripts Python3-compatible	2014-10-01 18:39:05 +02:00
include	We do not own our ExternalSemaSource, it is ref-owned by Sema and ASTContext.	2014-10-01 14:24:13 +02:00
lib	Remember failures from autoload directives: they are likely persistent.	2014-10-03 14:35:04 +02:00
patches	Use markdown	2014-02-27 12:49:09 +01:00
test	Mention current failure rate of Sema unloading tests.	2014-10-02 16:20:03 +02:00
tools	Auto-detect Clang version. Remove hard-coded Clang version in dist-files.mk	2014-10-04 11:47:04 +02:00
www	Remove trailing spaces	2014-08-13 16:08:36 +02:00
.travis.yml	BUILD_CLANG_ONLY=YES builds also libclang, we don't want this.	2014-09-30 11:30:19 +02:00
CMakeLists.txt	Re-introduce correct include directories search path when building standalone Cling on Windows	2014-10-02 12:40:04 +02:00
CREDITS.txt	Add credits.	2014-01-07 11:43:53 +01:00
LastKnownGoodLLVMSVNRevision.txt	Update to llvm/clang rev 214630.	2014-08-14 14:56:43 +02:00
LICENSE.TXT	Remove trailing spaces	2014-08-13 16:08:36 +02:00
Makefile	Fix wrong path of VERSION in Makefile	2014-05-15 13:51:55 +02:00
Module.mk	Do not display suggestions only for ROOT.	2014-09-19 14:05:15 +02:00
README.md	reference REPL is a way most people will recognize	2014-09-26 12:45:09 +02:00
VERSION	Use debian style version naming.	2014-05-11 18:27:58 +02:00

README.md

                         ______  __      ____  _   __  ______
                        / ____/ / /     /  _/ / | / / / ____/
                       / /     / /      / /  /  |/ / / / __
                      / /___  / /___  _/ /  / /|  / / /_/ /
                      \____/ /_____/ /___/ /_/ |_/  \____/

Linux:

##DESCRIPTION Cling is an interactive C++ interpreter, built on top of Clang and LLVM compiler infrastructure. Cling realizes the read-eval-print loop (REPL) concept, in order to leverage rapid application development. Implemented as a small extension to LLVM and Clang, the interpreter reuses their strengths such as the praised concise and expressive compiler diagnostics.

Further information & demos

Please note that some of the resources are rather old and most of the stated limitations are outdated.

##INSTALLATION ###Binaries We offer binary snapshots for download at https://ecsft.cern.ch/dist/cling

###Source CLING source depends on the LLVM and CLANG headers and libraries. You will also need CMake >= 2.6.1 or GNU Make to build all of those packages and subversion and git to get the source code.

####Building Building LLVM and CLANG you must:

Check out the sources:

    git clone http://root.cern.ch/git/llvm.git src
    cd src
    git checkout cling-patches
    cd tools
    git clone http://root.cern.ch/git/cling.git
    git clone http://root.cern.ch/git/clang.git
    cd clang
    git checkout cling-patches

Configure, build and install them, either using CMake:

    cd ..
    mkdir build
    cd build
    cmake -DCMAKE_INSTALL_PREFIX=/some/install/dir \
          -DLLVM_TARGETS_TO_BUILD=CBackend\;CppBackend\;X86 \
          -DCMAKE_BUILD_TYPE=Debug \
          ../src
    make
    make install

or GNU Make (see ../src/configure --help for all options):

    cd ..
    mkdir build
    cd build
    ../src/configure --prefix=/some/install/dir
    make
    make install

#####Cling Packaging Tool Cling's tree has a user-friendly, command-line utility written in Python called Cling Packaging Tool (CPT) which can build Cling from source and generate installer bundles for a wide range of platforms.

If you have Cling's source cloned locally, you can find the tool in tools/packaging directory. Alternatively, you can download the script manually, or by using wget:

wget https://raw.githubusercontent.com/vgvassilev/cling/master/tools/packaging/cpt.py
chmod +x cpt.py

Full documentation of CPT can be found in tools/packaging.

##USAGE /some/install/dir/bin/cling '#include <stdio.h>' 'printf("Hello World!\n")' To get started run: /some/install/dir/bin/cling --help or type /some/install/dir/bin/cling [cling]$ .help

##DEVELOPERS' CORNER: We have doxygen documentation of cling's code at: http://cling.web.cern.ch/cling/doxygen/ ###CONTRIBUTIONS Every contribution is very welcome. It is considered as a donation and its copyright and any other related rights become exclusive ownership of the person who merged the code or in any other case the main developers. In order for a contribution to be accepted it has to obey the previously established rules for contribution acceptance in cling's work flow and rules.