Lorem Ipsum

Lorem Ipsum is a simple lorem ipsum generator for iOS and OS X apps. It supports generating text in different formats (words, sentences, paragraphs), miscelianous data (names, URLs, dates etc.) and placeholder images for both, iOS and OS X.

This project was inspired by a great static site generator Middleman. Its lorem ipsum feature was also a data source for this project.

Table of Contents

• Installation
• Usage
  • Texts
  • Misc Data
  • Images
• Example Projects
• Release Notes
• Author
• License

Installation

Lorem Ipsum can be integrated into your Xcode project using CocoaPods by putting following line into your Podfile and running pod install:

pod 'LoremIpsum', '~> 1.0'

Alternatively you can copy the files LoremIpsum.h and LoremIpsum.m to your project.

Usage

Wherever you want to use Lorem Ipsum functionality, import the header file.

#import "LoremIpsum.h"

Texts

NSString *word = [LoremIpsum word]; => "voluptatem"
NSString *words = [LoremIpsum wordsWithNumber:5]; => "est dolores voluptatem cumque itaque"
NSString *sentence = [LoremIpsum sentence]; => "Facilis magni autem ut iure cum voluptas excepturi eos."
NSString *sentences = [LoremIpsum sentencesWithNumber:2];
NSString *paragraph = [LoremIpsum paragraph];
NSString *paragraphs = [LoremIpsum paragraphsWithNumber:2];
NSString *title = [LoremIpsum title]; => "Et Quibusdam"

Misc Data

NSString *firstName = [LoremIpsum firstName]; => "Dora"
NSString *lastName = [LoremIpsum lastName]; => "Glass"
NSString *name = [LoremIpsum name]; => "Tomas Beasley"
NSString *email = [LoremIpsum email]; => "jared.finch@hotmail.com"
NSURL *URL = [LoremIpsum URL]; => "http://stumbleupon.com/"
NSString *tweet = [LoremIpsum tweet];
NSDate *date = [LoremIpsum date];

Images

Lorem Ipsum supports creating placeholder images by downloading them from following supported services:

Service	Value of LIPlaceholderImageService
lorempixel.com	LIPlaceholderImageServiceLoremPixel
hhhhold.com	LIPlaceholderImageServiceHhhhold
dummyimage.com	LIPlaceholderImageServiceDummyImage
placekitten.com	LIPlaceholderImageServicePlaceKitten

Lorem Ipsum offers methods for synchronous and asynchronous downloading of images as well as retrieving the URL for an image without downloading it. All methods work for both platforms, iOS and OS X. According to the platform UIImage or NSImage instances are created.

Synchronous Downloading

UIImage *image = [LoremIpsum placeholderImageFromService:LIPlaceholderImageServicePlaceKitten
                                                withSize:CGSizeMake(250, 250)];
                                                 
NSImage *image = [LoremIpsum placeholderImageWithSize:NSMakeSize(100, 400)];

Asynchronous Downloading

[LoremIpsum asyncPlaceholderImageFromService:LIPlaceholderImageServicePlaceKitten
                                    withSize:CGSizeMake(250, 250)
                                  completion:^(UIImage *image) {
                                      // use image here
                                  }];
                                  
[LoremIpsum asyncPlaceholderImageWithSize:NSMakeSize(100, 400)
                               completion:^(NSImage *image) {
                                   // use image here
                               }];

Image URLs

NSURL *URL = [LoremIpsum URLForPlaceholderImageFromService:LIPlaceholderImageServiceDummyImage
                                                  withSize:CGSizeMake(250, 250)];

Example Projects

This repository contains two example projects for each platform where the usage of Lorem Ipsum is shown.

Release Notes

The relase notes can be found here.

Author

Lukas Kubanek
lukaskubanek.com
@kubanekl

License

Usage is provided under the MIT License. See License.markdown for the full details.