• Stars
    star
    845
  • Rank 51,767 (Top 2 %)
  • Language
    Swift
  • License
    MIT License
  • Created almost 9 years ago
  • Updated over 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🏇 A Swift HTTP / HTTPS networking library just incidentally execute on machines


Thus, programs must be written for people to read, and only incidentally for machines to execute.
Harold Abelson, "Structure and Interpretation of Computer Programs" ( S.I.C.P )

Pitaya is a Swift HTTP / HTTPS networking library for people. Inspired by Alamofire and JustHTTP.


Example

Simple

Pita.build(HTTPMethod: .GET, url: "https://httpbin.org/get?hello=Hello%20Pitaya!")
    .responseJSON { (json, response) -> Void in
        print(json["args"]["hello"].stringValue) // get "Hello Pitaya!"
}

All examples

All Examples

Documentation

Features

  • Support Swift Package Manager
  • Elegant APIs for people
  • Support HTTP Basic Authorization
  • Support setting SSL pinning
  • Support setting HTTP raw body (include JSON body)
  • Asynchronous & Queue
  • Upload files fast
  • Internal fully JSON support with JSONNeverDie
  • Support setting custom HTTP headers
  • almost 100% tested

Requirements

  • iOS 7.0+
  • Xcode 10.2 (Swift 5) (v4.x) in the default swift5 branch.
  • Xcode 9 (Swift 4) (v3.x) in swift4 branch.
  • Xcode 8 (Swift 3) (v2.x) in swift3 branch.
  • Xcode 7 (Swift 2) (v1.x) in master branch.
  • Xcode 6.4 (Swift 1.2) before v0.2.3

Installation

Swift Package Manager

You can use The Swift Package Manager to install Pitaya by adding the proper description to your Package.swift file:

import PackageDescription

let package = Package(
    name: "YOUR_PROJECT_NAME",
    targets: [],
    dependencies: [
        .Package(url: "https://github.com/johnlui/Pitaya.git", versions: "1.3.4" ..< Version.max)
    ]
)

Note that the Swift Package Manager is still in early design and development, for more infomation checkout it's GitHub Page

Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Pitaya into your Xcode project using Carthage, specify it in your Cartfile:

github "JohnLui/Pitaya"

Then fetch and build Pitaya:

carthage update

At last, add it to "Embedded Binaries" in the general panel use the "Add Other..." button. The Pitaya.framework binary file is lying in ./Carthage/Build/iOS directory.

Manually

git submodule add https://github.com/johnlui/Pitaya.git
open .

then drag Pitaya.xcodeproj into your Project, that's it!

If you want to run your project on devices with Pitaya, just go to PROJECT->TARGETS->[your project name]->General->Embedded Binaries, click +, select Pitaya.frameWork and click "Add".

Source File

Clone all files in the Source directory into your project.

Contribution

You are welcome to fork and submit pull requests.

License

Pitaya is open-sourced software licensed under the MIT license.

中文介绍

Thus, programs must be written for people to read, and only incidentally for machines to execute.(代码是写给人看的,只是恰好能运行。)

Harold Abelson, "Structure and Interpretation of Computer Programs" ( S.I.C.P )

Pitaya(火龙果) 是一个写给人看的纯 Swift 写成的 HTTP / HTTPS 网络库。从 AlamofireJustHTTP 偷了一些创意和代码。

使用示例

基本用法

Pita.build(HTTPMethod: .GET, url: "https://httpbin.org/get?hello=Hello%20Pitaya!")
    .responseJSON { (json, response) -> Void in
        print(json["args"]["hello"].stringValue) // get "Hello Pitaya!"
}

所有用法

All Examples

功能

  • 支持 Swift Package Manager
  • 写给人用的优雅 API
  • 支持 HTTP Basic Authorization
  • 支持设置 SSL 钢钉,防“中间人攻击”
  • 支持设置 HTTP raw body (支持 JSON body)
  • 异步、队列
  • 快速文件上传
  • 内置 JSONNeverDie,完全支持 JSON 数据
  • 支持设定 HTTP headers
  • 几乎 100% 测试率

环境要求

  • iOS 7.0+
  • Xcode 10.2 (Swift 5) v4.x 版,位于 swift5 分支(当前默认版本)
  • Xcode 9 (Swift 4) v3.x 版,位于 swift4 分支
  • Xcode 8 (Swift 3) v2.x 版,位于 swift3 分支
  • Xcode 7 (Swift 2) v1.x 版,位于 master 分支
  • Xcode 6.4 (Swift 1.2) 版: v0.2.3

安装

Swift Package Manager

The Swift Package Manager 是苹果伴随 Swift 开源而推出的 Swift 语言包管理工具。

编辑你项目的 Package.swift

import PackageDescription

let package = Package(
    name: "YOUR_PROJECT_NAME",
    targets: [],
    dependencies: [
        .Package(url: "https://github.com/johnlui/Pitaya.git", versions: "1.3.4" ..< Version.max)
    ]
)

Swift Package Manager 依然在开发中,功能不太稳定,建议关注它的 GitHub Page

Carthage

Carthage 是一个去中心化的 Cocoa 应用程序自动依赖添加工具。

使用以下命令安装 Carthage

$ brew update
$ brew install carthage

安装好 Carthage 后,将下列内容加入你项目的 Cartfile:

github "JohnLui/Pitaya"

自动下载、编译 Pitaya:

carthage update

最后,在 general panel 里 的 "Embedded Binaries" 项下点击 "Add Other..." 按钮,Pitaya.framework 已经躺在了 ./Carthage/Build/iOS 目录里。

这种方法目前还不支持 BITCODE,如果需要支持,请直接将 Pitaya.xcodeproj 拖入你的工程。

手动安装

git clone https://github.com/johnlui/Pitaya.git
open Pitaya

在打开的 Finder 窗口中把 Pitaya.xcodeproj 拖到 Xcode 你的文件树里。

真机调试还需要额外的一步:打开 PROJECT->TARGETS->[your project name]->General,找到 Embedded Binaries, 点击 +, 选中 Pitaya.framework,点击“Add”即可。

源代码安装

Source 文件夹下的文件拖进你的文件树里即可。

参与开源

欢迎提交 issue 和 PR,大门永远向所有人敞开。

开源协议

本项目遵循 MIT 协议开源,具体请查看根目录下的 LICENSE 文件。

More Repositories

1

Learn-Laravel-5

Laravel 5 系列入门教程
PHP
3,511
star
2

PPHC

📙《高并发的哲学原理》开源图书(CC BY-NC-ND)
Rust
2,666
star
3

SwiftSideslipLikeQQ

再造 “手机QQ” 侧滑菜单
Swift
1,670
star
4

AutoLayout

Auto Layout 秘境
Swift
1,216
star
5

SwiftNotice

GUI library for displaying various popups (HUD), written in pure Swift.
Swift
839
star
6

AliyunOSS

阿里云 OSS 官方 SDK 的 Composer 封装,支持任何 PHP 项目,包括 Laravel、Symfony、TinyLara 等等。
PHP
487
star
7

JSONNeverDie

Auto reflection tool from JSON to Model, user friendly JSON encoder / decoder, aims to never die
Swift
453
star
8

Swift-MMP

🎧 Stream Material-design Music Player written by Swift for iOS.
Swift
367
star
9

Swift-On-iOS

JohnLui 的 Swift On iOS 代码仓库
Swift
350
star
10

FireUpYourVPN

在通知中心一键启用 VPN
Swift
310
star
11

Learn-Laravel-4

Laravel 4 系列入门教程 代码示例
PHP
215
star
12

DIYSearchEngine

🔍 Go 开发的开源互联网搜索引擎,附教程《自己动手开发互联网搜索引擎》
Go
135
star
13

My-First-Framework-based-on-Composer

利用 Composer 一步一步构建自己的 PHP 框架 代码示例
PHP
111
star
14

LaraDuoshuo

Laravel 5 实现的私有评论系统,用于 Hexo、Jekyll 等静态博客系统
PHP
92
star
15

CodeIgniter-2-with-Eloquent

CodeIgniter 2.2.0 with Eloquent
PHP
42
star
16

MarkDown-for-Emlog

十分漂亮的 Markdown 编辑器,完美替代 Emlog 自带编辑器。
JavaScript
36
star
17

AliyunOSS-Laravel7

阿里云 OSS 官方 SDK 的 Composer 封装,专门支持 Laravel 7、Laravel 8
PHP
32
star
18

go_static

A simple static tool for any single page with golang, also can be used in Emlog platform for the whole website. 使用Go语言编写的跨平台的网站首页静态化工具[也适用于emlog整站(首页+文章+页面)静态化]
Go
26
star
19

KillTYZ

KillTYZ 干掉拖延症
PHP
23
star
20

JSON-API-for-Emlog

强大的 JSON 格式的数据输出插件,为 Emlog 而生。
PHP
6
star
21

GraphQL-Laravel

A Laravel GraphQL reference implementation forked from webonyx/graphql-php
PHP
3
star
22

Ultimo-emlog

Ultimo 主题 for Emlog
PHP
2
star
23

Change

a Emlog template
PHP
1
star
24

PHPSwift

Write Swift like PHP, just for fun.
Swift
1
star