mirror of
https://github.com/simonbrunel/qtpromise.git
synced 2024-11-22 02:34:30 +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>
|
||||
|
||||
# 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/).
|
||||
|
||||
@ -11,6 +11,13 @@ Requires [Qt 5.4](https://www.qt.io/download/) (or later) with [C++11 support en
|
||||
### 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`.
|
||||
|
||||
### 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
|
||||
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) validate and process the uncompressed entries,
|
||||
- [`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
|
||||
download(url).then(&uncompress).then([](const Entries& entries) {
|
||||
@ -397,4 +404,4 @@ auto output = qPromiseAll(promises);
|
||||
```
|
||||
|
||||
## 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