Building Extensions - best practises

SpreeConf 2014 Lightning talk.

Transcript

1. Building Extensions best practises ! Peter Berkenbosch
2. Unix philosophy building short, simple, clear, modular, and extendable code that can be easily maintained and repurposed by developers other than its creators.
3. Documentation
4. Modular
5. OOP
6. Extension as “Model”
7. Models Views Controllers Assets Overrides Rails::Engine Spree other 3rd party gems extension
8. Looks familier! Rails anyone?!
9. Outside In
10. Models Views Controllers Assets Overrides Rails::Engine Spree other 3rd party gems extension
11. Test the “interface” can be just an API
12. Drives Quality
13. Self documenting
14. gem install spree_cmd
15. spree extension
16. git clone spree
17. rake sandbox
18. spree extension
19. module SpreeSales! class Engine < Rails::Engine! require 'spree/core'! isolate_namespace Spree! engine_name 'spree_sales'! ! # use rspec for tests! config.generators do |g|! g.test_framework :rspec! end! ! def self.activate! Dir.glob(File.join(File.dirname(__FILE__), '../../app/**/*_decorator*.rb')) do |c|! Rails.configuration.cache_classes ? require(c) : load(c)! end! end! ! config.to_prepare &method(:activate).to_proc! end! end
20. Spree Testing Support
21. Usual suspect rspec capybara factory_girl
22. # Requires factories defined in spree_core! require 'spree/testing_support/factories'! require 'spree/testing_support/controller_requests'! require 'spree/testing_support/authorization_helpers'! require 'spree/testing_support/url_helpers'
23. Red - Green - Refacor Repeat
24. Nothing new. TDD / BDD …
25. Extending Spree
26. class_evil Looking at adding durable_decorator
27. Deface for small changes
28. override view file for the more complex customisations
29. Deface-able views ! for easy overriding the overrides.
30. github.com/spree/spree_ Inspiration and collaboration!