barley 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bee5cfe197a0a824c4edd25ab6ad77628c14732bafc2ff09ceb64e08e24d6aaf
-  data.tar.gz: 5d060056d2de5fb5b8c64ca78b84a5faeb39fb4e7714e8de07647a26bfeeb76b
+  metadata.gz: be82895a01fc1f0be3170a9a105b7fdf20b7e98d31a77c74c5d9f67068814dec
+  data.tar.gz: 276dcc80814079aed898b1e4d1d9e5b6bf3bc4b8b6b86f2b5cff701961d2b877
 SHA512:
-  metadata.gz: 67d5c179e808312c73d5058e634c4ee2a7237d702b931580fd6a2c5e73085c51839a0e1debb8591f172cc696a8cbb9b694ccd7c740880d5fd384995a28011115
-  data.tar.gz: 5db28559be764eff3ef9990925896c6e1ce11005011335ab993f4fd346313cf0874bd22e7abdfc815616b95b0820c51648ecc22ca4243993b1d5dc9a4f200988
+  metadata.gz: 9f3482dc0562669991a64403c9c5cee510d61cc5ec79affa3715eb203ac1a48f1f15c676778d380eccbfe6efc57281eae6c179ab4378a62d35c31b0fd65529ea
+  data.tar.gz: b9d2a98edf8704acf8b8466042b924b771384e1756fd06f9d23939f9bd0fb4368a4934303057edd0a53d0c8f487dc93c10649e39fe17b3031189f383a668ec54

data/README.md

@@ -2,7 +2,7 @@
 
 Barley is a dead simple, fast, and efficient ActiveModel JSON serializer.
 
-Cerealize your ActiveModel objects into flat JSON objects with a dead simple DSL. Our daily bread is to make your API faster. 
+Cerealize your ActiveModel objects into flat hashes with a dead simple, yet versatile DSL, and caching baked in. Our daily bread is to make your API faster. 
 
 You don't believe us? Check out the [benchmarks](#benchmarks). 😎
 
@@ -21,10 +21,19 @@ Then define your attributes and associations in a serializer class.
 ```ruby
 # /app/serializers/user_serializer.rb
 class UserSerializer < Barley::Serializer
-  attributes :id, :name, :email, :created_at, :updated_at
-
-  many :posts
-  one :group
+  attributes :id, :name,
+  attribute :email # single attribute
+
+  many :posts # relations
+  one :group, serializer: CustomGroupSerializer # custom serializer
+  many :related_users, key: :friends, cache: true # custom key, and caching
+  one :profile, cache: { expires_in: 1.day } do # cache definition, and block (on associations) for nested, on-the-fly serializer
+    attributes :avatar, :social_url
+    attribute :badges do
+      object.badges.map(&:display_name) # use object in a block to return custom code
+    end
+  end
+    
 end
 ```
 
@@ -264,14 +273,14 @@ Ah ah ah. This is so funny.
 *Note: we are thinking about adding a `Surrealizer` class for the most advanced users. Stay tuned.*
 
 ## JSON:API
-No. Not yet. Maybe never. We don't know. We don't care. We don't use it. We don't like it. We don't want to. We don't have time. We don't have money. We don't have a life. We don't have a girlfriend. We don't have a boyfriend. We don't have a dog. We don't have a cat. We are generating this readme with Copilot.
+Barley does not serialize to the JSON:API standard. We prefer to keep it simple and fast.
 
 ## Benchmarks
 This gem is blazing fast and efficient. It is 2 to 3 times faster than [ActiveModel::Serializer](https://github.com/rails-api/active_model_serializers) and twice as fast as [FastJsonapi](https://github.com/Netflix/fast_jsonapi). Memory object allocation is also much lower.
 
 With caching enabled, it is just mind-blowing. We think. *Disclaimer: we do not serialize to the JSON:API standard, so that might be the reason why we are so fast.*
 
-This is the result we get with the benchmark script used in the AMS repo on an Apple Silicon M1Pro processor. We will push this benchmark as soon as possible so you can see for yourself.
+This is the result we get with the benchmark script used in the AMS repo on an Apple Silicon M1Pro processor. [Check it out for yourself here](https://github.com/MoskitoHero/active_model_serializers/tree/benchmarks).
 
 ```shell
 bundle exec ruby benchmark.rb
@@ -351,3 +360,8 @@ ams               :    1299674 allocated - 28.20x more
 
 ## License
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Credits
+Barley is brought to you by the developer team from [StockPro](https://www.stock-pro.fr/).
+
+[![Barley is brought to you by StockPro](img/stockpro.png)](https://www.stock-pro.fr/)

data/lib/barley/serializable.rb

@@ -33,9 +33,9 @@ module Barley
     included do
       serializer "#{self}Serializer".constantize
 
-      def as_json(serializer: nil, cache: false)
+      def as_json(serializer: nil, cache: false, root: false)
         serializer ||= self.serializer.class
-        serializer.new(self, cache: cache).as_json
+        serializer.new(self, cache: cache, root: root).serializable_hash
       end
     end
   end

data/lib/barley/serializer.rb

@@ -40,7 +40,7 @@ module Barley
           return {} if element.nil?
 
           el_serializer = serializer || element.serializer.class
-          el_serializer.new(element, cache: cache).as_json
+          el_serializer.new(element, cache: cache).serializable_hash
         end
         set_class_iv(:@defined_attributes, key_name)
       end
@@ -57,7 +57,7 @@ module Barley
           return [] if elements.empty?
 
           el_serializer = serializer || elements.first.serializer.class
-          elements.map { |element| el_serializer.new(element, cache: cache).as_json }.reject(&:blank?)
+          elements.map { |element| el_serializer.new(element, cache: cache).serializable_hash }.reject(&:blank?)
         end
         set_class_iv(:@defined_attributes, key_name)
       end
@@ -71,8 +71,9 @@ module Barley
     #   Barley::Serializer.new(object, cache: true)
     # @example with cache and expires_in
     #   Barley::Serializer.new(object, cache: {expires_in: 1.hour})
-    def initialize(object, cache: false)
+    def initialize(object, cache: false, root: false)
       @object = object
+      @root = root
       @cache, @expires_in = if cache.is_a?(Hash)
         [true, cache[:expires_in]]
       else
@@ -80,14 +81,13 @@ module Barley
       end
     end
 
-    def as_json
+    def serializable_hash
       if @cache
-        cache_key = cache_base_key
-        Barley::Cache.fetch(cache_key, expires_in: @expires_in) do
-          _as_json
+        Barley::Cache.fetch(cache_base_key, expires_in: @expires_in) do
+          _serializable_hash
         end
       else
-        _as_json
+        _serializable_hash
       end
     end
 
@@ -98,21 +98,29 @@ module Barley
     private
 
     def cache_base_key
-      "#{object.class.name&.underscore}/#{object.id}/#{object.updated_at.to_i}/as_json/"
+      if object.updated_at.present?
+        "#{object.class.name&.underscore}/#{object.id}/#{object.updated_at&.to_i}/barley_cache/"
+      else
+        "#{object.class.name&.underscore}/#{object.id}/barley_cache/"
+      end
     end
 
     def defined_attributes
       self.class.instance_variable_get(:@defined_attributes)
     end
 
-    def _as_json
+    def _serializable_hash
       hash = {}
 
       defined_attributes.each do |key|
         hash[key] = send(key)
       end
 
-      hash
+      @root ? {root_key => hash} : hash
+    end
+
+    def root_key
+      object.class.name.underscore.to_sym
     end
   end
 end

data/lib/barley/version.rb

@@ -1,3 +1,3 @@
 module Barley
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: barley
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Cedric Delalande
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-10-11 00:00:00.000000000 Z
+date: 2023-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails