swifterate 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: 8e9f4cf722962659b824d981deb085b5e28bf7fe
4
+ data.tar.gz: 86abd2c89afc2ec23820d402ff98fe685eebb84b
5
+ SHA512:
6
+ metadata.gz: b6f1d30edeaa51d9a613b6a477be76cef08430d3e413e5159ebeeea23be6242276065eb4977aa99e71e3364e8d20c46b9c3380bf2fe0f0e087ad898d91f0f445
7
+ data.tar.gz: 8af47272a07544b20a1996dd97f23f2d5ab86e3928552ee223e46051302f4d6d608609ff53e2ed45f06578857cea1dbe5d11c6000aa152b38bfba820f20dd244
data/.gitignore ADDED
@@ -0,0 +1,9 @@
1
+ /.bundle/
2
+ /.yardoc
3
+ /Gemfile.lock
4
+ /_yardoc/
5
+ /coverage/
6
+ /doc/
7
+ /pkg/
8
+ /spec/reports/
9
+ /tmp/
data/Gemfile ADDED
@@ -0,0 +1,4 @@
1
+ source 'https://rubygems.org'
2
+
3
+ # Specify your gem's dependencies in swifterate.gemspec
4
+ gemspec
data/LICENSE.txt ADDED
@@ -0,0 +1,21 @@
1
+ The MIT License (MIT)
2
+
3
+ Copyright (c) 2015 Mike Enriquez
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
data/README.md ADDED
@@ -0,0 +1,144 @@
1
+ # Swifterate
2
+
3
+ Swift code generator. Generate strongly typed enums based on your Info.plist and Asset Catalog. No more magic strings!
4
+
5
+ ## Installation
6
+
7
+ Swifterate is distributed as a Ruby gem.
8
+
9
+ ```bash
10
+ $ gem install swifterate
11
+ ```
12
+
13
+ ## Usage
14
+
15
+ After installing, the `swifterate` command is available:
16
+
17
+ ```bash
18
+ $ swifterate help
19
+ Commands:
20
+ swifterate ac DIR # Generate Swift code from an Asset Catalog directory located at DIR
21
+ swifterate help [COMMAND] # Describe available commands or one specific command
22
+ swifterate plist FILE # Generate Swift code from the .plist file located at FILE
23
+ ```
24
+
25
+ The generated Swift code is printed to the console. You can redirect the output to a file instead:
26
+
27
+ ```bash
28
+ $ swifterate plist test/fixtures/Info.plist > InfoPlist.swift
29
+ ```
30
+
31
+ ## Examples
32
+
33
+ Swifterate currently supports `.plist` and `.xcassets` as inputs to generate Swift code.
34
+
35
+ ### .plist to Swift Enum
36
+
37
+ Generate a swift enum from the following MyApp-Info.plist file:
38
+
39
+ ```xml
40
+ <?xml version="1.0" encoding="UTF-8"?>
41
+ <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
42
+ <plist version="1.0">
43
+ <dict>
44
+ <key>CFBundleName</key>
45
+ <string>MyApp</string>
46
+ <key>CFBundleShortVersionString</key>
47
+ <string>1.0.0</string>
48
+ <key>CFBundleVersion</key>
49
+ <string>100</string>
50
+ </dict>
51
+ </plist>
52
+ ```
53
+
54
+ The following is generated with the command: `swifterate plist MyApp-Info.plist`
55
+
56
+ ```swift
57
+ enum InfoPlist: String {
58
+
59
+ case CFBundleName = "CFBundleName"
60
+ case CFBundleShortVersionString = "CFBundleShortVersionString"
61
+ case CFBundleVersion = "CFBundleVersion"
62
+
63
+ private var infoDictionary: [NSObject : AnyObject] {
64
+ return NSBundle.mainBundle().infoDictionary!
65
+ }
66
+
67
+ var dictionary: [NSObject : AnyObject] {
68
+ return infoDictionary[rawValue] as! [NSObject : AnyObject]
69
+ }
70
+
71
+ var array: [AnyObject] {
72
+ return infoDictionary[rawValue] as! [AnyObject]
73
+ }
74
+
75
+ var data: NSData {
76
+ return infoDictionary[rawValue] as! NSData
77
+ }
78
+
79
+ var date: NSDate {
80
+ return infoDictionary[rawValue] as! NSDate
81
+ }
82
+
83
+ var number: NSNumber {
84
+ return infoDictionary[rawValue] as! NSNumber
85
+ }
86
+
87
+ var string: String {
88
+ return infoDictionary[rawValue] as! String
89
+ }
90
+
91
+
92
+ init(_ key: InfoPlist) {
93
+ self = key
94
+ }
95
+
96
+ }
97
+ ```
98
+
99
+ To use the generated enum:
100
+
101
+ ```swift
102
+ let appName = InfoPlist(.CFBundleName).string // "MyApp"
103
+ ```
104
+
105
+ ### Asset Catalog to UIImage Extension
106
+
107
+ Generate a `UIImage` extension with an enumerated list of assets from the Asset Catalog:
108
+
109
+ ```bash
110
+ MyApp.xcassets/
111
+ AppIcon.appiconset/
112
+ LaunchImage.launchimage/
113
+ MyAppLogo.imageset/
114
+ PrimaryButton.imageset/
115
+ ```
116
+
117
+ The following is generated with the command: `swifterate ac MyApp.xcassets`
118
+
119
+ ```swift
120
+ extension UIImage {
121
+
122
+ enum MyAppAsset: String {
123
+ case MyAppLogo = "MyAppLogo"
124
+ case PrimaryButton = "PrimaryButton"
125
+ }
126
+
127
+ convenience init!(assetIdentifier: MyAppAsset) {
128
+ self.init(named: assetIdentifier.rawValue)
129
+ }
130
+
131
+ }
132
+ ```
133
+
134
+ Notice that the `AppIcon` and `LaunchImage` aren't included. They cannot be referenced using `UIImage(imageNamed:)`
135
+
136
+ To use the generated extension:
137
+
138
+ ```swift
139
+ let myAppLogo = UIImage(assetIdentifier: .MyAppLogo)
140
+ ```
141
+
142
+ ## License
143
+
144
+ Swifterate is available under the MIT license. See the LICENSE file for more info.
data/Rakefile ADDED
@@ -0,0 +1,7 @@
1
+ require "bundler/gem_tasks"
2
+ require "rake/testtask"
3
+
4
+ Rake::TestTask.new do |t|
5
+ t.libs << "test"
6
+ t.pattern = "test/test_*.rb"
7
+ end
data/bin/console ADDED
@@ -0,0 +1,14 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require "bundler/setup"
4
+ require "swifterate"
5
+
6
+ # You can add fixtures and/or initialization code here to make experimenting
7
+ # with your gem easier. You can also use a different console, if you like.
8
+
9
+ # (If you use this, don't forget to add pry to your Gemfile!)
10
+ # require "pry"
11
+ # Pry.start
12
+
13
+ require "irb"
14
+ IRB.start
data/bin/setup ADDED
@@ -0,0 +1,7 @@
1
+ #!/bin/bash
2
+ set -euo pipefail
3
+ IFS=$'\n\t'
4
+
5
+ bundle install
6
+
7
+ # Do any other automated setup that you need to do here
data/exe/swifterate ADDED
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require 'swifterate/cli'
4
+
5
+ Swifterate::CLI.start
data/lib/swifterate.rb ADDED
@@ -0,0 +1,6 @@
1
+ require "swifterate/version"
2
+ require "swifterate/plist"
3
+ require "swifterate/asset_catalog"
4
+
5
+ module Swifterate
6
+ end
@@ -0,0 +1,29 @@
1
+ require 'pathname'
2
+
3
+ module Swifterate
4
+ class AssetCatalog
5
+
6
+ CATALOG_EXTENSION = ".xcassets"
7
+ ASSET_EXTENSION = ".imageset"
8
+
9
+ def initialize(directory)
10
+ directory = Pathname.new(directory)
11
+ @catalog_name = directory.basename(CATALOG_EXTENSION).to_s
12
+ @asset_dirs = directory.children.select { |dir| dir.directory? && dir.extname == ASSET_EXTENSION }
13
+ end
14
+
15
+ def assets
16
+ @asset_dirs.map { |dir| dir.basename(ASSET_EXTENSION).to_s }
17
+ end
18
+
19
+ def members
20
+ Helper.enum_members(assets)
21
+ end
22
+
23
+ def swift_extension(name = @catalog_name + "Asset")
24
+ template_file = File.join(File.dirname(__FILE__), 'templates/UIImageExtensions.swift.mustache')
25
+ Mustache.render(File.read(template_file), name: name, members: members)
26
+ end
27
+
28
+ end
29
+ end
@@ -0,0 +1,20 @@
1
+ require 'thor'
2
+ require 'swifterate/generator'
3
+
4
+ module Swifterate
5
+ class CLI < Thor
6
+
7
+ desc "plist FILE", "Generate Swift code from the .plist file located at FILE"
8
+ method_option :name, :type => :string, :desc => "The resuling Swift enum name. Defaults to InfoPlist"
9
+ def plist(input)
10
+ Generator.plist(File.expand_path(input), options[:name])
11
+ end
12
+
13
+ desc "ac DIR", "Generate Swift code from an Asset Catalog directory located at DIR"
14
+ method_option :name, :type => :string, :desc => "The resuling Swift enum name. Defaults to <Asset Catalog Name>Asset"
15
+ def ac(input)
16
+ Generator.ac(File.expand_path(input), options[:name])
17
+ end
18
+
19
+ end
20
+ end
@@ -0,0 +1,28 @@
1
+ require 'swifterate/plist'
2
+ require 'swifterate/asset_catalog'
3
+
4
+ module Swifterate
5
+ class Generator
6
+
7
+ def self.plist(input, name = nil)
8
+ plist = PList.new(input)
9
+
10
+ if name
11
+ puts plist.swift_enum(name)
12
+ else
13
+ puts plist.swift_enum
14
+ end
15
+ end
16
+
17
+ def self.ac(input, name = nil)
18
+ asset_catalog = AssetCatalog.new(input)
19
+
20
+ if name
21
+ puts asset_catalog.swift_extension(name)
22
+ else
23
+ puts asset_catalog.swift_extension
24
+ end
25
+ end
26
+
27
+ end
28
+ end
@@ -0,0 +1,15 @@
1
+ module Swifterate
2
+ class Helper
3
+
4
+ def self.enum_members(key_list)
5
+ key_list.map { |key| { member_name: sanitize_swift_member(key), key: key } }
6
+ end
7
+
8
+ private
9
+
10
+ def self.sanitize_swift_member(key)
11
+ key.gsub(/[^a-z0-9_]/i, '')
12
+ end
13
+
14
+ end
15
+ end
@@ -0,0 +1,27 @@
1
+ require 'cfpropertylist'
2
+ require 'mustache'
3
+ require 'swifterate/helper'
4
+
5
+ module Swifterate
6
+ class PList
7
+
8
+ def initialize(file)
9
+ plist = CFPropertyList::List.new(file: file)
10
+ @data = CFPropertyList.native_types(plist.value)
11
+ end
12
+
13
+ def keys
14
+ @data.keys
15
+ end
16
+
17
+ def members
18
+ Helper.enum_members(keys)
19
+ end
20
+
21
+ def swift_enum(name = "InfoPlist")
22
+ template_file = File.join(File.dirname(__FILE__), 'templates/InfoPlist.swift.mustache')
23
+ Mustache.render(File.read(template_file), name: name, members: members)
24
+ end
25
+
26
+ end
27
+ end
@@ -0,0 +1,40 @@
1
+ enum {{ name }}: String {
2
+
3
+ {{#members}}
4
+ case {{member_name}} = "{{key}}"
5
+ {{/members}}
6
+
7
+ private var infoDictionary: [NSObject : AnyObject] {
8
+ return NSBundle.mainBundle().infoDictionary!
9
+ }
10
+
11
+ var dictionary: [NSObject : AnyObject] {
12
+ return infoDictionary[rawValue] as! [NSObject : AnyObject]
13
+ }
14
+
15
+ var array: [AnyObject] {
16
+ return infoDictionary[rawValue] as! [AnyObject]
17
+ }
18
+
19
+ var data: NSData {
20
+ return infoDictionary[rawValue] as! NSData
21
+ }
22
+
23
+ var date: NSDate {
24
+ return infoDictionary[rawValue] as! NSDate
25
+ }
26
+
27
+ var number: NSNumber {
28
+ return infoDictionary[rawValue] as! NSNumber
29
+ }
30
+
31
+ var string: String {
32
+ return infoDictionary[rawValue] as! String
33
+ }
34
+
35
+
36
+ init(_ key: {{ name }}) {
37
+ self = key
38
+ }
39
+
40
+ }
@@ -0,0 +1,13 @@
1
+ extension UIImage {
2
+
3
+ enum {{name}}: String {
4
+ {{#members}}
5
+ case {{member_name}} = "{{key}}"
6
+ {{/members}}
7
+ }
8
+
9
+ convenience init!(assetIdentifier: {{name}}) {
10
+ self.init(named: assetIdentifier.rawValue)
11
+ }
12
+
13
+ }
@@ -0,0 +1,3 @@
1
+ module Swifterate
2
+ VERSION = "0.1.0"
3
+ end
@@ -0,0 +1,28 @@
1
+ # coding: utf-8
2
+ lib = File.expand_path('../lib', __FILE__)
3
+ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
4
+ require 'swifterate/version'
5
+
6
+ Gem::Specification.new do |spec|
7
+ spec.name = "swifterate"
8
+ spec.version = Swifterate::VERSION
9
+ spec.authors = ["Mike Enriquez"]
10
+ spec.email = ["mike@enriquez.me"]
11
+
12
+ spec.summary = %q{Swift code generator.}
13
+ spec.description = %q{Swift code generator. Generate strongly typed enums based on your Info.plist and Asset Catalog. No more magic strings!}
14
+ spec.homepage = "https://github.com/enriquez/swifterate"
15
+ spec.license = "MIT"
16
+
17
+ spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
18
+ spec.bindir = "exe"
19
+ spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
20
+ spec.require_paths = ["lib"]
21
+
22
+ spec.add_development_dependency "bundler", "~> 1.9"
23
+ spec.add_development_dependency "rake", "~> 10.0"
24
+
25
+ spec.add_dependency "CFPropertyList", "~> 2.3"
26
+ spec.add_dependency "thor", "~> 0.19"
27
+ spec.add_dependency "mustache", "~> 1.0"
28
+ end
metadata ADDED
@@ -0,0 +1,134 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: swifterate
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Mike Enriquez
8
+ autorequire:
9
+ bindir: exe
10
+ cert_chain: []
11
+ date: 2015-06-21 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: bundler
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - "~>"
18
+ - !ruby/object:Gem::Version
19
+ version: '1.9'
20
+ type: :development
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - "~>"
25
+ - !ruby/object:Gem::Version
26
+ version: '1.9'
27
+ - !ruby/object:Gem::Dependency
28
+ name: rake
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - "~>"
32
+ - !ruby/object:Gem::Version
33
+ version: '10.0'
34
+ type: :development
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - "~>"
39
+ - !ruby/object:Gem::Version
40
+ version: '10.0'
41
+ - !ruby/object:Gem::Dependency
42
+ name: CFPropertyList
43
+ requirement: !ruby/object:Gem::Requirement
44
+ requirements:
45
+ - - "~>"
46
+ - !ruby/object:Gem::Version
47
+ version: '2.3'
48
+ type: :runtime
49
+ prerelease: false
50
+ version_requirements: !ruby/object:Gem::Requirement
51
+ requirements:
52
+ - - "~>"
53
+ - !ruby/object:Gem::Version
54
+ version: '2.3'
55
+ - !ruby/object:Gem::Dependency
56
+ name: thor
57
+ requirement: !ruby/object:Gem::Requirement
58
+ requirements:
59
+ - - "~>"
60
+ - !ruby/object:Gem::Version
61
+ version: '0.19'
62
+ type: :runtime
63
+ prerelease: false
64
+ version_requirements: !ruby/object:Gem::Requirement
65
+ requirements:
66
+ - - "~>"
67
+ - !ruby/object:Gem::Version
68
+ version: '0.19'
69
+ - !ruby/object:Gem::Dependency
70
+ name: mustache
71
+ requirement: !ruby/object:Gem::Requirement
72
+ requirements:
73
+ - - "~>"
74
+ - !ruby/object:Gem::Version
75
+ version: '1.0'
76
+ type: :runtime
77
+ prerelease: false
78
+ version_requirements: !ruby/object:Gem::Requirement
79
+ requirements:
80
+ - - "~>"
81
+ - !ruby/object:Gem::Version
82
+ version: '1.0'
83
+ description: Swift code generator. Generate strongly typed enums based on your Info.plist
84
+ and Asset Catalog. No more magic strings!
85
+ email:
86
+ - mike@enriquez.me
87
+ executables:
88
+ - swifterate
89
+ extensions: []
90
+ extra_rdoc_files: []
91
+ files:
92
+ - ".gitignore"
93
+ - Gemfile
94
+ - LICENSE.txt
95
+ - README.md
96
+ - Rakefile
97
+ - bin/console
98
+ - bin/setup
99
+ - exe/swifterate
100
+ - lib/swifterate.rb
101
+ - lib/swifterate/asset_catalog.rb
102
+ - lib/swifterate/cli.rb
103
+ - lib/swifterate/generator.rb
104
+ - lib/swifterate/helper.rb
105
+ - lib/swifterate/plist.rb
106
+ - lib/swifterate/templates/InfoPlist.swift.mustache
107
+ - lib/swifterate/templates/UIImageExtensions.swift.mustache
108
+ - lib/swifterate/version.rb
109
+ - swifterate.gemspec
110
+ homepage: https://github.com/enriquez/swifterate
111
+ licenses:
112
+ - MIT
113
+ metadata: {}
114
+ post_install_message:
115
+ rdoc_options: []
116
+ require_paths:
117
+ - lib
118
+ required_ruby_version: !ruby/object:Gem::Requirement
119
+ requirements:
120
+ - - ">="
121
+ - !ruby/object:Gem::Version
122
+ version: '0'
123
+ required_rubygems_version: !ruby/object:Gem::Requirement
124
+ requirements:
125
+ - - ">="
126
+ - !ruby/object:Gem::Version
127
+ version: '0'
128
+ requirements: []
129
+ rubyforge_project:
130
+ rubygems_version: 2.4.5
131
+ signing_key:
132
+ specification_version: 4
133
+ summary: Swift code generator.
134
+ test_files: []