{"id":22555480,"url":"https://github.com/eclipse-cdt-cloud/clangd-contexts","last_synced_at":"2025-04-10T05:20:54.793Z","repository":{"id":43823265,"uuid":"457865553","full_name":"eclipse-cdt-cloud/clangd-contexts","owner":"eclipse-cdt-cloud","description":"API for management of clangd configuration files in C/C++ projects using contexts.","archived":false,"fork":false,"pushed_at":"2023-02-16T08:13:24.000Z","size":696,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-24T06:45:18.435Z","etag":null,"topics":["clangd","cpp","theia","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eclipse-cdt-cloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-10T16:48:16.000Z","updated_at":"2024-04-20T11:22:41.000Z","dependencies_parsed_at":"2022-09-09T18:24:33.368Z","dependency_job_id":null,"html_url":"https://github.com/eclipse-cdt-cloud/clangd-contexts","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fclangd-contexts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fclangd-contexts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fclangd-contexts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fclangd-contexts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eclipse-cdt-cloud","download_url":"https://codeload.github.com/eclipse-cdt-cloud/clangd-contexts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248161505,"owners_count":21057603,"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":["clangd","cpp","theia","vscode-extension"],"created_at":"2024-12-07T19:07:59.662Z","updated_at":"2025-04-10T05:20:54.770Z","avatar_url":"https://github.com/eclipse-cdt-cloud.png","language":"TypeScript","readme":"# ECLIPSE CDT.CLOUD - CLANGD CONTEXTS\n\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-curved)](https://github.com/eclipse-cdt-cloud/clangd-contexts/labels/help%20wanted)\n[![Open questions](https://img.shields.io/badge/Open-questions-blue.svg?style=flat-curved)](https://github.com/eclipse-cdt-cloud/clangd-contexts/labels/question)\n[![Open bugs](https://img.shields.io/badge/Open-bugs-red.svg?style=flat-curved)](https://github.com/eclipse-cdt-cloud/clangd-contexts/labels/bug)\n[![CI](https://github.com/eclipse-cdt-cloud/clangd-contexts/actions/workflows/ci.yml/badge.svg)](https://github.com/eclipse-cdt-cloud/clangd-contexts/actions/workflows/ci.yml)\n\n## Overview\n\nAn API for management of [clangd](https://clangd.llvm.org) configuration files in C/C++ projects using _contexts_.\n\n## Features\n\n- `@eclipse-cdt-cloud/clangd-contexts`:\n    - Library for management of [clangd][clangd] configuration files\n    - Retrieve and set contexts in one or more `.clangd` files\n    - Manage compile flags in `.clangd` files\n    - See the [package readme][cclib] for further details.\n- `@eclipse-cdt-cloud/clangd-contexts-cli`\n    - An example command-line tool (`clangd-context`) built on the `@eclipse-cdt-cloud/clangd-contexts` API for management of [clangd][clangd] configuration files in C/C++ projects.\n    - See the [package readme][cccli] for details, including a step-by-step guide to the CLI.\n- `theia-clangd-contexts-ext`\n    - An example VS Code extension demonstrating use of the `@eclipse-cdt-cloud/clangd-contexts` API.\n    - See the [package readme][ccvsx] for details, including a step-by-step guide to the extension UI.\n\n[cclib]: ./packages/clangd-contexts/README.md\n[cccli]: ./examples/clangd-contexts-cli/README.md\n[ccvsx]: ./examples/clangd-contexts-ext/README.md\n[clangd]: https://clangd.llvm.org\n\n## How to build\n\n### Packages and Examples\n\nTo build the monorepo:\n\n```bash\nyarn\n```\n\nAdditionally, to make the `clangd-context` example CLI tool available in your C/C++ projects\n(such as the [clangd workspace](#example-workspaces) example):\n\n```bash\ncd examples/clangd-contexts-cli\nyarn link\n```\n\n\u003e **Note** that on some Linux installations you may need to ensure that Yarn's global bin directory is in your shell path:\n\n```bash\nexport PATH=$(yarn global bin):$PATH\n```\n\n### Example Theia Deployments\n\nThe `browser-app` and `electron-app` directories contain examples of Theia-based applications which use the extensions provided by the repository.\n\n- `browser-app` build instructions:\n\n    ```bash\n    yarn\n    yarn start:browser\n    ```\n\n- `electron-app` build instructions:\n\n    ```bash\n    yarn\n    yarn start:electron\n    ```\n\n## Example Packages\n\n- [`clangd-contexts-cli`][cccli]\n    - provides a command-line tool that demonstrates usage of the clangd contexts API\n- [`clangd-contexts-ext`][ccvsx]\n    - an example VS Code extension that demonstrates usage of the clangd contexts API\n\n## Example Workspaces\n\n- [`clangd-workspace`][ccws]\n    - provides a test playground for the `clangd-context` example CLI tool and the API, including the separate [VS Code extension example](./examples/clangd-contexts-ext/README.md)\n\n[ccws]: ./examples/clangd-workspace/README.md\n\n## License\n\n- [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)\n- [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-cdt-cloud%2Fclangd-contexts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feclipse-cdt-cloud%2Fclangd-contexts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-cdt-cloud%2Fclangd-contexts/lists"}