Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/vgvassilev/cling

The interactive C++ interpreter Cling
https://github.com/vgvassilev/cling

Last synced: 23 days ago
JSON representation

The interactive C++ interpreter Cling

Lists

README 

        
Cling - The Interactive C++ Interpreter

=========================================



The main repository is at [https://github.com/root-project/cling](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)](http://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop)

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.](https://rawcdn.githack.com/root-project/cling/d59d27ad61f2f3a78cd46e652cd9fb8adb893565/www/index.html)



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

limitations are outdated.

  * [talks](www/docs/talks)

  * http://blog.coldflake.com/posts/2012-08-09-On-the-fly-C++.html

  * http://solarianprogrammer.com/2012/08/14/cling-cpp-11-interpreter/

  * https://www.youtube.com/watch?v=f9Xfh8pv3Fs

  * https://www.youtube.com/watch?v=BrjV1ZgYbbA

  * https://www.youtube.com/watch?v=wZZdDhf2wDw

  * https://www.youtube.com/watch?v=eoIuqLNvzFs



Installation

------------

### Release Notes

See our [release notes](docs/ReleaseNotes.md) to find what's new.



### Binaries

Our nightly binary snapshots can be found

[here](https://root.cern.ch/download/cling/).



### Building from Source



```sh

git clone https://github.com/root-project/llvm-project.git

cd llvm-project

git checkout cling-latest

cd ../

git clone 

mkdir cling-build && cd cling-build

cmake -DLLVM_EXTERNAL_PROJECTS=cling -DLLVM_EXTERNAL_CLING_SOURCE_DIR=../cling/ -DLLVM_ENABLE_PROJECTS="clang" -DLLVM_TARGETS_TO_BUILD="host;nvptx" ../llvm-project/llvm

```



Usage

-----

```c++

./cling '#include ' 'printf("Hello World!\n")'

```



To get started run:

```bash

./cling --help

```

or type

```

./cling

[cling]$ .help

```



Jupyter

-------

Cling comes with a [Jupyter](http://jupyter.org) kernel. After building cling,

install Jupyter and cling's kernel by following the README.md in

[tools/Jupyter](tools/Jupyter). Make sure cling is in your PATH when you start jupyter!



Citing Cling

------------

```latex

% Peer-Reviewed Publication

%

% 19th International Conference on Computing in High Energy and Nuclear Physics (CHEP)

% 21-25 May, 2012, New York, USA

%

@inproceedings{Cling,

  author = {Vassilev,V. and Canal,Ph. and Naumann,A. and Moneta,L. and Russo,P.},

  title = {{Cling} -- The New Interactive Interpreter for {ROOT} 6}},

  journal = {Journal of Physics: Conference Series},

  year = 2012,

  month = {dec},

  volume = {396},

  number = {5},

  pages = {052071},

  doi = {10.1088/1742-6596/396/5/052071},

  url = {https://iopscience.iop.org/article/10.1088/1742-6596/396/5/052071/pdf},

  publisher = {{IOP} Publishing}

}

```



Developers' Corner

==================

[Cling's latest doxygen documentation](http://cling.web.cern.ch/cling/doxygen/)



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](CREDITS.txt)

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](LICENSE.TXT).



Releases

--------

Our release steps to follow when cutting a new release:

  1. Update [release notes](docs/ReleaseNotes.md)

  2. Remove `~dev` suffix from [VERSION](VERSION)

  3. Add a new entry in the news section of our [website](www/news.html)

  4. Commit the changes.

  5. `git tag -a v0.x -m "Tagging release v0.x"`

  6. Tag `cling-patches` of `clang.git`:

     `git tag -a cling-v0.x -m "Tagging clang for cling v0.x"`

  7. Create a draft release in github and copy the contents of the release notes.

  8. Wait for green builds.

  9. Upload binaries to github (Travis should do this automatically).

  10. Publish the tag and announce it on the mailing list.

  11. Increment the current version and append `~dev`.