# xero-rs

[![Crates.io][crates-badge]][crates-url]
[![Documentation][docs-badge]][docs-url]
[![MIT licensed][mit-badge]][mit-url]
[![Build Status][actions-badge]][actions-url]
[![Coverage][codecov-badge]][codecov-url]

[crates-badge]: https://img.shields.io/crates/v/xero-rs.svg
[crates-url]: https://crates.io/crates/xero-rs
[docs-badge]: https://docs.rs/xero-rs/badge.svg
[docs-url]: https://docs.rs/xero-rs
[mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg
[mit-url]: LICENSE
[actions-badge]: https://github.com/slickbench/xero-rs/actions/workflows/tests.yml/badge.svg
[actions-url]: https://github.com/slickbench/xero-rs/actions/workflows/tests.yml
[codecov-badge]: https://codecov.io/gh/slickbench/xero-rs/branch/main/graph/badge.svg?token=INFT14K6KW
[codecov-url]: https://codecov.io/gh/slickbench/xero-rs

## Description

A Xero API client library for Rust. This library is in very early days and the API is **not** stable, it may change without notice.

This was put together as part of the requirements for a private project so I will be implementing features as-needed, but all contributions are welcome.

## Features

- Client credential & code flow authorization support
- Generic GET, PUT, and POST methods for custom requests
- Uses [rust_decimal](https://github.com/paupino/rust-decimal) for storing prices/decimal values
- Well tested (that's the goal, at least)

## Currently Implemented

This has been implemented so far:

- OAuth2 Authentication (Client Credentials, Authorization Code Flow)
- List authorized connections (tennants)
- Quotes
  - List
  - Get by ID
- Invoices
  - List
  - Get by ID
- Purchase Orders
  - List
  - Get by ID
  - Create
- Contacts
  - List