gamzinav/cling
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Cling - The Interactive C++ Interpreter
4,077 Commits 1 Branch 0 Tags 21 MiB
C++ 71.5%
C 16.4%
Python 5.6%
HTML 3.3%
CMake 2.7%
Other 0.5%
016eaa7620
Go to file
Raphael Isemann 016eaa7620 Prepone callback initialization in cling. 
We should setup our callbacks for ExternalASTSource/ExternalSemaSource
before we parse *any* code to prevent that any part of the code
stores a reference to a non-cling external sources. If this happens,
then the clang data structures such redecl chain could go out of
sync if they reference different sources and produce errors like failing
to merge declarations correctly or creating invalid redecl chains.

To fix this, we move this initalization before the initalization of
the incremental parser which is the first part that can generate
any AST nodes. We only do this for the modules case because in
the non-modules case the clang PCH overwrites our callback
in the ExternalASTSource and therefore would destroy our external
source.
2017-11-02 10:10:48 +01:00
cmake/modules fix Clang name in cmake file 2017-07-23 22:59:34 +02:00
demo Remove trailing spaces 2014-08-13 16:08:36 +02:00
docs Remove stray "$". 2017-09-12 15:00:15 +02:00
include/cling Simplify llvm::Module emission in the JIT. 2017-10-10 18:32:58 +02:00
lib Prepone callback initialization in cling. 2017-11-02 10:10:48 +01:00
patches Remove old file. 2016-07-22 20:54:47 +02:00
test Add test for "Also recognize templates as identifier." 2017-09-13 18:38:18 +02:00
tools Add support C++1z for Jupyter kernel 2017-09-06 16:44:07 +02:00
www Prepare for release v0.4. 2017-06-06 15:45:25 +02:00
.clang-format Intent cling namespace content. 2017-10-05 17:59:08 +02:00
.travis.yml Fix typo. 2017-07-16 13:59:17 +02:00
appveyor.yml Appveyor: Build with Ninja on Windows. 2017-03-09 08:29:28 +01:00
CMakeLists.txt Add comment for VS 2017 2017-08-29 15:21:36 +02:00
CREDITS.txt Add mail. 2016-08-18 15:44:19 +02:00
LastKnownGoodLLVMSVNRevision.txt Adapt to interface changes due to upgrade to r302975. 2017-06-08 10:29:13 +02:00
LICENSE.TXT Remove trailing spaces 2014-08-13 16:08:36 +02:00
Module.mk cling runtime does not depend on llvm headers anymore. 2017-06-14 15:14:37 +02:00
README.md Clarify where the root of cling is. 2017-05-20 23:59:42 +02:00
VERSION Start new development line. 2017-06-06 17:14:03 +02:00

README.md

Travis status

Cling - The Interactive C++ Interpreter

The main repository is at https://github.com/root-project/cling

Overview

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.

See also cling's web page.

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

Installation

Release Notes

See our release notes to find what's new.

Binaries

Our nightly binary snapshots can be found here.

Building from Source with 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. CPT requires Python 2.7 or later.

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/root-project/cling/master/tools/packaging/cpt.py
chmod +x cpt.py
./cpt.py --check-requirements && ./cpt.py --create-dev-env Debug --with-workdir=./cling-build/

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

Usage

./cling '#include <stdio.h>' 'printf("Hello World!\n")'

To get started run:

./cling --help

or type

./cling
[cling]$ .help

Jupyter

Cling comes with a Jupyter kernel. After building cling, install Jupyter and run jupyter kernelspec install cling. It requires a fairly new Jupyter. Make sure cling is in your PATH when you start jupyter!

See also the tools/Jupyter subdirectory for more information.

Developers' Corner

Cling's latest doxygen documentation

Contributions

Every contribution is considered 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 of the "Cling Project".

We warmly welcome external contributions to the Cling! By providing code, you agree to transfer your copyright on the code to the "Cling project". Of course you will be duly credited and your name will appear on the contributors page, the release notes, and in the CREDITS file shipped with every binary and source distribution. The copyright transfer is necessary for us to be able to effectively defend the project in case of litigation.

License

Please see our LICENSE.

Releases

Our release steps to follow when cutting a new release:

  1. Update release notes
  2. Remove ~dev suffix from VERSION
  3. Add a new entry in the news section of our website
  4. Commit the changes.
  5. git tag -a v0.x -m "Tagging release v0.x"
  6. Create a draft release in github and copy the contents of the release notes.
  7. Wait for green builds.
  8. Upload binaries to github (Travis should do this automatically).
  9. Publish the tag and announce it on the mailing list.
  10. Increment the current version and append ~dev.