UppHub

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 12 Open GitHub ↗

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.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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)
[![License](https://img.shields.io/badge/License-BSD_2--Clause-orange.svg)](https://opensource.org/licenses/BSD-2-Clause)

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.

#### 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](https://raw.githubusercontent.com/ultimatepp/UppHub/main/Doc/Pictures/UppHub.png)

UppHub

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README