mirror of
https://github.com/simonbrunel/qtpromise.git
synced 2024-11-25 04:05:49 +08:00
Add qpm package.json and docs
This commit is contained in:
parent
5e754d1b08
commit
cba11e6341
13
README.md
13
README.md
@ -1,7 +1,7 @@
|
|||||||
<a href="https://promisesaplus.com/" title="Promises/A+ 1.1"><img src="http://promisesaplus.com/assets/logo-small.png" alt="Promises/A+" align="right"/></a>
|
<a href="https://promisesaplus.com/" title="Promises/A+ 1.1"><img src="http://promisesaplus.com/assets/logo-small.png" alt="Promises/A+" align="right"/></a>
|
||||||
|
|
||||||
# QtPromise
|
# QtPromise
|
||||||
[![Travis](https://img.shields.io/travis/simonbrunel/qtpromise.svg?style=flat-square)](https://travis-ci.org/simonbrunel/qtpromise) [![coverage](https://img.shields.io/codecov/c/github/simonbrunel/qtpromise.svg?style=flat-square)](https://codecov.io/gh/simonbrunel/qtpromise)
|
[![qpm](https://img.shields.io/github/release/simonbrunel/qtpromise.svg?style=flat-square&label=qpm&colorB=4CAF50)](http://www.qpm.io/packages/com.github.simonbrunel.qtpromise/index.html) [![Travis](https://img.shields.io/travis/simonbrunel/qtpromise.svg?style=flat-square)](https://travis-ci.org/simonbrunel/qtpromise) [![coverage](https://img.shields.io/codecov/c/github/simonbrunel/qtpromise.svg?style=flat-square)](https://codecov.io/gh/simonbrunel/qtpromise)
|
||||||
|
|
||||||
[Promises/A+](https://promisesaplus.com/) implementation for [Qt/C++](https://www.qt.io/).
|
[Promises/A+](https://promisesaplus.com/) implementation for [Qt/C++](https://www.qt.io/).
|
||||||
|
|
||||||
@ -11,6 +11,13 @@ Requires [Qt 5.4](https://www.qt.io/download/) (or later) with [C++11 support en
|
|||||||
### Installation
|
### Installation
|
||||||
QtPromise is a [header-only](https://en.wikipedia.org/wiki/Header-only) library, simply download the [latest release](https://github.com/simonbrunel/qtpromise/releases/latest) (or [`git submodule`](https://git-scm.com/docs/git-submodule])) and include `qtpromise.pri` from your project `.pro`.
|
QtPromise is a [header-only](https://en.wikipedia.org/wiki/Header-only) library, simply download the [latest release](https://github.com/simonbrunel/qtpromise/releases/latest) (or [`git submodule`](https://git-scm.com/docs/git-submodule])) and include `qtpromise.pri` from your project `.pro`.
|
||||||
|
|
||||||
|
### qpm
|
||||||
|
Alternatively and **only** if your project relies on [qpm](http://www.qpm.io/), you can install QtPromise as follow:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
qpm install com.github.simonbrunel.qtpromise
|
||||||
|
```
|
||||||
|
|
||||||
### Usage
|
### Usage
|
||||||
The recommended way to use QtPromise is to include the single module header:
|
The recommended way to use QtPromise is to include the single module header:
|
||||||
|
|
||||||
@ -72,7 +79,7 @@ It's then easy to chain the whole asynchronous process using promises:
|
|||||||
- [`then`](#qpromise-then) *and only if download succeeded*, uncompress received data,
|
- [`then`](#qpromise-then) *and only if download succeeded*, uncompress received data,
|
||||||
- [`then`](#qpromise-then) validate and process the uncompressed entries,
|
- [`then`](#qpromise-then) validate and process the uncompressed entries,
|
||||||
- [`finally`](#qpromise-finally) perform operations whatever the process succeeded or failed,
|
- [`finally`](#qpromise-finally) perform operations whatever the process succeeded or failed,
|
||||||
- and hande specific errors using [`fail`](#qpromise-fail).
|
- and handle specific errors using [`fail`](#qpromise-fail).
|
||||||
|
|
||||||
```cpp
|
```cpp
|
||||||
download(url).then(&uncompress).then([](const Entries& entries) {
|
download(url).then(&uncompress).then([](const Entries& entries) {
|
||||||
@ -397,4 +404,4 @@ auto output = qPromiseAll(promises);
|
|||||||
```
|
```
|
||||||
|
|
||||||
## License
|
## License
|
||||||
QtPromise is available under the [MIT license](LICENSE.md).
|
QtPromise is available under the [MIT license](LICENSE).
|
||||||
|
18
qpm.json
Normal file
18
qpm.json
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
{
|
||||||
|
"name": "com.github.simonbrunel.qtpromise",
|
||||||
|
"description": "Promises/A+ implementation for Qt/C++",
|
||||||
|
"author": {
|
||||||
|
"name": "Simon Brunel",
|
||||||
|
"email": "simonbrunel@users.noreply.github.com"
|
||||||
|
},
|
||||||
|
"repository": {
|
||||||
|
"type": "GITHUB",
|
||||||
|
"url": "https://github.com/simonbrunel/qtpromise.git"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"label": "0.1.0"
|
||||||
|
},
|
||||||
|
"license": "MIT",
|
||||||
|
"pri_filename": "qtpromise.pri",
|
||||||
|
"webpage": "https://github.com/simonbrunel/qtpromise"
|
||||||
|
}
|
Loading…
Reference in New Issue
Block a user