Introduction to the Ash Framework Elixir Conf 2020

A declarative, resource-oriented application framework for Elixir. Currently in early alpha, targeting stable release in early 2021.

Transcript

1. Zach Daniel 09/04/2020
   A declarative, resource-oriented application framework for Elixir
   www.ash-elixir.org
   Currently in early alpha, targeting stable release in early 2021
   Ash Framework
   Introduction to the
   

   View Slide

2. The #1 solution for driving software adoption and digital
   transformation with your remote engineering team
   www.variance.com
   Your documentation dies in the dark
   

   View Slide

3. Whats the point?
   

   View Slide

4. @ashframework
   The Ash Doctrine
   Convention
   Configuration
   Procedural
   Declarative
   Customize
   Extend
   Handwrite
   Derive
   

   View Slide

5. Alpha Notice
   @ashframework
   

   View Slide

6. Example App - Helpdesk
   @ashframework
   

   View Slide

7. Example App - Helpdesk
   @ashframework
   

   View Slide

8. Add Ash Dependency
   @ashframework
   

   View Slide

9. User Resource
   @ashframework
   

   View Slide

10. User Resource
    @ashframework
    

    View Slide

11. User Resource
    @ashframework
    

    View Slide

12. User Resource
    @ashframework
    

    View Slide

13. Ticket Resource
    @ashframework
    

    View Slide

14. Ticket Resource
    @ashframework
    

    View Slide

15. Ticket Resource
    @ashframework
    

    View Slide

16. Add Relationships to User
    @ashframework
    

    View Slide

17. Configure for Postgres: User
    @ashframework
    

    View Slide

18. Configure for Postgres: User
    @ashframework
    

    View Slide

19. Configure for Postgres: User
    @ashframework
    

    View Slide

20. Migrations
    @ashframework
    

    View Slide

21. Migrations
    @ashframework
    

    View Slide

22. Migrations
    @ashframework
    

    View Slide

23. Adding Actions
    @ashframework
    

    View Slide

24. Adding Actions
    @ashframework
    

    View Slide

25. Adding Actions
    @ashframework
    

    View Slide

26. Adding Actions
    @ashframework
    

    View Slide

27. Adding Actions
    @ashframework
    

    View Slide

28. Adding Actions
    @ashframework
    

    View Slide

29. Now lets use them!
    @ashframework
    

    View Slide

30. Now lets use them!
    @ashframework
    

    View Slide

31. Creating a changeset
    @ashframework
    

    View Slide

32. Creating a changeset
    @ashframework
    

    View Slide

33. Creating a record
    

    View Slide

34. Creating a record
    

    View Slide

35. Creating a record
    

    View Slide

36. Reading It Back
    @ashframework
    

    View Slide

37. Reading It Back
    @ashframework
    

    View Slide

38. Reading It Back
    @ashframework
    

    View Slide

39. Reading It Back
    

    View Slide

40. Attribute Requirements
    @ashframework
    

    View Slide

41. Attribute Requirements
    @ashframework
    

    View Slide

42. Allow Nil and Defaults
    @ashframework
    

    View Slide

43. Allow Nil and Defaults
    @ashframework
    

    View Slide

44. Type Constraints
    @ashframework
    

    View Slide

45. Type Constraints
    @ashframework
    

    View Slide

46. Validations
    @ashframework
    

    View Slide

47. Changeset Errors
    @ashframework
    

    View Slide

48. Setting defaults
    @ashframework
    

    View Slide

49. More requirements!
    

    View Slide

50. More requirements!
    

    View Slide

51. More requirements!
    

    View Slide

52. More requirements!
    

    View Slide

53. I know what you’re thinking
    @ashframework
    

    View Slide

54. @ashframework
    

    View Slide

55. So What About the Web API?
    @ashframework
    

    View Slide

56. But What About the Web API?
    @ashframework
    

    View Slide

57. But What About the Web API?
    @ashframework
    

    View Slide

58. But What About the Web API?
    @ashframework
    

    View Slide

59. @ashframework
    

    View Slide

60. @ashframework
    

    View Slide

61. @ashframework
    

    View Slide

62. @ashframework
    

    View Slide

63. @ashframework
    

    View Slide

64. @ashframework
    

    View Slide

65. @ashframework
    

    View Slide

66. Authentication
    @ashframework
    • Not handled by Ash yet
    • An “actor” is provided on the way in
    • Eventually, extensions will likely support it
    

    View Slide

67. FakeUser plug
    @ashframework
    

    View Slide

68. Adding AshPolicyAuthorizer
    @ashframework
    

    View Slide

69. Adding our Resources
    

    View Slide

70. Adding our Resources
    

    View Slide

71. Adding our Resources
    

    View Slide

72. Adding our Resources
    

    View Slide

73. Adding our Resources
    

    View Slide

74. Adding our Resources
    

    View Slide

75. GET /api/users
    @ashframework
    

    View Slide

76. POST /api/tickets
    

    View Slide

77. POST /api/tickets
    

    View Slide

78. POST /api/tickets
    

    View Slide

79. POST /api/tickets
    

    View Slide

80. POST /api/tickets
    

    View Slide

81. More specific actions
    @ashframework
    

    View Slide

82. More specific actions
    @ashframework
    

    View Slide

83. Reacting to the Actor
    @ashframework
    • Customize changes based on the actor
    • Use policies to prevent/allow specific actors
    

    View Slide

84. Using `changes`
    @ashframework
    

    View Slide

85. Using `changes`
    @ashframework
    

    View Slide

86. Using `changes`
    @ashframework
    

    View Slide

87. Using `changes`
    @ashframework
    

    View Slide

88. Using it in code
    

    View Slide

89. Using it in code
    @ashframework
    

    View Slide

90. Using it in code
    @ashframework
    

    View Slide

91. Via the API
    @ashframework
    

    View Slide

92. Via the API
    @ashframework
    

    View Slide

93. POST /api/tickets/open?include=reporter
    

    View Slide

94. POST /api/tickets/open?include=reporter
    

    View Slide

95. POST /api/tickets/open?include=reporter
    

    View Slide

96. Editable reporter
    @ashframework
    

    View Slide

97. Editable reporter
    @ashframework
    

    View Slide

98. Using `policies`
    @ashframework
    

    View Slide

99. Using `policies`
    @ashframework
    

    View Slide

100. Using policies
     @ashframework
     

     View Slide

101. Using policies
     @ashframework
     

     View Slide

102. Using policies
     @ashframework
     

     View Slide

103. Using policies
     @ashframework
     

     View Slide

104. Using policies
     @ashframework
     

     View Slide

105. Using policies
     @ashframework
     

     View Slide

106. Using policies
     @ashframework
     

     View Slide

107. Bypass Policies
     @ashframework
     

     View Slide

108. Using policies
     @ashframework
     

     View Slide

109. Using policies
     @ashframework
     

     View Slide

110. Trying it out
     @ashframework
     

     View Slide

111. Trying it out
     @ashframework
     

     View Slide

112. Trying it out
     @ashframework
     

     View Slide

113. Trying it out
     @ashframework
     

     View Slide

114. Trying it out
     @ashframework
     

     View Slide

115. Trying it out
     @ashframework
     

     View Slide

116. Reading Tickets
     @ashframework
     

     View Slide

117. Reading Tickets
     @ashframework
     

     View Slide

118. Reading Tickets
     @ashframework
     

     View Slide

119. Reading Tickets
     @ashframework
     

     View Slide

120. Reading Tickets
     @ashframework
     

     View Slide

121. GET /api/tickets
     @ashframework
     

     View Slide

122. GET /api/tickets
     @ashframework
     

     View Slide

123. GET /api/tickets?filter[reporter]=:user_id
     @ashframework
     

     View Slide

124. GET /api/tickets?filter[reporter]=:user_id
     @ashframework
     

     View Slide

125. Filter Templates
     @ashframework
     

     View Slide

126. Filter Templates
     @ashframework
     

     View Slide

127. Filter Templates
     @ashframework
     

     View Slide

128. Access Type - filter
     @ashframework
     

     View Slide

129. GET /api/tickets
     @ashframework
     

     View Slide

130. Calculations and Aggregates
     @ashframework
     

     View Slide

131. Calculations and Aggregates
     @ashframework
     

     View Slide

132. Calculations and Aggregates
     @ashframework
     

     View Slide

133. Calculations and Aggregates
     @ashframework
     

     View Slide

134. Calculations and Aggregates
     @ashframework
     

     View Slide

135. Calculations and Aggregates
     @ashframework
     

     View Slide

136. Calculations and Aggregates
     @ashframework
     

     View Slide

137. Calculations and Aggregates
     @ashframework
     

     View Slide

138. Calculations and Aggregates
     @ashframework
     

     View Slide

139. Calculations and Aggregates
     @ashframework
     

     View Slide

140. Calculations and Aggregates
     @ashframework
     

     View Slide

141. Calculations and Aggregates
     @ashframework
     

     View Slide

142. Calculations and Aggregates
     @ashframework
     

     View Slide

143. Calculations and Aggregates
     @ashframework
     

     View Slide

144. Calculations and Aggregates
     @ashframework
     

     View Slide

145. Taking stock
     @ashframework
     • Our tickets resource has a great “open” action.
     • Authorization for reads
     • Missing more actions, e.g `close` and `respond`
     • Calculations and aggregates that can be requested by the API
     • Its all in one top level namespace
     

     View Slide

146. Multiple Apis
     @ashframework
     

     View Slide

147. Multiple Apis
     @ashframework
     

     View Slide

148. Multiple Apis
     @ashframework
     

     View Slide

149. Router
     @ashframework
     

     View Slide

150. @ashframework
     

     View Slide

151. View Slide

152. View Slide

153. But what about GraphQL?
     

     View Slide

154. AshGraphQL
     

     View Slide

155. What we missed
     • ETS, Mnesia, CSV data layers, its easy to write your own
     • Resources aren’t tables - CQRS/DDD
     • Built in tooling for extending Ash
     • Escape Hatches
     • Writing an extension is easy
     @ashframework
     

     View Slide

156. Roadmap
     • Tests, Fixes, Refactors
     • Ash GraphQL
     • Subscriptions
     • Customizations (First come, first serve)
     @ashframework
     

     View Slide

157. • Andrew Callahan @andrewcallahan
     • Mike Binns @1stAvenger
     • Paul Schoenfelder @gotbones
     • Jason Goldberger @json_louis
     • Andrew Summers @_asummers
     • Vince Herr linkedin.com/in/vincent-herr-6b12b021/
     • Cresten StClair cresten.pizza
     • Percy Hatcherson linkedin.com/in/percyhatcherson/
     • Meredith Bollinger @heymereb
     Acknowledgements
     @ashframework
     

     View Slide

158. Join the Ash Community
     • Visit the community page on www.ash-elixir.org
     • Book office hours
     • GH issues
     • Join the Slack channel and Google group
     • Follow Ash on Twitter @ashframework
     @ashframework
     

     View Slide