spree_core 5.3.0.rc2 → 5.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4241192c0b403bb14c71969625a754c8697e3f2cdc643e2095ad87a013b11b8b
-  data.tar.gz: 2c747e6ad0a508d22442d959c8617b7bed0fd215b2606c4f889c6bba04c87507
+  metadata.gz: 5d6583fe2ea61bf166c3e25d8739ea9b953b396c35acfbb4e47edde6d612d59d
+  data.tar.gz: 3bc0a7d98a739e16e3857eabdf23cbb25a989f17cf7186ae0632ced2bff36ac4
 SHA512:
-  metadata.gz: 805d79f3e0e69417cd88b7304aabf4ac9b9a3df5ff04a3738c500ed6711b0ce8f3f5b1007e0ac7a90a865ec218e9ffc52d238c0ad79884316f04eba4f967cdeb
-  data.tar.gz: 250588209094b5acf8215c85c4616880794d38d01644c011c4bee3349df39f0a3b48826918f710715dc464dff06b03c827bd28efd687303038cee2bc4ec28e21
+  metadata.gz: 66a7c9d1bbe53c07cf36032a2b61ebf850489a3e5b3e515c2916ad9bfa685b10e7a2bc7d8d0a5de1cb8241e7b96e0c31eb60de3351e306e6347a25f52032faf3
+  data.tar.gz: 9dca332fe825e8342f9b2492bbd555e3d6b2868ae1a5a9f5f99a163d86efd28fba5c0bb63df74f9b304f1b2fb65f8aa9481bbca22c6757b13c7a05851c1d456e

data/README.md

@@ -0,0 +1,116 @@
+# Spree Core
+
+[![Gem Version](https://badge.fury.io/rb/spree_core.svg)](https://badge.fury.io/rb/spree_core)
+
+Spree Core is the foundation of Spree Commerce, containing all the essential models, services, and business logic that power an e-commerce application.
+
+## Overview
+
+This gem provides:
+
+- **Domain Models** - Products, Variants, Orders, Payments, Shipments, Taxons, Stores, and more
+- **Services** - Cart operations, checkout flows, order management, inventory handling
+- **State Machines** - Order and payment state management
+- **Events System** - Publish/subscribe architecture for loose coupling
+- **Dependencies Injection** - Swappable service implementations via `Spree::Dependencies`
+- **Permissions** - CanCanCan-based authorization with Permission Sets
+
+## Installation
+
+This gem is included in every Spree installation. No additional steps are required.
+
+## Key Components
+
+### Models
+
+All models are namespaced under `Spree::` and include:
+
+- `Spree::Product` / `Spree::Variant` - Product catalog
+- `Spree::Order` / `Spree::LineItem` - Order management
+- `Spree::Payment` / `Spree::PaymentMethod` - Payment processing
+- `Spree::Shipment` / `Spree::ShippingMethod` - Shipping and fulfillment
+- `Spree::Taxon` / `Spree::Taxonomy` - Product categorization
+- `Spree::Store` - Multi-store support
+- `Spree::Promotion` - Promotions and discounts
+- `Spree::GiftCard` - Gift card functionality
+
+### Services
+
+Services follow a consistent interface pattern and are located in `app/services/spree/`:
+
+```ruby
+# Add item to cart
+Spree.cart_add_item_service.call(
+  order: order,
+  variant: variant,
+  quantity: 1
+)
+```
+
+### Events System
+
+Spree uses an event-driven architecture for decoupling components:
+
+```ruby
+# Publishing events
+order.publish_event('order.completed')
+
+# Subscribing to events
+module Spree
+  module MySubscriber
+    include Spree::Event::Subscriber
+
+    event_action :order_completed
+
+    def order_completed(event)
+      order = event.payload[:order]
+      # Handle the event
+    end
+  end
+end
+```
+
+### Dependencies
+
+Swap out default implementations with custom services:
+
+```ruby
+# config/initializers/spree.rb
+Spree::Dependencies.cart_add_item_service = 'MyCustom::CartAddItem'
+```
+
+## Configuration
+
+Configure Spree in an initializer:
+
+```ruby
+# config/initializers/spree.rb
+Spree.config do |config|
+  config.currency = 'USD'
+  config.default_country_iso = 'US'
+end
+```
+
+## Testing
+
+Spree Core includes testing support utilities:
+
+```ruby
+# spec/rails_helper.rb
+require 'spree/testing_support/factories'
+require 'spree/testing_support/authorization_helpers'
+```
+
+To run the test suite:
+
+```bash
+cd core
+bundle exec rake test_app  # First time only
+bundle exec rspec
+```
+
+## Documentation
+
+- [Official Documentation](https://docs.spreecommerce.org)
+- [API Reference](https://api.spreecommerce.org)
+- [Guides](https://docs.spreecommerce.org/developer)

data/app/models/spree/product.rb

@@ -367,6 +367,14 @@ module Spree
       variant_for_images&.primary_image
     end
 
+    # Backward compatibility for Spree 5.2 and earlier.
+    # @deprecated Use Spree::Product#default_image instead.
+    def featured_image
+      Spree::Deprecation.warn('Spree::Product#featured_image is deprecated and will be removed in Spree 5.5. Please use Spree::Product#default_image instead.')
+
+      default_image
+    end
+
     # Returns secondary Image for Product (for hover effects).
     # @return [Spree::Image, nil]
     def secondary_image

data/app/services/spree/data_feeds/google/required_attributes.rb

@@ -56,7 +56,7 @@ module Spree
         end
 
         def get_availability(product)
-          return 'in stock' if product.available? && product.available_on&.past?
+          return 'in stock' if product.available? && (product.available_on.nil? || product.available_on.past?)
           return 'backorder' if product.backorderable? && product.backordered? && product.available_on&.future?
 
           'out of stock'

data/lib/spree/core/version.rb

@@ -1,5 +1,5 @@
 module Spree
-  VERSION = '5.3.0.rc2'.freeze
+  VERSION = '5.3.0'.freeze
 
   def self.version
     VERSION

data/lib/spree/testing_support/common_rake.rb

@@ -58,8 +58,17 @@ namespace :common do
     end
 
     # Run core Spree install generator
+    # The spree:install generator lives in the root spree gem. Core gems (spree_core, spree_api)
+    # don't have spree as a dependency, so we need to use the root Gemfile to access the generator.
+    # Other gems (admin, storefront, etc.) already have spree in their Gemfile.
+    core_gems = %w[spree/core spree/api]
+    root_gemfile = File.expand_path('../../../../Gemfile', __dir__)
+    use_root_gemfile = core_gems.include?(ENV['LIB_NAME']) &&
+                       File.exist?(root_gemfile) &&
+                       File.exist?(File.expand_path('../../../../spree.gemspec', __dir__))
+    bundle_exec = use_root_gemfile ? "bundle exec --gemfile=#{root_gemfile}" : 'bundle exec'
     puts 'Running Spree install generator...'
-    system("bundle exec rails g spree:install --force --auto-accept --migrate=false --seed=false --sample=false --user_class=#{args[:user_class]} --admin_user_class=#{args[:admin_user_class]} --authentication=#{args[:authentication]}")
+    system("#{bundle_exec} rails g spree:install --force --auto-accept --migrate=false --seed=false --sample=false --user_class=#{args[:user_class]} --admin_user_class=#{args[:admin_user_class]} --authentication=#{args[:authentication]}")
 
     # Determine if we need to install admin/storefront
     # Either via explicit flag or because we're testing that gem itself

data/lib/spree/testing_support/extension_rake.rb

@@ -4,6 +4,6 @@ desc 'Generates a dummy app for testing an extension'
 namespace :extension do
   task :test_app, [:authentication, :user_class] do |_t, args|
     Spree::DummyGeneratorHelper.inject_extension_requirements = true
-    Rake::Task['common:test_app'].execute(args.with_defaults(install_admin: true, install_storefront: true))
+    Rake::Task['common:test_app'].execute(args)
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spree_core
 version: !ruby/object:Gem::Version
-  version: 5.3.0.rc2
+  version: 5.3.0
 platform: ruby
 authors:
 - Sean Schofield
@@ -566,6 +566,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE.md
+- README.md
 - Rakefile
 - app/assets/config/spree_core_manifest.js
 - app/assets/images/google_on_white_hdpi.png
@@ -1702,9 +1703,9 @@ licenses:
 - BSD-3-Clause
 metadata:
   bug_tracker_uri: https://github.com/spree/spree/issues
-  changelog_uri: https://github.com/spree/spree/releases/tag/v5.3.0.rc2
+  changelog_uri: https://github.com/spree/spree/releases/tag/v5.3.0
   documentation_uri: https://docs.spreecommerce.org/
-  source_code_uri: https://github.com/spree/spree/tree/v5.3.0.rc2
+  source_code_uri: https://github.com/spree/spree/tree/v5.3.0
 rdoc_options: []
 require_paths:
 - lib