{"id":13418280,"url":"https://github.com/root-project/cling","last_synced_at":"2025-05-13T18:08:27.415Z","repository":{"id":37270275,"uuid":"49210203","full_name":"root-project/cling","owner":"root-project","description":"The cling C++ interpreter","archived":false,"fork":false,"pushed_at":"2025-03-07T15:14:11.000Z","size":19575,"stargazers_count":3856,"open_issues_count":132,"forks_count":292,"subscribers_count":97,"default_branch":"master","last_synced_at":"2025-05-10T01:02:44.668Z","etag":null,"topics":["c-plus-plus","clang","interpreter","jupyter","llvm"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/root-project.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.TXT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-01-07T14:45:35.000Z","updated_at":"2025-05-09T22:46:44.000Z","dependencies_parsed_at":"2023-02-19T02:15:53.708Z","dependency_job_id":"be64c112-f867-4beb-b7f4-24871b4b5a50","html_url":"https://github.com/root-project/cling","commit_stats":{"total_commits":5280,"total_committers":114,"mean_commits":46.31578947368421,"dds":0.7115530303030303,"last_synced_commit":"92e93ec122310827fef1032df1d05ef8e1b343f7"},"previous_names":["root-mirror/cling"],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/root-project%2Fcling","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/root-project%2Fcling/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/root-project%2Fcling/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/root-project%2Fcling/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/root-project","download_url":"https://codeload.github.com/root-project/cling/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254000849,"owners_count":21997441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c-plus-plus","clang","interpreter","jupyter","llvm"],"created_at":"2024-07-30T22:01:00.534Z","updated_at":"2025-05-13T18:08:27.386Z","avatar_url":"https://github.com/root-project.png","language":"C++","funding_links":[],"categories":["TODO scan for Android support in followings","C++","Starchart"],"sub_categories":[],"readme":"Cling - The Interactive C++ Interpreter\n=========================================\n\nThe main repository is at [https://github.com/root-project/cling](https://github.com/root-project/cling)\n\n\nOverview\n--------\nCling is an interactive C++ interpreter, built on top of Clang and LLVM compiler\ninfrastructure. Cling implements the [read-eval-print loop\n(REPL)](http://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop)\nconcept, in order to leverage rapid application development. Implemented as a\nsmall extension to LLVM and Clang, the interpreter reuses their strengths such\nas the praised concise and expressive compiler diagnostics.\n\nSee also [cling's web page.](https://rawcdn.githack.com/root-project/cling/d59d27ad61f2f3a78cd46e652cd9fb8adb893565/www/index.html)\n\nPlease note that some of the resources are rather old and most of the stated\nlimitations are outdated.\n  * [talks](www/docs/talks)\n  * http://blog.coldflake.com/posts/2012-08-09-On-the-fly-C++.html\n  * http://solarianprogrammer.com/2012/08/14/cling-cpp-11-interpreter/\n  * https://www.youtube.com/watch?v=f9Xfh8pv3Fs\n  * https://www.youtube.com/watch?v=BrjV1ZgYbbA\n  * https://www.youtube.com/watch?v=wZZdDhf2wDw\n  * https://www.youtube.com/watch?v=eoIuqLNvzFs\n\n\nInstallation\n------------\n### Release Notes\nSee our [release notes](docs/ReleaseNotes.md) to find what's new.\n\n\n### Binaries\nOur nightly binary snapshots are currently unavailable.\n\n\n### Building from Source\n\n```bash\ngit clone https://github.com/root-project/llvm-project.git\ncd llvm-project\ngit checkout cling-latest\ncd ..\ngit clone https://github.com/root-project/cling.git\nmkdir cling-build \u0026\u0026 cd cling-build\ncmake -DLLVM_EXTERNAL_PROJECTS=cling -DLLVM_EXTERNAL_CLING_SOURCE_DIR=../cling/ -DLLVM_ENABLE_PROJECTS=\"clang\" -DLLVM_TARGETS_TO_BUILD=\"host;NVPTX\" -DCMAKE_BUILD_TYPE=Release ../llvm-project/llvm\ncmake --build . --target cling\n```\n\nSee also the instructions [on the webpage](https://root.cern/cling/cling_build_instructions/).\n\nUsage\n-----\nAssuming we're in the build folder:\n```bash\n./bin/cling '#include \u003cstdio.h\u003e' 'printf(\"Hello World!\\n\")'\n```\n\nTo get started run:\n```bash\n./bin/cling --help\n```\nor\n```bash\n./bin/cling\n[cling]$ .help\n```\n\n\nJupyter\n-------\nCling comes with a [Jupyter](http://jupyter.org) kernel. After building cling,\ninstall Jupyter and cling's kernel by following the README.md in\n[tools/Jupyter](tools/Jupyter). Make sure cling is in your PATH when you start jupyter!\n\n\nCiting Cling\n------------\n```latex\n% Peer-Reviewed Publication\n%\n% 19th International Conference on Computing in High Energy and Nuclear Physics (CHEP)\n% 21-25 May, 2012, New York, USA\n%\n@inproceedings{Cling,\n  author = {Vassilev,V. and Canal,Ph. and Naumann,A. and Moneta,L. and Russo,P.},\n  title = {{Cling} -- The New Interactive Interpreter for {ROOT} 6}},\n  journal = {Journal of Physics: Conference Series},\n  year = 2012,\n  month = {dec},\n  volume = {396},\n  number = {5},\n  pages = {052071},\n  doi = {10.1088/1742-6596/396/5/052071},\n  url = {https://iopscience.iop.org/article/10.1088/1742-6596/396/5/052071/pdf},\n  publisher = {{IOP} Publishing}\n}\n```\n\nDevelopers' Corner\n==================\n[Cling's latest doxygen documentation](http://cling.web.cern.ch/cling/doxygen/)\n\n\nContributions\n-------------\nEvery contribution is considered a donation and its copyright and any other\nrelated rights become exclusive ownership of the person who merged the code or\nin any other case the main developers of the \"Cling Project\".\n\nWe warmly welcome external contributions to the Cling! By providing code,\nyou agree to transfer your copyright on the code to the \"Cling project\".\nOf course you will be duly credited and your name will appear on the\ncontributors page, the release notes, and in the [CREDITS file](CREDITS.txt)\nshipped with every binary and source distribution. The copyright transfer is\nnecessary for us to be able to effectively defend the project in case of\nlitigation.\n\n\nLicense\n-------\nPlease see our [LICENSE](LICENSE.TXT).\n\n\nReleases\n--------\nOur release steps to follow when cutting a new release:\n  1. Update [release notes](docs/ReleaseNotes.md)\n  2. Remove `~dev` suffix from [VERSION](VERSION)\n  3. Add a new entry in the news section of our [website](www/news.html)\n  4. Commit the changes.\n  5. `git tag -a v0.x -m \"Tagging release v0.x\"`\n  6. Tag `cling-patches` of `clang.git`:\n     `git tag -a cling-v0.x -m \"Tagging clang for cling v0.x\"`\n  7. Create a draft release in github and copy the contents of the release notes.\n  8. Wait for green builds.\n  9. Upload binaries to github (Travis should do this automatically).\n  10. Publish the tag and announce it on the mailing list.\n  11. Increment the current version and append `~dev`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froot-project%2Fcling","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froot-project%2Fcling","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froot-project%2Fcling/lists"}