Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ultimatepp/upphub
UppHub is the repository that serves as the official global registry for U++ distributed packages. Each package provides additional functionality that can be used directly by the developers.
https://github.com/ultimatepp/upphub
cpp cpp17 distributed hub nest package ultimatepp upp upphub
Last synced: 2 months ago
JSON representation
UppHub is the repository that serves as the official global registry for U++ distributed packages. Each package provides additional functionality that can be used directly by the developers.
- Host: GitHub
- URL: https://github.com/ultimatepp/upphub
- Owner: ultimatepp
- License: bsd-2-clause
- Created: 2021-01-31T19:37:51.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-05T19:06:01.000Z (10 months ago)
- Last Synced: 2024-05-01T19:14:00.694Z (9 months ago)
- Topics: cpp, cpp17, distributed, hub, nest, package, ultimatepp, upp, upphub
- Homepage: https://www.ultimatepp.org/
- Size: 292 KB
- Stars: 8
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# UppHub
[![CircleCI](https://dl.circleci.com/status-badge/img/gh/ultimatepp/UppHub/tree/main.svg?style=shield)](https://dl.circleci.com/status-badge/redirect/gh/ultimatepp/UppHub/tree/main)
[![U++ Discord](https://img.shields.io/discord/1046445457951424612)](https://discord.gg/8XzqQzXZzb)This repository serves as the official global registry for [UppHub](https://www.ultimatepp.org/app$ide$UppHub_en-us.html), the distributed source packages management system for [U++](https://www.ultimatepp.org/index.html).
## Adding your project to this list
In order to register your package(s), please file an issue in this repository or contact maintainers of this list in any other way. You can also suggest the information that the UppHub will provide about your project, ideally as json entry (see bellow).
## The structure of the registry file
The UppHub global registry file, `nests.json`, is a simple JSON file containing the nests list. Each nest has several entries that need to be filled in.
| Key | Value |
|--- | -- |
| `name` | The name of the nest. |
| `packages` | The list of the package(s) in this nest. |
| `description` | A short description of the nest. |
| `repository` | The link to the nest's repository. |
| `branch` | The branch to be installed. (Not required).
| `status` | The status of the nest. See the notes for possible values. |
| `category` | The category of the nest: `networking`, `scientific`, `widget`, etc.|
| `readme` | A link to the `README` file. |#### Notes
- The `description` will be displayed on the UppHub package manager.
- The value of the `status` entry can be one of the following:
+ `experimental`: Package is not stable, i.e it is in development phase, subject to change and/or requires more testing.
+ `stable`: Package is mature, extensively tested and meant for daily use.
+ `rolling`: Package is mature, extensively tested and meant for daily use, but occasionally or frequently receives new features.
+ `deprecated`: Package is deprecated, has a better alternative, but required by older applications and/or packages.
+ `obsolete`: Package is obsolete. Provided as an archive item.
+ `broken`: Package is currenty broken and cannot be used.
- The value of `category` entry is *provisional, at the moment*.
- The `readme` file is optional. But it will certainly help you introduce your package to U++ users, as it can be displayed via the UppHub package manager. The format of the README file can be plain text, qtf or markdown.## Example nest
Let us assume that we wrote a nice little widget called `MessageCtrl`. and we want to register and publish it via UppHub. After forking this repository, we edit the `nests.json`file with our preferred editor, and append the following information to it.
```json
{
"name": "MessageCtrl",
"packages": [
"MessageCtrl"
],
"description": "A passive notifications widget for U++",
"repository": "https://github.com/ismail-yilmaz/MessageCtrl.git",
"status": "stable",
"category": "widget",
"readme": "https://raw.githubusercontent.com/ismail-yilmaz/MessageCtrl/main/README.md"
}
```
Once these changes are validated and merged, the package(s) will be visible and available for download via the UppHub package manager in our integrated development environment, [TheIDE](https://www.ultimatepp.org/app$ide$GettingStarted_en-us.html):![TheIDE - UppHub: displaying the registered MessageCtrl Package](Doc/Pictures/UppHub.png)