SwiftRandom
SwiftRandom is a tiny help suite for generating random data such as
- Random human stuff like: names, gender, titles, tags, conversations
- Random data types like: Int, CGFloat, Bool, UIColor, NSDate, NSURL, element in Array
Usage
func asExtension() {
Int.random(2, 77) // Random between 2-77
Int.random(2...77)
Int32.random(13, 37) // Random between 13-37
Int32.random(13...37)
Double.random()
Float.random(3.2, 4.5) // Random between 3.2-4.5
CGFloat.random()
NSDate.random()
NSDate.randomWithinDaysBeforeToday(7)
NSDate.random(between: Date().addingTimeInterval(TimeInterval(-5*24*60*60)), and:Date()) // Random date between now and 5 days ago
UIColor.random()
NSURL.random()
// Array Extensions
var someArray = ["hello", "world"]
someArray[0..<someArray.count].randomItem() // Array slice
someArray.randomItem()
// String Extensions
String.random(ofLength: 16)
String.random(minimumLength: 16, maximumLength: 32)
String.random(withCharactersInString: "abc", ofLength: 16)
String.random(withCharactersInString: "abc", minimumLength: 16, maximumLength: 32)
}
func asMethods() {
// Return random Int >= 10 and <= 20
// Example Output: 13
Randoms.randomInt(10,20)
// Return random Int32 >= 10 and <= 20
// Example Output: 13
Randoms.randomInt32(10,20)
// Returns a random 16 character long string containing alphanumeric characters
Randoms.randomString(ofLength: 16)
// Returns a random string containing alphanumeric characters ranging in length from 16 to 32.
Randoms.randomString(minimumLength: 16, maximumLength: 32)
// Returns a random 16 character long string containing the specified characters
Randoms.randomString(withCharactersInString: "abc", ofLength: 16)
// Returns a random string of length between 16 and 32 containing the specified characters
Randoms.randomString(withCharactersInString: "abc", minimumLength: 16, maximumLength: 32)
// Return random Double >= 10 and <= 20
// Example Output: 11.511219042938
Randoms.randomDouble(10,20)
// Return random Float >= 10 and <= 20
// Example Output: 17.0361
Randoms.randomFloat(10,20)
// Return random CGFloat between 1 >= and >= 0
// Example Output: 0.622616
Randoms.randomCGFloat()
// Return true 30%, false %70
// Example Output: false
Randoms.randomPercentageisOver(70)
// Return true or false
// Example Output: false
Randoms.randomBool()
// Return random NSDate today > and > today - 7.
// Example Output: 2015-10-08 03:55:09 +0000
Randoms.randomDateWithinDaysBeforeToday(7)
// Random Date since 1970
// Example Output: 1997-02-01 15:27:08 +0000
Randoms.randomDate()
// Return UIColor. Alpha channel always 1.
// Example Output: UIDeviceRGBColorSpace 0.645737 0.126625 0.52535 1
Randoms.randomColor()
// Return random NSURL
// Example Output: http://leagueoflegends.com/
Randoms.randomNSURL()
// ==================== Fake Generators for Fake Datasources ==================== //
// Return random name
// Example Output: "Megan Freeman"
Randoms.randomFakeName()
// Return random first name
// Example Output: "Megan"
Randoms.randomFakeFirstName()
// Return random last name
// Example Output: "Freeman"
Randoms.randomFakeLastName()
// Return random fake name prefixed by English honorific
// Example Output: "Dr. Megan Freeman"
Randoms.randomFakeNameAndEnglishHonorific()
// Return "Male" or "Female" as String
// Example Output: "Female"
Randoms.randomFakeGender()
// Return random conversation
// Example Output: "No! I'm tired of doing what you say."
Randoms.randomFakeConversation()
// Return random title
// Example Output: "B2 Pilot @ USAF"
Randoms.randomFakeTitle()
// Return random tag as string
// Example Output: "question"
Randoms.randomFakeTag()
// Return random currency as String
// Example Output: "EUR"
Randoms.randomCurrency()
// Return random (non-existing) gravatar as UIImage?
// The image is optional in case of network issues
Randoms.randomGravatar { (image, error) -> Void in
// Handle the image/error
}
// For consistance behaviour you can create custom Gravatar
Randoms.createGravatar(Randoms.GravatarStyle.Retro) { (image, error) -> Void in
// Handle the image/error
}
}
Requirements
- Swift version 2.0
Installation
Install via Carthage
- Create a
Cartfilewith the following specification and runcarthage update.
github "thellimist/SwiftRandom" >= 1.0.0
- Follow the instructions to add the framework to an iOS project.
Install via CocoaPods
You can use CocoaPods to install SwiftRandom by adding it to your Podfile:
platform :ios, '8.0'
use_frameworks!
pod 'SwiftRandom' #Stable release for Swift 3.0
To download older version you can use
pod 'SwiftRandom', :git => 'https://github.com/thellimist/SwiftRandom.git' #Latest release for Swift 3.0
pod 'SwiftRandom', :git => 'https://github.com/thellimist/SwiftRandom.git', :branch => '2.x' #For Swift 2.3
Install Manually
- Download and drop 'Randoms.swift' in your project.
Improvement
- Feel free adding your own random data functions and sending pull requests.
Possible features:
- Random wildlife pictures (Should not include the image inside project, should load it from web when needed)
- Make OSX compatiable and add here: https://github.com/AndrewSB/awesome-osx
- Random JSON
- Random Gifs (Should not include gifs inside the project, should load it from web when needed)
- Random Videos (Should not include videos inside the project, should load it from web when needed)
- Implement
SwiftRandomas a protocol any class can conform to (Post.random()would give you a random post)
License
- SwiftRandom is available under the MIT license. See the LICENSE file.
Keywords
random, swift, data, generator, faker, fake, gravatar
1.5k Dec 29, 2022
34 Nov 16, 2022
0 Dec 6, 2021
0 Dec 14, 2021
3 Oct 1, 2022
2 Aug 16, 2022
7 Dec 7, 2022
11 Oct 23, 2021
17 Dec 12, 2022
0 Dec 27, 2021
1.7k Dec 6, 2022
54 Sep 5, 2022
33 Dec 15, 2022
3 Jul 15, 2022
1 Dec 7, 2021
0 Dec 29, 2021
4 Aug 14, 2022
26 Dec 14, 2022
11 Oct 17, 2022