Just 是一种受 python-requests 启发的客户端 HTTP 库 - 为人类设计的 HTTP。

Just 支持 Swift 3。你可以使用 Swift 2，版本为 0.4.8。

关注 @JustHTTP 以获取更新，如果你对这类事物感兴趣的话 😉

特性

Just 让你可以毫不费力地做以下事情

• URL 查询
• 自定义头部
• 表单（x-www-form-urlencoded）/ JSON HTTP 正体
• 重定向控制
• 与表单值一起的上传文件
• 基本/摘要身份验证
• Cookie
• 超时
• 同步/异步请求
• 异步请求的上传/下载进度跟踪
• 链接头部
• 易于访问的结果

使用

Just 最简单的请求看起来像这样

//  A simple get request
Just.get("http://httpbin.org/get")

以下示例显示了如何上传文件和一些数据

//  talk to registration end point
let r = Just.post(
    "http://justiceleauge.org/member/register",
    data: ["username": "barryallen", "password":"ReverseF1ashSucks"],
    files: ["profile_photo": .URL(fileURLWithPath:"flash.jpeg", nil)]
)

if r.ok { /* success! */ }

以下是相同示例的异步执行版本

//  talk to registration end point
Just.post(
    "http://justiceleauge.org/member/register",
    data: ["username": "barryallen", "password":"ReverseF1ashSucks"],
    files: ["profile_photo": .URL(fileURLWithPath:"flash.jpeg", nil)]
) { r in
    if r.ok { /* success! */ }
}

阅读 入门 在线 或 在该游乐场中 了解更多信息！

安装

以下是一些利用 Just 的方法。

Swift 包管理器

将以下内容添加到你的 dependencies

.Package(url: "https://github.com/JustHTTP/Just.git", majorVersion: 0, minor: 5)

手动

将 Just.xcodeproj 投放到你的项目导航器中。在你的项目设置的 通用 标签页下，使用加号将 Just.framework 添加到 链接框架和库 中。确保包括为你的目标平台正确版本的框架。

通常也将 Just 添加为 git 子模块到项目存储库中

cd path/to/your/project
git submodule add https://github.org/JustHTTP/Just.git

源文件

将 Just.swift 直接放到你的项目中。或者，将其置于游乐场的 源 文件夹中。（后者是探索网络的有趣方式。）

贡献

欢迎提交pull请求。以下是针对代码贡献者的几点建议。

在Just.xcworkspace中工作。

链接头部的测试依赖于Github API，每小时有较低的限额。为了克服这个问题，您可以编辑Xcode构建方案，并添加环境变量 GITHUB_TOKEN。了解更多关于个人令牌的信息，请点击此处链接。

对于Xcode的叛逆者，请查看Makefile（您将需要xcpretty）。

HTML文档页面由文献编程工具docco生成。

许可证

MIT，请参阅LICENSE.md。