<commit_before>#   Just: Swift HTTP for Humans [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

<img src="https://raw.githubusercontent.com/JustHTTP/Just/master/Docs/IconMasked.png" width="280" height="280">

Just is a client-side HTTP library inspired by [python-requests][] - HTTP for Humans.

*Follow [@JustHTTP][twitter] for updates, if you are into that kind of things* 😉

[python-requests]: http://python-requests.org "python-requests"
[twitter]: https://twitter.com/JustHTTP

#   Features

Just lets you to the following effortlessly:

-   URL queries
-   custom headers
-   form (`x-www-form-encoded`) / JSON HTTP body
-   redirect control
-   multpart file upload along with form values.
-   basic/digest authentication
-   cookies
-   timeouts
-   synchrounous / asyncrounous requests
-   upload / download progress tracking for asynchronous requests
-   friendly accessible results

#  Use

The simplest request with Just looks like this:

```swift
//  A simple get request
Just.get("http://httpbib.org/get")
```

The next example shows how to upload a file along with some data:

```swift
//  talk to registration end point<commit_msg>noted Swift 2.0 support in docs<commit_after>#   Just: Swift HTTP for Humans [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

<img src="https://raw.githubusercontent.com/JustHTTP/Just/master/Docs/IconMasked.png" width="280" height="280">

Just is a client-side HTTP library inspired by [python-requests][] - HTTP for Humans.

Swift 2.0 support can be found on *[swift-2.0][]* branch.

*Follow [@JustHTTP][twitter] for updates, if you are into that kind of things* 😉

[python-requests]: http://python-requests.org "python-requests"
[twitter]: https://twitter.com/JustHTTP
[swift-2.0]: https://github.com/JustHTTP/Just/tree/swift-2.0 "Just support for Swift 2.0"
#   Features

Just lets you to the following effortlessly:

-   URL queries
-   custom headers
-   form (`x-www-form-encoded`) / JSON HTTP body
-   redirect control
-   multpart file upload along with form values.
-   basic/digest authentication
-   cookies
-   timeouts
-   synchrounous / asyncrounous requests
-   upload / download progress tracking for asynchronous requests
-   friendly accessible results

#  Use

The simplest request with Just looks like this:

```swift
//  A simple get request
Just.get("http://httpbib.org/get")
```

The next example shows how to upload a file along with some data:

```swift
//  talk to registration end point
{'fraction_non_alphanumeric': 0.11883067577828398, 'fraction_numerical': 0.011389521640091117, 'mean_word_length': 3.98109640831758, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 9, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3151411', 'n_tokens_mistral': 846, 'n_tokens_neox': 790, 'n_words': 258}