Пишем скрипты на Swift

https://youtu.be/vq_PM1DTpIk?t=5053

Transcript

1. Пишем скрипты на Swift Руслан Кавецкий
2. Однажды в… одном проекте 2
3. UI VIPER + Swift ‐ Data Objective-C 3
4. Мои ожидания struct PromoModel: Codable { let name: String let pictureUrl: URL? let amount: Int } 4
5. Реальность ! @interface PromoModel: NSObject <NSCoding> @property (nonatomic, readonly, copy, nonnull) NSString * name; @property (nonatomic, readonly, strong, nullable) NSURL * pictureUrl; @property (nonatomic, readonly, assign) NSInteger amount; - (nonnull instancetype)initWithName:(nonnull NSString *)name pictureUrl:(nullable NSURL *)pictureUrl amount:(NSInteger)amount; @end static NSString *const kPromoModelName = @"PromoModel.name"; static NSString *const kPromoModelPictureUrl = @"PromoModel.pictureUrl"; static NSString *const kPromoModelAmount = @"PromoModel.amount"; @implementation PromoModel - (nonnull instancetype)initWithName:(nonnull NSString *)name pictureUrl:(nullable NSURL *)pictureUrl amount:(NSInteger)amount { self = [super init]; if (self) { _name = [name copy]; _pictureUrl = pictureUrl; _amount = amount; } return self; } - (nullable instancetype)initWithCoder:(NSCoder *)decoder { self = [super init]; if (self) { _name = [decoder decodeObjectForKey:kPromoModelName]; _pictureUrl = [decoder decodeObjectForKey:kPromoModelPictureUrl]; _amount = [decoder decodeIntegerForKey:kPromoModelAmount]; } return self; } - (void)encodeWithCoder:(NSCoder *)coder { [coder encodeObject:_name forKey:kPromoModelName]; [coder encodeObject:_pictureUrl forKey:kPromoModelPictureUrl]; [coder encodeInteger:_amount forKey:kPromoModelAmount]; } @end 5
6. [coder encodeObject:_name forKey:kPromoModelName]; [coder encodeObject:_pictureUrl forKey:kPromoModelPictureUrl]; [coder encodeInteger:_amount forKey:kPromoModelAmount]; 6
7. Идеальная задача, чтобы её не делать • Скучная • Повторяющаяся • Легко допустить ошибку 7
8. Скрипты 8
9. Что такое скрипт? • Нет графического интерфейса • Запускается из командной строки • Обычно один файл 9
10. На чём обычно пишут? • Bash • Ruby • Python • JavaScript • Kotlin Script ! 10
11. Почему Swift? 11
12. Вы уже его знаете ! • Знакомое API Foundation, URLSession, FileManager, etc • Привычные инструменты Xcode, Instruments • Меньшее переключение контекстов Тут Swift, там Swift 12
13. !"# Ваша команда знает Swift 13
14. !"# • Меньший бас фактор для скриптового кода • Проще поддерживать • Меньше зависимостей от других языков 14
15. А зачем это мне? ! • Новые классы и библиотеки • Любая архитектура и другие подходы • Не продакшен код • Можно писать в VIM или блокноте • Не надо верстать вьюшки ! 15
16. Технические плюсы • Быстрый ⚡ • Статическая типизация " • Современный синтакс # • Open Source, но поддерживается Apple 16
17. Я не знаю Swift ! • Отличный способ начать писать на нём • Можно учить язык без привязки к платформе и операционной системе • Первые шаги в сторону iOS разработки 17
18. Swift не всегда лучший вариант для любой задачи 18
19. Как начать? 19
20. Запускаем через REPL $ echo 'print("Hello, Script!")' > script.swift $ swift script.swift Hello, Script! 20
21. Добавляем немного магии #!/usr/bin/swift print("Hello, Script!") 21
22. Добавляем немного магии #!/usr/bin/swift print("Hello, Script!") Ещё чуть-чуть $ mv script.swift script $ chmod +x script $ ./script 22
23. $ swift script.swift ‑ $ ./script 23
24. Зависимости 24
25. CocoaPods? 25
26. "CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects" — cocoapods.org 26
27. Carthage? 27
28. "The simplest way to add frameworks to your Cocoa application" — github.com/Carthage/Carthage 28
29. ! 29
30. Динамические фреймворки Имеют расширение .framework Подключаются через флаг -F Для исходного кода $ swift -F Frameworks myScript.swift Можно запустить REPL с дополнительными фреймворками $ swift -F Frameworks 30
31. Динамические фреймворки Имеют расширение .framework Для скомпилированного скрипта добавляем путь к фреймворкам через утилиту install_name_tool $ install_name_tool \ -add_rpath "@executable_path/../Frameworks/" \ myScript ../Frameworks — относительный путь к папке с фреймворками myScript — исполняемый файл скрипта 31
32. Динамические фреймворки • Сложно подключать • Нужно распространять вместе с файлом скрипта ! 32
33. Статические библиотеки Имеют расширение .a • Код библиотеки копируется в исполняемый файл во время компиляции • Чтобы правильно собрать скрипт, понадобится Xcode 33
34. «Чёт сложные ваши скрипты» — Кто-то в зале 34
35. Swift Package Manager 35
36. Делаем ручками $ swift package init --type executable 36
37. // swift-tools-version:5.1 import PackageDescription let package = Package( name: "Script", dependencies: [ .package(url: "https://github.com/Alamofire/Alamofire.git", from: "4.0") ], targets: [ .target( name: "Script", dependencies: ["Alamofire"]) ] ) 37
38. Команды Обновляем зависимости $ swift package update Запускаем $ swift run Собираем $ swift build Генерируем Xcode проект swift package generate-xcodeproj 38
39. Xcode 11 • File → New → Project → macOS → Command Line Tool • File → Swift Packages → Add Package Dependency... 39
40. «А можно как-то ещё попроще?» — Тот же человек из зала 40
41. swift-sh github.com/mxcl/swift-sh 41
42. $ brew install mxcl/made/swift-sh 42
43. #!/usr/bin/swift sh import Foundation import Alamofire // @Alamofire ~> 4.0 request("ya.ru").response { print(response) } 43
44. $ chmod +x network.swift $ ./network.swift $ 44
45. $ chmod +x network.swift $ ./network.swift $ $ 45
46. $ chmod +x network.swift $ ./network.swift $ $ $ 46
47. RunLoop.main.run() 47
48. ⏳ RunLoop.main.run(until: Date() + 3) 48
49. #!/usr/bin/swift sh import Foundation import Alamofire // @Alamofire ~> 4.0 request("ya.ru").response { print(response) exit(0) } RunLoop.main.run() 49
50. Типичные задачи 50
51. ! Читаем аргументы 51
52. $ swift --version 52
53. • CommandLine CommandLine.arguments.contains("--version") • Commandant github.com/Carthage/Commandant • Commander github.com/kylef/Commander 53
54. ! Ходим в сеть 54
55. • Alamofire, Moya • URLSession, Network framework • Data(contentsOf:) 55
56. let url = URL(string: "http://api.slack.com/messages/42") let jsonData = Data(contentsOf: url) let message = JSONDecoder().decode(Message.self, from: jsonData) 56
57. ⚠ Data(contentsOf:) синхронная операция Вызов RunLoop.main.run() не нужен 57
58. ! Ходим в файловую систему 58
59. • FileManager • Files github.com/JohnSundell/Files • PathKit github.com/kylef/PathKit • FileKit github.com/nvzqz/FileKit 59
60. ! Ходим в базу данных 60
61. • PostgresQL github.com/IBM-Swift/Swift-Kuery-PostgreSQL github.com/PerfectlySoft/Perfect-PostgreSQL • SQLite github.com/stephencelis/SQLite.swift • MongoDB github.com/mongodb/mongo-swift-driver 61
62. ! Пишем в консоль 62
63. print 63
64. ! 64
65. Пишем в стандартный error stream • fputs • print • TextOutputStream • FileHandle 65
66. fputs fputs("Hello, error", stderr) stderr — глобальная переменная, указывающая на стандартный поток ошибок 66
67. print + fputs struct StderrOutputStream: TextOutputStream { mutating func write(_ string: String) { fputs(string, stderr) } } var standardError = StderrOutputStream() print("Error!", to: &standardError) 67
68. FileHandle let errorFileHandle = FileHandle.standardError let error = "Something went wrong" errorFileHandle.write(error.data(using: .utf8)) 68
69. ! Пишем цветом 69
70. github.com/onevcat/Rainbow github.com/paulot/Colors github.com/mxcl/Chalk github.com/jdhealy/PrettyColors 70
71. Взаимодействуем с остальным миром 71
72. ! Shellout github.com/JohnSundell/ShellOut 72
73. try shellOut(to: "mkdir", arguments: ["~/Projects/Scripts"]) try shellOut(to: "mkdir Scripts", at: "~/Projects") try shellOut( to: [ "mkdir ~/Projects/Scripts", "cd ~/Projects/Scripts", "touch script.swift"]) 73
74. Готовые команды ! try shellOut(to: .gitCommit(message: "A scripted commit!")) try shellOut(to: .readFile(at: "Podfile")) try shellOut(to: .buildSwiftPackage()) try shellOut(to: .runFastlane(usingLane: "appstore")) try shellOut(to: .updateCocoaPods()) 74
75. Что со всем этим можно сделать 75
76. $ swift-objc-gen \ models.txt \ -output Sources/Models 76
77. $ swift-objc-gen \ models.txt \ -output Sources/Models • Читаю аргументы • Читаю файл models.txt • Генерирую Objective-C код • Записываю код в файлы в папке Sources/Models 77
78. ! models.txt PromoModel name:String:nonnull pictureUrl:NSURL*:nullable amount:Int UserModel name:String:nonnull id:Int addresses:Array<AddressModel*>:nonnull email:Email:nullable 78
79. Sources/ Models/ PromoModel.h PromoModel.m UserModel.h UserModel.m 79
80. "You can replace make or rake files with code written in Swift!" — yonaskolb/Beak 80
81. // beak: kylef/PathKit @ 1.0.0 import PathKit import Foundation /// Releases the product /// - Parameters: /// - version: the version to release public func release(version: String) { // implementation here print("version \(version) released!") } /// Installs the product public func install() { // implementation here } 81
82. $ beak list release: Releases the product install: Installs the product $ beak run release --version 1.2.0 version 1.2.0 released! 82
83. John Sundell Plot DSL язык для генерации HTML, XML и RSS Splash Инструмент подсветки синтаксиса Swift TestDrive Возможность попробовать любой фреймворк в одну строчку кода Ink Парсер Markdown файлов 83
84. Пишите скрипты на Swift • Swift — крутой современный язык • Вы и ваша команда его знаете • Начать очень просто • Библиотек много и становится всё больше Руслан Кавецкий @pycuk 84