Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mattt/transformerkit
A block-based API for NSValueTransformer, with a growing collection of useful examples.
https://github.com/mattt/transformerkit
data-transformation nsvaluetransformer objective-c swift
Last synced: 23 days ago
JSON representation
A block-based API for NSValueTransformer, with a growing collection of useful examples.
- Host: GitHub
- URL: https://github.com/mattt/transformerkit
- Owner: mattt
- License: mit
- Created: 2012-11-09T23:36:56.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2021-10-01T08:35:17.000Z (about 3 years ago)
- Last Synced: 2024-10-04T09:53:05.750Z (about 1 month ago)
- Topics: data-transformation, nsvaluetransformer, objective-c, swift
- Language: Objective-C
- Homepage:
- Size: 144 KB
- Stars: 845
- Watchers: 33
- Forks: 99
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# TransformerKit
**A block-based API for NSValueTransformer,
with a growing collection of useful examples.**
[`NSValueTransformer`](https://nshipster.com/nsvaluetransformer/),
while perhaps obscure to most iOS programmers,
remains a staple of OS X development.
Before Objective-C APIs got in the habit of
flinging block parameters hither and thither with reckless abandon, `NSValueTransformer` was the go-to way to encapsulate mutation functionality --- especially when it came to Bindings.
`NSValueTransformer` is convenient to use but a pain to set up.
To create a value transformer you have to
create a subclass,
implement a handful of required methods,
and register a singleton instance by name.
TransformerKit breathes new life into `NSValueTransformer`
by making them dead-simple to define and register:
```objective-c
NSString * const TTTCapitalizedStringTransformerName = @"TTTCapitalizedStringTransformerName";
[NSValueTransformer registerValueTransformerWithName:TTTCapitalizedStringTransformerName
transformedValueClass:[NSString class]
returningTransformedValueWithBlock:^id(id value) {
return [value capitalizedString];
}];
```
> TransformerKit pairs nicely with
> [InflectorKit](https://github.com/mattt/InflectorKit) and
> [FormatterKit](https://github.com/mattt/FormatterKit),
> providing well-designed APIs for manipulating user-facing content.
---
TransformerKit also contains a _growing_ number of convenient transformers
that your apps will love and cherish:
### String Transformers
- Capitalized
- UPPERCASE
- lowercase
- CamelCase
- llamaCase
- snake_case
- train-case
- esreveR\* _(Reverse)_
- Rémövê Dîaçritics _(Remove accents and combining marks)_
- ट्रांस्लितेराते स्ट्रिंग _(Transliterate to Latin)_
- Any Valid [ICU Transform](http://userguide.icu-project.org/transforms/general)\*
### Image Transformers
- PNG Representation\*
- JPEG Representation\*
- GIF Representation _(macOS)_
- TIFF Representation _(macOS)_
### Date Transformers
- [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm) Timestamp\*
- [RFC 2822](https://www.ietf.org/rfc/rfc2822) Timestamp\*
### JSON Data Transformers
- JSON Transformer\*
### Data Transformers _(macOS)_
- Base16 String Encode / Decode
- Base32 String Encode / Decode
- Base64 String Encode / Decode
- Base85 String Encode / Decode
### Cryptographic Transformers _(macOS)_
- MD5, SHA-1, SHA-256, et al. Digests
> \* - **Reversible**
## Contact
Mattt ([@mattt](https://twitter.com/mattt))
## License
TransformerKit is released under the MIT license.
See the LICENSE file for more info.