{"id":13799114,"url":"https://github.com/Fylhan/qompoter","last_synced_at":"2025-05-13T06:32:15.925Z","repository":{"id":20387828,"uuid":"23663571","full_name":"Fylhan/qompoter","owner":"Fylhan","description":"Dependency manager for Qt / C++.","archived":false,"fork":false,"pushed_at":"2024-03-28T14:56:53.000Z","size":1020,"stargazers_count":24,"open_issues_count":5,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-07T16:53:20.399Z","etag":null,"topics":["cplusplus","dependency-manager","multi-platform","package-manager","qmake","qompoter","qt"],"latest_commit_sha":null,"homepage":"https://fylhan.github.io/qompoter/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Fylhan.png","metadata":{"files":{"readme":"README.md","changelog":"changelogs.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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}},"created_at":"2014-09-04T13:33:04.000Z","updated_at":"2024-07-30T13:02:35.000Z","dependencies_parsed_at":"2024-01-05T20:49:14.163Z","dependency_job_id":"4be50754-a4b4-4d29-86bc-4cb827a00831","html_url":"https://github.com/Fylhan/qompoter","commit_stats":{"total_commits":185,"total_committers":7,"mean_commits":"26.428571428571427","dds":0.3513513513513513,"last_synced_commit":"49a7e2dab17bc2c4a78bf2013f424e64fa202526"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fylhan%2Fqompoter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fylhan%2Fqompoter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fylhan%2Fqompoter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fylhan%2Fqompoter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Fylhan","download_url":"https://codeload.github.com/Fylhan/qompoter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224784866,"owners_count":17369466,"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":["cplusplus","dependency-manager","multi-platform","package-manager","qmake","qompoter","qt"],"created_at":"2024-08-04T00:00:58.978Z","updated_at":"2024-11-18T13:31:53.866Z","avatar_url":"https://github.com/Fylhan.png","language":"Shell","funding_links":[],"categories":["Tools"],"sub_categories":["Third-Party Tools"],"readme":"Qompoter\n================================\n\nAn attempt of dependency manager for Qt / C++, because I am sick of managing each C++ piece of code separately!\n\n[![Build Status](https://travis-ci.org/Fylhan/qompoter.svg?branch=master)](https://travis-ci.org/Fylhan/qompoter)\n\nThe current version is still a work in progress but is fully usable for simple and complex projects!\n\nCheck the [FAQ](docs/FAQ.md) to understand \"Why Qompoter?\", but here is what **Qompoter is good for**:\n\n* easily share the required source dependencies of your Qt / C++ project with a team\n  * describe them in a \"qompoter.json\" file\n  * let Qompoter search and download them for you into a \"vendor\" directory\n* share C++ code to the [inqlude](https://inqlude.org/) repository, a development forge (like Github) or any [local or remote Qompotist-fs repository](docs/Repositories.md)\n* ease the repetability of the build thanks to the lock file\n* work with several platforms (Linux, Windows, Mac, ...)\n* keep it simple\n\nQompoter is also useful to share *library* (or binary) dependencies of you Qt / C++ project. However, keep in mind this is not that simple, this requires precompiling these dependencies somewhere for all your required targets (x86, x86_64, ARM, ...).\n\nInstallation\n-------------\n\n### Requirements\n\nQompoter requires Bash, Git, sed. Other tools like rsync, curl (or wget) and tar (or zip) may be useful for some advanced cases.\n\nIt works on Linux, including Busibox Linux based system like Alpine, and Windows (using [Git bash](https://git-scm.com/)).\n\nIt also works on MacOS, but requires additional packages to be installed with Homebrew (https://brew.sh/): `brew install gnu-sed \u0026\u0026 brew install coreutils`, then make sure to add these to your path, in order to use GNU sed and GNU date instead of the MacOS version:\n\n```\nPATH=/usr/local/opt/coreutils/libexec/gnubin:$PATH\nPATH=/usr/local/opt/gnu-sed/libexec/gnubin:$PATH\n```\n\nIt should also work on FreeBSD and more widely on Windows (Cygwin or Mysys command line) because it is Bash based, but I did not test it yet.\n\n### Using [npm](https://www.npmjs.com/)\n\n```bash\n$ npm install -g qompoter\n$ qompoter --version\nQompoter v0.6.0\nLight dependency manager for C++/Qt by Fylhan\n```\n\n### From scratch\n\nDownload it from Github and move it to a place accessible in the `PATH`:\n\n```bash\n$ wget https://github.com/Fylhan/qompoter/releases/download/v0.6.0/qompoter.sh -O qompoter.sh \u0026\u0026 sudo mv qompoter.sh /usr/bin/qompoter\n$ qompoter --version\nQompoter v0.6.0\nLight dependency manager for C++/Qt by Fylhan\n```\n\nThe MD5 sum of qompoter.sh v0.5.1 version is `6975405fd3b5cda0164765c870dedcb6`.\n\nThe SHA512 sum of qompoter.sh v0.5.1 version is `76009f6225ca9137c5ed298ffb4f3138007dd4fe3c6d3beed98499b179316ae7d62dde22d6f9601ec7cb4e9a72928f2a755288d8f87f8e9a70cda398b9f0c724`.\n\nTo enable autocompletion, download the script and source it in your `~/.bashrc` file:\n\n```bash\nwget https://github.com/Fylhan/qompoter/releases/download/v0.5.1/qompoter_bash_completion.sh -O qompoter_bash_completion.sh \u0026\u0026 sudo mv qompoter_bash_completion.sh /usr/share/bash-completion/completions/qompoter\necho \"test [ -f /usr/share/bash-completion/completions/qompoter ]; source /usr/share/bash-completion/completions/qompoter\" \u003e\u003e ~/.bashrc\n```\n\n### Using Debian package (beta)\n\nA Debian package can be generated using the script available in `resources/create-deb-package.sh`. Please share feedback!\n\nGetting Started\n-------------\n\nIn your project, create a qompoter.json file:\n\n```json\n{\n    \"name\": \"george/return-of-the-jedi\",\n    \"description\": \"Three things remains: faith, hope and love.\",\n    \"keywords\": [\"Jedi\", \"Force\", \"Faith\", \"Hope\", \"Love\"],\n    \"authors\": [\n        {\n            \"name\": \"George Lucas\",\n            \"homepage\": \"https://starwars.com\"\n        }\n    ],\n    \"require\": {\n        \"young/luke\": \"v0.2.1-beta\",\n        \"young/leia\": \"v0.5.*\",\n        \"old/yoda\": \"dev-master\"\n    },\n    \"require-dev\": {\n        \"milenium-falcon/han\": \"v1.0\"\n    },\n    \"repositories\": {\n        \"old/yoda\" : \"https://github.com\"\n    }\n}\n```\n\nThen, download and install dependencies listed in your `qompoter.json` using:\n\n```bash\nqompoter update\n```\n\n*For more information about the command line options, use `qompoter --help` or check the [online help](docs/Command-line.md).*\n\nThat's it! Qompoter has downloaded all required dependencies into the `vendor` directory and you can now include `vendor.pri` in the `.pro` file of your project, and use the dependencies that you required:\n\n```qmake\nCONFIG += luke leia yoda han\ninclude(vendor/vendor.pri)\n```\n\nLet's start coding!\n\nDuring development, if you want to change / upgrade the version of an existing package, add or remove packages: update the `qompoter.json` file accordingly and run again `qompoter update`.\n\nIf you reached a milestone of your project and wanted to provide a backup of your project's dependencies, run `qompoter export` to create an archive file of the `vendor` directory, or `qompoter export --repo \u003cpath to a directory\u003e` to create a Qompotist-fs repository on which you can run `qompoter update`. You may want to use `qompoter inspect` before to check you did not modified manually any packages in the `vendor` directory.\n\nImportant change between Qompoter 0.4 and 0.5\n-------------\n\nThe `qompoter update` has been introduced and is identical to the \u003c0.4 `qompoter install` action: take the `qompoter.json`, download dependencies and generate a `qompoter.lock` file listing the downloaded versions.\n\nThe `qompoter install` action has been modified as follow: take the `qompoter.lock` and download dependencies. This allows to download the same version used by the last `qompoter update` without computing again the potential variadic version numbers. \n\nDocumentation\n-------------\n\n[Documentation is available online](https://fylhan.github.io/qompoter/) and in the `gh-pages` branch inside the `docs` directory.\n\n* [Concept of packages](https://github.com/Fylhan/qompoter/blob/gh-pages/docs/Packages.md)\n* [Concept of repositories](https://github.com/Fylhan/qompoter/blob/gh-pages/docs/Repositories.md)\n* [Concept of package's versions](https://github.com/Fylhan/qompoter/blob/gh-pages/docs/Qompoter-json-file.md#require)\n* [How to create a Qompoter.json file?](https://github.com/Fylhan/qompoter/blob/gh-pages/docs/Qompoter-json-file.md)\n* [How to create a Qompoter.pri file?](dhttps://github.com/Fylhan/qompoter/blob/gh-pages/ocs/Qompoter-pri-file.md)\n* [What is this qompote.pri file?](https://github.com/Fylhan/qompoter/blob/gh-pages/docs/Home-made-qompote.md)\n* [Command line interface](https://github.com/Fylhan/qompoter/blob/gh-pages/docs/Command-line.md)\n* [Contribution guide](CONTRIBUTING.md)\n* [LICENSE](LICENSE)\n* [FAQ](https://github.com/Fylhan/qompoter/blob/gh-pages/docs/FAQ.md)\n\nThere is a previsional [roadmap](https://github.com/Fylhan/qompoter/blob/gh-pages/docs/ROADMAP.md).\n\nLicense\n-------------\n\n* Qompoter is distributed under the [LGPL3+](LICENSE) license. *Therefore, you can freely use it in any projects, even closed ones. Just keep in mind that if you modify Qompoter, you shall provide these updates as open source. Thanks!*\n* Qompoter is using [JSON.sh](https://github.com/dominictarr/JSON.sh) under the MIT and Apache 2 license. Qompoter unit tests are also based on the JSON.sh architecture.\n\nPlease feel free to contribute.\n\nIf you have any ideas, critics, suggestions or whatever you want to call it, please open an issue. I will be happy to hear from you what you would like to see in this tool. I think about all suggestions, and I try to add those that make sense.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFylhan%2Fqompoter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFylhan%2Fqompoter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFylhan%2Fqompoter/lists"}