В наш час мало просто писати код, його треба писати красиво і "правильно". Так як ці поняття вельми різняться від людини до людини, то в якийсь момент команди приходять до того, щоб формалізувати красивість і правильність. Деякі команди, втомившись лаятись в pull-request'ах через некрасиво оформлений код, йдуть далі та налаштовують автоматичні перевірки. Хтось навіть довіряє інстументам настільки, що дозволяє змінювати і виправляти код. У цій доповіді я розповім про бібліотеки та інструменти, метою яких є робота з кодом. Розглянемо освновні відмінності бібліотек та області їх застосування. Після доповіді ви нарешті будете відрізняти SourceKit від SourceKitten, libSwiftSyntax від Swift Syntax. http://uamobile.org/uk/topics/b%D1%96bl%D1%96oteki-ta-%D1%96nstrumenti-na-storozh%D1%96-kodu

1. On guard
of the Source Code
On guard of the Source Code, by Paul Taykalo, MacPaw 1

2. When just writing a code is not enough
On guard of the Source Code, by Paul Taykalo, MacPaw 2

3. A lot of source - not a problem
4 Code style
❓
4 Documentation
❓
4 Refactoring
❓
4 Code generation
❓
4 Error detection
❓
4 Obsfuscation
❓
On guard of the Source Code, by Paul Taykalo, MacPaw 3

4. Code Style
On guard of the Source Code, by Paul Taykalo, MacPaw 4

5. Documentation
On guard of the Source Code, by Paul Taykalo, MacPaw 5

6. Refactoring
On guard of the Source Code, by Paul Taykalo, MacPaw 6

7. Code generation
On guard of the Source Code, by Paul Taykalo, MacPaw 7

8. Error detection / Linting
On guard of the Source Code, by Paul Taykalo, MacPaw 8

9. Obfuscation
On guard of the Source Code, by Paul Taykalo, MacPaw 9

10. Processing source
On guard of the Source Code, by Paul Taykalo, MacPaw 10

11. On guard of the Source Code, by Paul Taykalo, MacPaw 11

12. Source
Obvious, we'll work with Swift and ObjC
On guard of the Source Code, by Paul Taykalo, MacPaw 12

13. Destination
On guard of the Source Code, by Paul Taykalo, MacPaw 13

14. Destination
4 Docs
4 More code!
4 Code Checks
4 Images
On guard of the Source Code, by Paul Taykalo, MacPaw 14

15. Internal Representation
On guard of the Source Code, by Paul Taykalo, MacPaw 15

16. Rules
disabled_rules: # rule identifiers to exclude from running
- colon
- comma
- control_statement
opt_in_rules: # some rules are only opt-in
- empty_count
# Find all the available rules by running:
# swiftlint rules
included: # paths to include during linting. `--path` is ignored if present.
- Source
excluded: # paths to ignore during linting. Takes precedence over `included`.
- Carthage
- Pods
- Source/ExcludedFolder
- Source/ExcludedFile.swift
- Source/*/ExcludedFile.swift # Exclude files with a wildcard
On guard of the Source Code, by Paul Taykalo, MacPaw 16

17. Tools for processing Code
On guard of the Source Code, by Paul Taykalo, MacPaw 17

18. Tools for processing Code
Regex-based solutions
4 IR: Strings
4 Somewhat unreliable
On guard of the Source Code, by Paul Taykalo, MacPaw 18

19. Tools for processing Code
Custom Parser Solutions
4 IR: (DSL)
4 Trying to parse code on its own
4 Using own AST
On guard of the Source Code, by Paul Taykalo, MacPaw 19

20. Tools for processing Code
Sourcekit based solutions
4 IR: AST, Binary, JSON*
4 Using Sourcekit library
4 Always up to date
On guard of the Source Code, by Paul Taykalo, MacPaw 20

21. SourceKit
On guard of the Source Code, by Paul Taykalo, MacPaw 21

22. SourceKit is ...
On guard of the Source Code, by Paul Taykalo, MacPaw 22

23. SourceKit is ...
On guard of the Source Code, by Paul Taykalo, MacPaw 23

24. SourcekitService is ...
On guard of the Source Code, by Paul Taykalo, MacPaw 24

25. SourceKit is...
Welcome to SourceKit! SourceKit is a framework for
supporting IDE features like indexing, syntax-coloring,
code-completion, etc. In general it provides the
infrastructure that an IDE needs for excellent language
support.
SourceKit currently only supports the Swift language.
On guard of the Source Code, by Paul Taykalo, MacPaw 25

26. SourceKit
4 Code Completion
4 Cursor Info
4 Demangling/Demangling
4 Documentation
4 Module interface generation
4 Indexing*
On guard of the Source Code, by Paul Taykalo, MacPaw 26

27. SourceKit options
4 C Interface
4 sourcekitd.framework
4 libsourcekitdInProc.dylib
4 Official Python Binding
4 Unofficial Swift Binding: SourceKitten
On guard of the Source Code, by Paul Taykalo, MacPaw 27

28. SourceKitten
On guard of the Source Code, by Paul Taykalo, MacPaw 28

29. SourceKitten
4
✅
Command Line Util
4
✅
Framework
4
✅
Wrapper over SourceKit
4
✅
Writtent in Swift
On guard of the Source Code, by Paul Taykalo, MacPaw 29

30. Tools with Sourcekitten
4
✅
SwiftLint: Swift style and conventions.
4
✅
Jazzy: Docs for Swift & Objective-C.
4
✅
Sourcery: Meta-programming for Swift
4
✅
Cuckoo: Mocking framework for Swift.
On guard of the Source Code, by Paul Taykalo, MacPaw 30

31. Tools with Sourcekitten
4
✅
SwiftyMocky: Framework for mock genertion.
4
✅
SourceKittenDaemon: Auto Completions .
4
✅
SourceDocs: Markdown documentation.
4
✅
Taylor: Measure Swift code metrics
On guard of the Source Code, by Paul Taykalo, MacPaw 31

32. SourceKitten uses
SwiftLint, which is based
on SourceKitten
On guard of the Source Code, by Paul Taykalo, MacPaw 32

33. libSyntax
On guard of the Source Code, by Paul Taykalo, MacPaw 33

34. libsyntax - C library
SwithSyntax - Swift wrapper library
On guard of the Source Code, by Paul Taykalo, MacPaw 34

35. return 1
On guard of the Source Code, by Paul Taykalo, MacPaw 35

36. http://bit.ly/2SBJtS4
On guard of the Source Code, by Paul Taykalo, MacPaw 36

37. On guard of the Source Code, by Paul Taykalo, MacPaw 37

38. libSyntax and
Sourcekit
On guard of the Source Code, by Paul Taykalo, MacPaw 38

39. Thank you
On guard of the Source Code, by Paul Taykalo, MacPaw 39

40. Q & A
On guard of the Source Code, by Paul Taykalo, MacPaw 40

41. On guard
of the Source Code
by Paul Taykalo, MacPaw
@TT_Kilew
On guard of the Source Code, by Paul Taykalo, MacPaw 41

42. Links
https://github.com/apple/swift/blob/master/tools/
SourceKit/docs/Protocol.md
https://forums.swift.org/t/speeding-up-swiftsyntax-
by-using-the-parser-directly/18493
https://academy.realm.io/posts/appbuilders-jp-
simard-sourcekit/
https://github.com/apple/swift/blob/master/tools/
On guard of the Source Code, by Paul Taykalo, MacPaw 42