# libgpg-error
[![Build Status][build]][ci]
[![crates.io version][version]][crate]
[![LGPL-2.1 licensed][license]](./COPYING)
[![downloads][downloads]][crate]
libgpg-error bindings for Rust.
## Using
To use the crate, add it to your depedencies:
```sh
$ cargo add libgpg-error
```
### Requirements
These crates require the libgpg-error library and its development files to be
installed. The build script uses the [system-deps] crate to attempt to locate
them (or the registry on Windows).
On Debian/Ubuntu based systems:
```sh
$ sudo apt-get install libgpg-error-dev
```
On Fedora/RHEL based systems:
```sh
$ sudo dnf install libgpg-error-devel
```
On MacOS systems:
```sh
$ brew install gnupg
```
On Windows 10 (1709 or later) systems:
```pwsh
$ winget install --id GnuPG.Gpg4win
```
On Windows systems, download and install the official [Gpg4win] installer. Only
the `i686-pc-windows-gnu` target is supported.
## License
The `libgpg-error` and `libgpg-error-sys` crates are licensed under the [LGPL-2.1 license](./COPYING). Files under
vendor are part of libgpg-error and are licensed under LGPL-2.1-or-later.
[crate]: https://crates.io/crates/gpg-error
[ci]: https://github.com/gpg-rs/libgpg-error/actions/workflows/ci.yml
[build]: https://img.shields.io/github/actions/workflow/status/gpg-rs/libgpg-error/ci.yml?style=flat-square
[version]: https://img.shields.io/crates/v/gpg-error?style=flat-square
[license]: https://img.shields.io/crates/l/gpg-error?style=flat-square
[downloads]: https://img.shields.io/crates/d/gpg-error?style=flat-square
[system-deps]: https://crates.io/crates/system-deps
[Gpg4win]: https://www.gpg4win.org/