InflectorKit
InflectorKit is a port of the string inflection functionality from Rails ActiveSupport for Swift and Objective-C.
InflectorKit joins FormatterKit & TransformerKit in providing well-designed APIs for manipulating user-facing content.
Usage
Swift
import InflectorKit
for singular in ["person", "tomato", "matrix", "octopus", "fish"] {
print("\(singular) β \(singular.pluralized)")
}
/*
Prints:
person β people
tomato β tomatoes
matrix β matrices
octopus β octopi
fish β fish
*/
// You can also add pluralization rules,
// including irregular and uncountable words:
let inflector = StringInflector.default
inflector.addPluralRule(#"^i(Pod|Pad)( Mini)?$"#, replacement: #"i$1s$2"#)
inflector.addIrregular(singular: "lol", plural: "lolz")
inflector.addUncountable("Herokai")
for singular in ["iPad Mini", "lol", "Herokai"] {
print("\(singular) β \(singular.pluralized)")
}
/*
Prints:
iPad Mini β iPads Mini
lol β lolz
Herokai β Herokai
*/Objective-C
#import "NSString+InflectorKit.h"
for (NSString *singular in @[@"person", @"tomato", @"matrix", @"octopus", @"fish"]) {
NSLog(@"%@ β %@", singular, [singular pluralizedString]);
}
/*
Prints:
person β people
tomato β tomatoes
matrix β matrices
octopus β octopi
fish β fish
*/
// You can also add pluralization rules,
// including irregular and uncountable words:
TTTStringInflector *inflector = [TTTStringInflector defaultInflector];
[inflector addPluralRule:@"^i(Pod|Pad)( Mini)?$" withReplacement:@"i$1s$2"];
[inflector addIrregularWithSingular:@"lol" plural:@"lolz"];
[inflector addUncountable:@"Herokai"];
for (NSString *singular in @[@"iPad Mini", @"lol", @"Herokai"]) {
NSLog(@"%@ β %@", singular, [singular pluralizedString]);
}
/*
Prints:
iPad Mini β iPads Mini
lol β lolz
Herokai β Herokai
*/Installation
Swift Package Manager
Add the InflectorKit package to your target dependencies in Package.swift:
import PackageDescription
let package = Package(
name: "YourProject",
dependencies: [
.package(
url: "https://github.com/mattt/InflectorKit",
from: "1.0.0"
),
]
)Then run the swift build command to build your project.
CocoaPods
You can install InflectorKit via CocoaPods,
by adding the following line to your Podfile:
pod 'InflectorKit', '~> 1.0.0'Run the pod install command to download the library
and integrate it into your Xcode project.
License
MIT
Contact
Mattt (@mattt)