storyblok 2.0.5 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4f7ee7dc39a1457adae80294bbe0606e0ee99ea38f5e1c7608ef2f1ef13b8fb
-  data.tar.gz: 1177742ae270a639988a06cbaca3612d2c7b298a521b7614469f17bbb716e787
+  metadata.gz: 33a4596358cf0ba305669f743c068507e4101df1ef108489220aea87ab080a10
+  data.tar.gz: 39d281b937424cc102f5aed916e5b49ec139fa57991d0bdf033d2dcd3a7e6cce
 SHA512:
-  metadata.gz: 0a373ba20c6107ee1b2b1a767bcaef8f387c1b734566710d38304bb2585e4860224eeeca6c39d9bd16f2ae2706241236e168d757fabb1d298bd601029cff66f9
-  data.tar.gz: d6f1bbfe69648f4dd3130caa7fde6542ecfcc27021f118d65c5af3c9a1a8a61111729255c8b2a23c740881efb402b303ffdb77b69351af74c1a7b1c212da0dc3
+  metadata.gz: 15b2d39171573e27f50353dfb643930b7c8cf2b8c57ed00576c5b58ffad967376b199635aacabfb37363580bcce5df9dc7e878f56a79182cfe4017ee7f606545
+  data.tar.gz: 99271032e787a4d40270692800c95e8b7b2d2419ced123ea022d4e67436d0937d11477beac638449421cf1dbdde624cf771dd785a535b8c6c22d4709eab8337e

data/.gitignore

@@ -6,3 +6,4 @@ Gemfile.lock
 .idea
 *.DS_Store
 .ruby-version
+*.gem

data/Gemfile

@@ -3,3 +3,4 @@ source 'https://rubygems.org'
 gemspec
 
 gem 'redis'
+gem 'storyblok-richtext-renderer'

data/README.md

@@ -27,7 +27,7 @@ client = Storyblok::Client.new(token: 'YOUR_TOKEN')
 
 # Optionally set a cache client
 redis = Redis.new(url: 'redis://localhost:6379')
-cache = Storyblok::Cache::Redis.new(redis: Redis.current)
+cache = Storyblok::Cache::Redis.new(redis: redis)
 client = Storyblok::Client.new(cache: cache, token: 'YOUR_TOKEN')
 
 # Get a story
@@ -141,6 +141,48 @@ client.put("spaces/{space_id}/stories/{story_id}", {story: {name: 'new', slug: "
 client.delete("spaces/{space_id}/stories/{story_id}")
 ```
 
+## Rendering of richtext fields
+
+This SDK comes with a rendering service for richtext fields of Storyblok to get html output.
+
+### Rendering a richtext field
+
+```ruby
+client.render(data.richtext_field)
+```
+
+### Define a component renderer
+
+Storyblok's richtext field also let's you insert content blocks. To render these blocks you can define a Lambda.
+
+```ruby
+# Option 1: Define the resolver when initializing
+client = Storyblok::Client.new(
+  component_resolver: ->(component, data) => {
+    case component
+    when 'button'
+      "<button>#{data['text']}</button>"
+    when 'your_custom_component'
+      "<div class="welcome">#{data['welcome_text']}</div>"
+    end
+  }
+)
+
+# Option 2: Define the resolver afterwards
+client.set_component_resolver(->(component, data) {
+  "#{component}"
+})
+```
+
+### Contribute
+
+How to build a gem file.
+
+~~~
+gem build storyblok.gemspec
+gem push storyblok-2.0.X.gem
+~~~
+
 
 ### License
 

data/examples/example_queries.rb

@@ -5,14 +5,14 @@ require 'storyblok'
 logger = Logger.new(STDOUT)
 
 client = Storyblok::Client.new(
-  token: 'FtyUE8zLpZox3ptNYz3dgQtt',
+  token: 't618GfLe1YHICBioAHnMrwtt',
   api_url: 'localhost:3001',
   secure: false,
   logger: logger
 )
 
-p client.datasources
 p client.stories(starts_with: 'en/news')
 p client.story('demo1')
 p client.datasource_entries(datasource: 'labels', per_page: 10)
 p client.links
+p client.datasources

data/examples/renderer.rb

@@ -0,0 +1,31 @@
+# bundle exec ruby examples/renderer.rb
+
+require_relative '../lib/storyblok'
+require 'redis'
+
+logger = Logger.new(STDOUT)
+
+redis = Redis.new(url: 'redis://localhost:6379')
+cache = Storyblok::Cache::Redis.new(redis: redis)
+
+client = Storyblok::Client.new(
+  token: '6HMYdAjBoONyuS6GIf5PdAtt',
+  logger: logger,
+  component_resolver: ->(component, data) {
+    "Placeholder for #{component}: #{data['text']}"
+  },
+  api_url: 'api-testing.storyblok.com',
+  api_version: 2,
+  cache: cache
+)
+
+
+res = client.flush
+res = client.story('authors/page', {version: 'published'})
+puts client.cache_version
+res = client.story('authors/page', {version: 'published'})
+res = client.story('authors/page', {version: 'published'})
+res = client.story('authors/page', {version: 'published'})
+
+puts res['data']
+#puts client.render(res['data']['story']['content']['intro'])

data/lib/storyblok/client.rb

@@ -1,6 +1,7 @@
 require_relative 'request'
 require_relative 'links'
 
+require 'storyblok/richtext'
 require 'rest-client'
 require 'logger'
 require 'base64'
@@ -15,21 +16,24 @@ module Storyblok
       logger: false,
       log_level: Logger::INFO,
       version: 'draft',
-      cache_version: Time.now.to_i,
-      cache: nil,
+      component_resolver: ->(component, data) { '' },
+      cache: nil
     }
 
     attr_reader :configuration, :logger
+    attr_accessor :cache_version
 
     # @param [Hash] given_configuration
     # @option given_configuration [String] :token Required if oauth_token is not set
     # @option given_configuration [String] :oauth_token Required if token is not set
     # @option given_configuration [String] :api_url
+    # @option given_configuration [Proc] :component_resolver
     # @option given_configuration [Number] :api_version
     # @option given_configuration [false, ::Logger] :logger
     # @option given_configuration [::Logger::DEBUG, ::Logger::INFO, ::Logger::WARN, ::Logger::ERROR] :log_level
     def initialize(given_configuration = {})
       @configuration = default_configuration.merge(given_configuration)
+      @cache_version = '0'
       validate_configuration!
 
       if configuration[:oauth_token]
@@ -38,6 +42,8 @@ module Storyblok
         })
       end
 
+      @renderer = Richtext::HtmlRenderer.new
+      @renderer.set_component_resolver(@configuration[:component_resolver])
       setup_logger
     end
 
@@ -57,7 +63,7 @@ module Storyblok
     #
     # @return [Hash]
     def space(query = {})
-      Request.new(self, '/cdn/spaces/me', query).get
+      Request.new(self, '/cdn/spaces/me', query, nil, true).get
     end
 
     # Gets a collection of stories
@@ -164,16 +170,15 @@ module Storyblok
       parse_result(res)
     end
 
-    def cached_get(request)
+    def cached_get(request, bypass_cache = false)
       endpoint = base_url + request.url
       query = request_query(request.query)
       query_string = build_nested_query(query)
 
-      if cache.nil?
+      if cache.nil? || bypass_cache || query[:version] == 'draft'
         result = run_request(endpoint, query_string)
       else
-        version = cache.get('storyblok:' + configuration[:token] + ':version') || '0'
-        cache_key = 'storyblok:' + configuration[:token] + ':v:' + version + ':' + request.url + ':' + Base64.encode64(query_string)
+        cache_key = 'storyblok:' + configuration[:token] + ':v:' + query[:cv] + ':' + request.url + ':' + Base64.encode64(query_string)
 
         result = cache.cache(cache_key) do
           run_request(endpoint, query_string)
@@ -185,10 +190,28 @@ module Storyblok
 
     def flush
       unless cache.nil?
-        cache.set('storyblok:' + configuration[:token] + ':version', Time.now.to_i.to_s)
+        cache.set('storyblok:' + configuration[:token] + ':version', space['data']['space']['version'])
       end
     end
 
+    # Returns html from richtext field data
+    #
+    # @param [Hash] :data
+    #
+    # @return [String]
+    def render data
+      @renderer.render(data)
+    end
+
+    # Sets component resolver
+    #
+    # @param [Proc] :component_resolver
+    #
+    # @return [nil]
+    def set_component_resolver component_resolver
+      @renderer.set_component_resolver(component_resolver)
+    end
+
     private
 
     def parse_result(res)
@@ -213,14 +236,27 @@ module Storyblok
         raise
       end
 
-      {'headers' => res.headers, 'data' => JSON.parse(res.body)}.to_json
+      body = JSON.parse(res.body)
+      self.cache_version = body['cv'] if body['cv']
+
+      unless cache.nil?
+        cache.set('storyblok:' + configuration[:token] + ':version', cache_version)
+      end
+
+      {'headers' => res.headers, 'data' => body}.to_json
     end
 
     # Patches a query hash with the client configurations for queries
     def request_query(query)
       query[:token] = configuration[:token] if query[:token].nil?
       query[:version] = configuration[:version] if query[:version].nil?
-      query[:cv] = configuration[:cache_version] if query[:cache_version].nil?
+
+      unless cache.nil?
+        query[:cv] = (cache.get('storyblok:' + configuration[:token] + ':version') or cache_version) if query[:cv].nil?
+      else
+        query[:cv] = cache_version if query[:cv].nil?
+      end
+
       query
     end
 

data/lib/storyblok/request.rb

@@ -5,14 +5,15 @@ module Storyblok
   class Request
     attr_reader :client, :type, :query, :id, :endpoint
 
-    def initialize(client, endpoint, query = {}, id = nil)
+    def initialize(client, endpoint, query = {}, id = nil, bypass_cache = false)
       @client = client
       @endpoint = endpoint
       @query = query
+      @bypass_cache = bypass_cache
 
       if id
         @type = :single
-        @id = URI.escape(id)
+        @id = id
       else
         @type = :multi
         @id = nil
@@ -26,7 +27,7 @@ module Storyblok
 
     # Delegates the actual HTTP work to the client
     def get
-      client.cached_get(self)
+      client.cached_get(self, @bypass_cache)
     end
 
     # Returns a new Request object with the same data

data/lib/storyblok/version.rb

@@ -1,4 +1,4 @@
 module Storyblok
   # Gem Version
-  VERSION = '2.0.5'
+  VERSION = '2.1.1'
 end

data/storyblok.gemspec

@@ -16,6 +16,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ['lib']
 
   gem.add_dependency 'rest-client', '>= 1.8.0', '< 3'
+  gem.add_dependency 'storyblok-richtext-renderer', '>= 0.0.4', '< 1'
 
   gem.add_development_dependency 'bundler', '~> 1.5'
   gem.add_development_dependency 'rspec', '~> 3'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: storyblok
 version: !ruby/object:Gem::Version
-  version: 2.0.5
+  version: 2.1.1
 platform: ruby
 authors:
 - Storyblok (Alexander Feiglstorfer)
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-02 00:00:00.000000000 Z
+date: 2020-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -30,6 +30,26 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '3'
+- !ruby/object:Gem::Dependency
+  name: storyblok-richtext-renderer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -75,8 +95,11 @@ files:
 - examples/cache.rb
 - examples/example_queries.rb
 - examples/management_api.rb
+- examples/renderer.rb
 - examples/tree.rb
+- lib/.DS_Store
 - lib/storyblok.rb
+- lib/storyblok/.DS_Store
 - lib/storyblok/cache/redis.rb
 - lib/storyblok/client.rb
 - lib/storyblok/links.rb