What's the easiest way to make Stash more useful for your team? Extend it. Get the details on how to hack Stash with merge conditions, pre- and post-receive hooks, and more from Stash full stack developer Jason Hinch.

1. #atlassian

2. Extending Stash
JASON HINCH • DEVELOPER • ATLASSIAN • @j_hinch

3. Agenda
GETTING STARTED
HOOKED ON STASH
TOO MUCH TO HANDLE
QUESTIONS & REFERENCES

4. go.atlassian.com/stashdevdocs

5. GETTING STARTED
Stash plugin 101
• In-process add-on (aka p2 plugins)
• Shares host applications resources
• OSGi bundle with
atlassian-plugin.xml
• Built on the Atlassian Platform
• Web - Filters, Servlets, Web Resources, Web Fragments
• Business - SAL, Atlassian Cache, Atlassian Scheduler
• Data - PluginSettings (SAL), ActiveObjects
• Atlassian Connect coming soon

6. Hooked on Stash
GETTING STARTED
HOOKED ON STASH
TOO MUCH TO HANDLE
QUESTIONS & REFERENCES

7. HOOKED ON STASH
Repository Hooks
• Configured per repository
• Enabled/Disabled
• Persisted settings (optional)
• Prevent pushes & merges
• Notified on successful
change

8. HOOKED ON STASH
Repository Hooks
• Examples
• Prevent tag deletion
• Commits without referenced
JIRA ticket
• Branch naming conventions
• Notify build server of new
changes
• Notify mirror to synchronize

9. Example: Naming
Convention Hook

10. HOOKED ON STASH
atlassian-plugin.xml

11. HOOKED ON STASH
atlassian-plugin.xml

12. HOOKED ON STASH
atlassian-plugin.xml

13. HOOKED ON STASH
atlassian-plugin.xml

14. HOOKED ON STASH
NamingConventionHook.java

15. HOOKED ON STASH
NamingConventionHook.java

16. HOOKED ON STASH
NamingConventionHook.java

17. HOOKED ON STASH
NamingConventionHook.java

18. HOOKED ON STASH
NamingConventionHook.java

19. HOOKED ON STASH
NamingConventionHook.java

20. HOOKED ON STASH
NamingConventionHook.java

21. HOOKED ON STASH
NamingConventionHook.java

22. HOOKED ON STASH
static/config.soy

23. HOOKED ON STASH
static/config.soy

24. HOOKED ON STASH
static/config.soy

25. HOOKED ON STASH
static/config.soy

26. HOOKED ON STASH
static/config.soy

27. Naming Convention Hook Demo

28. Naming Convention Hook Demo

29. Naming Convention Hook Demo

30. Naming Convention Hook Demo

31. Naming Convention Hook Demo

32. Naming Convention Hook Demo

33. Too much to handle
GETTING STARTED
HOOKED ON STASH
TOO MUCH TO HANDLE
QUESTIONS & REFERENCES

34. TOO MUCH TO HANDLE
File & Diff Handlers
• Front-end plugin point
• Custom rendering for any
source and diff view
• Including:
• Pull request overview
• Pull request diff
• Changeset diff
• File source & diff

35. TOO MUCH TO HANDLE
File & Diff Handlers
• Examples
• 3D models
• CSV
• PDF
• Adobe Photoshop

36. Example:
STL Handler

37. TOO MUCH TO HANDLE
atlassian-plugin.xml

38. TOO MUCH TO HANDLE
atlassian-plugin.xml

39. TOO MUCH TO HANDLE
atlassian-plugin.xml

40. TOO MUCH TO HANDLE
atlassian-plugin.xml

41. TOO MUCH TO HANDLE
stl-handler.js

42. TOO MUCH TO HANDLE
stl-handler.js

43. TOO MUCH TO HANDLE
stl-handler.js

44. TOO MUCH TO HANDLE
stl-handler.js

45. TOO MUCH TO HANDLE
stl-handler.js

46. STL Handler Demo

47. STL Handler Demo

48. Questions?
GETTING STARTED
HOOKED ON STASH
TOO MUCH TO HANDLE
QUESTIONS & REFERENCES

49. QUESTIONS & REFERENCES
References
• Documentation - http://go.atlassian.com/stashdevdocs
• Repository hook example - https://bitbucket.org/atlassianlabs/stash-naming-convention-
hook-plugin
• File handler example - https://bitbucket.org/atlassian/stash-stl-plugin/

50. Thank you!
JASON HINCH • DEVELOPER • ATLASSIAN • @j_hinch