Criollo: An Objective-C repository from 3a4oT

A powerful Cocoa based web application framework for OS X and iOS.

Criollo helps create really fast standalone web apps that deliver content directly over HTTP or FastCGI. You can write code in Objective-C or Swift. And you can use technologies you know and love: Grand Central Dispatch, NSURLSession, CoreImage and many more.

It's as easy as this:

let server = CRHTTPServer()
server.get("/") { (request, response, completionHandler) in
	response.send("Hello world!")
}
server.startListening()

and in Objective-C:

CRServer* server = [[CRHTTPServer alloc] init];
[server get:@"/" block:^(CRRequest * request, CRResponse * response, CRRouteCompletionBlock completionHandler) {
    [response send:@"Hello world!"];
}];
[server startListening];

Why?

Criollo was created in order to take advantage of the truly awesome tools and APIs that OS X and iOS provide and serve content produced with them over the web.

It incorporates an HTTP web server and a FastCGI application server that are used to deliver content. The server is built on Grand Central Dispatch and designed for speed.

How to Use

Criollo can easily be embedded as a web-server inside your OS X or iOS app, should you be in need of such a feature, however it was designed to create standalone, long-lived daemon style apps. It is fully launchd compatible and replicates the lifecycle and behavior of NSApplication, so that the learning curve should be as smooth as possible.

For a more real-world example, check out the criollo.io website, made using Criollo and available for your cloning pleasure at https://github.com/thecatalinstan/Criollo-Web.

See the Hello World Multi Target example for a demo of the two usage patterns.

Getting Started

Download Criollo and try out the included OS X and iOS example apps. Criollo requires CocoaAsyncSocket, so do not forget to download it into Libraries/CocoaAsyncSocket.
Read the “Getting Started” guide and move further with the “Doing More Stuff” guide
Check out the documentation for a look at the APIs available
Learn how to deploy your Criollo apps in the “Deployment” guide

Installing

The preferred way of installing Criollo is through CocoaPods. However, you can also embed the framework in your projects manually.

Installing with CocoaPods

Create the Podfile if you don’t already have one. You can do so by running pod init in the folder of the project.
Add Criollo to your Podfile. pod 'Criollo', '~> 0.4’
Run pod install

Please note that Criollo will download CocoaAsyncSocket as a dependency.

Cloning the repo

Criollo uses CocoaAsyncSocket which is included as a git submodule

git clone --recursive https://github.com/thecatalinstan/Criollo.git

Work in Progress

Criollo is work in progress and - as such - it’s not ready for the wild yet. The reason for this is mainly missing functionality and sheer lack of documentation[^It is also very high on my list of priorities, but sadly still a “to-do” item].

The existing APIs are relatively stable and are unlikely to change dramatically unless marked as such.

Get in Touch

If you have any questions regarding the project or how to do anything with it, please feel free to get in touch either on Twitter @criolloio or by plain old email criollo@criollo.io.

I really encourage you to submit an issue, as your input is really and truly appreciated.

3a4oT/Criollo