> For the complete documentation index, see [llms.txt](https://hadrien-lejard.gitbook.io/chopper/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hadrien-lejard.gitbook.io/chopper/readme.md).

# Chopper

[![All Contributors](https://img.shields.io/badge/all_contributors-7-orange.svg?style=flat-square)](#contributors-)

[![pub package](https://img.shields.io/pub/v/chopper.svg)](https://pub.dev/packages/chopper) [![Dart CI](https://github.com/lejard-h/chopper/workflows/Dart%20CI/badge.svg)](https://github.com/lejard-h/chopper/actions?query=workflow%3A%22Dart+CI%22) [![codecov](https://codecov.io/gh/lejard-h/chopper/branch/master/graph/badge.svg)](https://codecov.io/gh/lejard-h/chopper)

Chopper is an http client generator for Dart and Flutter using source\_gen and inspired by Retrofit.

[Documentation](https://hadrien-lejard.gitbook.io/chopper)

## Installation

Please refer to the installation guide at [pub.dev](https://pub.dev/packages/chopper/install) or in the [Getting started](/chopper/getting-started.md) document.

* [Requests](/chopper/requests.md)
* [Converters](/chopper/converters/converters.md)
* [Interceptors](/chopper/interceptors.md)

## Examples

* [json serializable Converter](https://github.com/lejard-h/chopper/blob/master/example/bin/main_json_serializable.dart)
* [built value Converter](https://github.com/lejard-h/chopper/blob/master/example/bin/main_built_value.dart)
* [request features](https://github.com/lejard-h/chopper/blob/master/example/bin/main_request_features.dart)

## [Issue Tracker](https://github.com/lejard-h/chopper/issues)

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

| <p><a href="https://github.com/lejard-h"><br><sub>Hadrien Lejard</sub></a><br><a href="https://github.com/lejard-h/chopper/commits?author=lejard-h">💻</a> <a href="https://github.com/lejard-h/chopper/pulls?q=is%3Apr+reviewed-by%3Alejard-h">👀</a> <a href="https://github.com/lejard-h/chopper/commits?author=lejard-h">⚠️</a> <a href="https://github.com/lejard-h/chopper/commits?author=lejard-h">📖</a></p> | <p><a href="https://github.com/stewemetal"><br><sub>István Juhos</sub></a><br><a href="https://github.com/lejard-h/chopper/commits?author=stewemetal">💻</a> <a href="https://github.com/lejard-h/chopper/pulls?q=is%3Apr+reviewed-by%3Astewemetal">👀</a> <a href="https://github.com/lejard-h/chopper/commits?author=stewemetal">⚠️</a> <a href="https://github.com/lejard-h/chopper/commits?author=stewemetal">📖</a></p> | <p><a href="https://github.com/techouse"><br><sub>Klemen Tusar</sub></a><br><a href="https://github.com/lejard-h/chopper/commits?author=techouse">💻</a> <a href="https://github.com/lejard-h/chopper/pulls?q=is%3Apr+reviewed-by%3Atechouse">👀</a> <a href="https://github.com/lejard-h/chopper/commits?author=techouse">⚠️</a> <a href="https://github.com/lejard-h/chopper/commits?author=techouse">📖</a></p> | <p><a href="https://www.upwork.com/freelancers/~01192eefd8a1c267f7"><br><sub>Ivan Terekhin</sub></a><br><a href="https://github.com/lejard-h/chopper/commits?author=JEuler">💻</a> <a href="https://github.com/lejard-h/chopper/pulls?q=is%3Apr+reviewed-by%3AJEuler">👀</a> <a href="https://github.com/lejard-h/chopper/commits?author=JEuler">⚠️</a> <a href="https://github.com/lejard-h/chopper/commits?author=JEuler">📖</a></p> | <p><a href="https://github.com/Guldem"><br><sub>Job Guldemeester</sub></a><br><a href="https://github.com/lejard-h/chopper/commits?author=Guldem">💻</a> <a href="https://github.com/lejard-h/chopper/pulls?q=is%3Apr+reviewed-by%3AGuldem">👀</a> <a href="https://github.com/lejard-h/chopper/commits?author=Guldem">⚠️</a> <a href="https://github.com/lejard-h/chopper/commits?author=Guldem">📖</a></p> | <p><a href="http://ysampir@gmail.com"><br><sub>Eugeny Sampir</sub></a><br><a href="https://github.com/lejard-h/chopper/commits?author=fryette">💻</a></p> | <p><a href="https://github.com/Vovanella95"><br><sub>Uladzimir Paliukhovich</sub></a><br><a href="https://github.com/lejard-h/chopper/commits?author=Vovanella95">💻</a></p> |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!