panda-core 0.6.0 → 0.7.1

data/lib/panda/core/oauth_providers.rb

@@ -5,21 +5,21 @@ module Panda
         providers = []
 
         begin
-          require "omniauth-github"
+          require "omniauth/strategies/github"
           providers << :github
         rescue LoadError
           # GitHub OAuth functionality not available
         end
 
         begin
-          require "omniauth-google-oauth2"
+          require "omniauth/strategies/google_oauth2"
           providers << :google_oauth2
         rescue LoadError
           # Google OAuth functionality not available
         end
 
         begin
-          require "omniauth-microsoft_graph"
+          require "omniauth/strategies/microsoft_graph"
           providers << :microsoft_graph
         rescue LoadError
           # Microsoft OAuth functionality not available

data/lib/panda/core/testing/rails_helper.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+# Shared RSpec configuration for all Panda gems
+# This file provides common test infrastructure that can be extended by individual gems
+#
+# IMPORTANT: This file should be required AFTER the dummy app is loaded
+# Individual gem rails_helper files should:
+# 1. Set up SimpleCov
+# 2. Require panda/core and the dummy app
+# 3. Require this file
+# 4. Load gem-specific support files
+
+# Require common test gems (assumes Rails and RSpec/Rails are already loaded by gem's rails_helper)
+require "database_cleaner/active_record"
+require "shoulda/matchers"
+require "capybara"
+require "capybara/rspec"
+require "puma"
+
+# Configure fixtures
+ActiveRecord::FixtureSet.context_class.send :include, ActiveSupport::Testing::TimeHelpers
+
+# Shoulda Matchers configuration
+Shoulda::Matchers.configure do |config|
+  config.integrate do |with|
+    with.test_framework :rspec
+    with.library :rails
+  end
+end
+
+# Load all support files from panda-core
+panda_core_support_path = Gem.loaded_specs["panda-core"]&.full_gem_path
+if panda_core_support_path
+  Dir[File.join(panda_core_support_path, "spec/support/**/*.rb")].sort.each { |f| require f }
+end
+
+RSpec.configure do |config|
+  # Include panda-core route helpers by default
+  config.include Panda::Core::Engine.routes.url_helpers if defined?(Panda::Core::Engine)
+  config.include Rails.application.routes.url_helpers
+
+  # Standard RSpec configuration
+  config.use_transactional_fixtures = true
+  config.infer_spec_type_from_file_location!
+  config.filter_rails_from_backtrace!
+  config.example_status_persistence_file_path = "spec/examples.txt"
+  config.disable_monkey_patching!
+
+  # Print total example count before running
+  config.before(:suite) do
+    puts "Total examples to run: #{RSpec.world.example_count}\n"
+  end
+
+  # Use specific formatter for GitHub Actions
+  if ENV["GITHUB_ACTIONS"] == "true"
+    require "rspec/github"
+    config.add_formatter RSpec::Github::Formatter
+  end
+
+  # Controller testing support (if rails-controller-testing is available)
+  if defined?(Rails::Controller::Testing)
+    config.include Rails::Controller::Testing::TestProcess, type: :controller
+    config.include Rails::Controller::Testing::TemplateAssertions, type: :controller
+    config.include Rails::Controller::Testing::Integration, type: :controller
+  end
+
+  # Reset column information before suite
+  config.before(:suite) do
+    if defined?(Panda::Core::User)
+      Panda::Core::User.connection.schema_cache.clear!
+      Panda::Core::User.reset_column_information
+    end
+  end
+
+  # Disable prepared statements for PostgreSQL tests to avoid caching issues
+  config.before(:suite) do
+    if ActiveRecord::Base.connection.adapter_name == "PostgreSQL"
+      ActiveRecord::Base.connection.unprepared_statement do
+        # This block intentionally left empty
+      end
+      # Disable prepared statements globally for test environment
+      ActiveRecord::Base.establish_connection(
+        ActiveRecord::Base.connection_db_config.configuration_hash.merge(prepared_statements: false)
+      )
+    end
+  end
+
+  # Disable logging during tests
+  config.before(:suite) do
+    Rails.logger.level = Logger::ERROR
+    ActiveRecord::Base.logger = nil if defined?(ActiveRecord)
+    ActionController::Base.logger = nil if defined?(ActionController)
+    ActionMailer::Base.logger = nil if defined?(ActionMailer)
+  end
+
+  # Suppress Rails command output during generator tests
+  config.before(:each, type: :generator) do
+    allow(Rails::Command).to receive(:invoke).and_return(true)
+  end
+
+  # Force all examples to run
+  config.filter_run_including({})
+  config.run_all_when_everything_filtered = true
+
+  # Allow using focus keywords "f... before a specific test"
+  config.filter_run_when_matching :focus
+
+  # Retry flaky tests automatically
+  # This is especially useful for system tests that may have timing issues
+  config.around(:each, :flaky) do |example|
+    retry_count = example.metadata[:retry] || 3
+    retry_count.times do |i|
+      example.run
+      break unless example.exception
+
+      if i < retry_count - 1
+        puts "\n[RETRY] Test failed, retrying... (attempt #{i + 2}/#{retry_count})"
+        puts "[RETRY] Exception: #{example.exception.class.name}: #{example.exception.message[0..100]}"
+        example.instance_variable_set(:@exception, nil)
+        sleep 1 # Brief pause between retries
+      end
+    end
+  end
+
+  # Exclude EditorJS tests by default unless specifically requested
+  config.filter_run_excluding :editorjs unless ENV["INCLUDE_EDITORJS"] == "true"
+
+  # Use verbose output if only running one spec file
+  config.default_formatter = "doc" if config.files_to_run.one?
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run: --seed 1234
+  Kernel.srand config.seed
+  config.order = :random
+
+  # Note: Fixture configuration is gem-specific and should be done in each gem's rails_helper.rb
+  # This includes config.fixture_paths and config.global_fixtures
+
+  # Bullet configuration (if available)
+  if defined?(Bullet) && Bullet.enable?
+    config.before(:each) do
+      Bullet.start_request
+    end
+
+    config.after(:each) do
+      Bullet.perform_out_of_channel_notifications if Bullet.notification?
+      Bullet.end_request
+    end
+  end
+
+  # OmniAuth test mode
+  OmniAuth.config.test_mode = true if defined?(OmniAuth)
+
+  # DatabaseCleaner configuration
+  config.before(:suite) do
+    # Allow DATABASE_URL in CI environment
+    if ENV["DATABASE_URL"]
+      DatabaseCleaner.allow_remote_database_url = true
+    end
+
+    DatabaseCleaner.clean_with :truncation
+
+    # Hook for gems to add custom suite setup
+    # Gems can define Panda::Testing.before_suite_hook and it will be called here
+    if defined?(Panda::Testing) && Panda::Testing.respond_to?(:before_suite_hook)
+      Panda::Testing.before_suite_hook
+    end
+  end
+end

data/lib/panda/core/version.rb

@@ -2,6 +2,6 @@
 
 module Panda
   module Core
-    VERSION = "0.6.0"
+    VERSION = "0.7.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: panda-core
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Otaina Limited
@@ -52,48 +52,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: omniauth-google-oauth2
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: omniauth-github
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: omniauth-microsoft_graph
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: propshaft
   requirement: !ruby/object:Gem::Requirement
@@ -150,20 +108,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: view_component
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: phlex
   requirement: !ruby/object:Gem::Requirement
@@ -477,7 +421,9 @@ files:
 - app/helpers/panda/core/sessions_helper.rb
 - app/javascript/panda/core/application.js
 - app/javascript/panda/core/controllers/alert_controller.js
+- app/javascript/panda/core/controllers/image_cropper_controller.js
 - app/javascript/panda/core/controllers/index.js
+- app/javascript/panda/core/controllers/navigation_toggle_controller.js
 - app/javascript/panda/core/controllers/theme_form_controller.js
 - app/javascript/panda/core/controllers/toggle_controller.js
 - app/javascript/panda/core/tailwindcss-stimulus-components.js
@@ -508,15 +454,6 @@ files:
 - db/migrate/20250809000001_create_panda_core_users.rb
 - db/migrate/20250810120000_add_current_theme_to_panda_core_users.rb
 - db/migrate/20250811120000_add_oauth_avatar_url_to_panda_core_users.rb
-- lib/generators/panda/core/authentication/templates/reek_spec.rb
-- lib/generators/panda/core/dev_tools/USAGE
-- lib/generators/panda/core/dev_tools/templates/lefthook.yml
-- lib/generators/panda/core/dev_tools/templates/spec_support_panda_core_helpers.rb
-- lib/generators/panda/core/dev_tools_generator.rb
-- lib/generators/panda/core/install_generator.rb
-- lib/generators/panda/core/templates/README
-- lib/generators/panda/core/templates/initializer.rb
-- lib/generators/panda/core/templates_generator.rb
 - lib/panda/core.rb
 - lib/panda/core/asset_loader.rb
 - lib/panda/core/authentication.rb
@@ -533,9 +470,7 @@ files:
 - lib/panda/core/services/base_service.rb
 - lib/panda/core/sluggable.rb
 - lib/panda/core/subscribers/authentication_subscriber.rb
-- lib/panda/core/testing/capybara_config.rb
-- lib/panda/core/testing/omniauth_helpers.rb
-- lib/panda/core/testing/rspec_config.rb
+- lib/panda/core/testing/rails_helper.rb
 - lib/panda/core/version.rb
 - lib/tasks/assets.rake
 - lib/tasks/panda/core/migrations.rake

data/lib/generators/panda/core/authentication/templates/reek_spec.rb

@@ -1,43 +0,0 @@
-require "spec_helper"
-
-RUBY_FILE_PATTERN = File.expand_path("../../**/*.rb", __dir__)
-EXCLUDED_PATHS = [
-  "db/schema.rb",
-  "bin/",
-  "script/",
-  "log/",
-  "public/",
-  "tmp/",
-  "doc/",
-  "vendor/",
-  "storage/",
-  "node_modules/",
-  ".git/",
-  "spec/dummy/"
-].freeze
-
-RSpec.describe "Reek" do
-  it "contains no code smells" do
-    failures = []
-
-    Dir.glob(RUBY_FILE_PATTERN).each do |file|
-      next if EXCLUDED_PATHS.any? { |path| file.include?(path) }
-
-      IO.popen(["bundle", "exec", "reek", file], err: [:child, :out]) do |io|
-        output = io.read
-        next if output.empty?
-
-        failures << {file: file, output: output}
-      end
-    end
-
-    failures.each do |failure|
-      puts "\nCode smells found in #{failure[:file]}:"
-      puts failure[:output]
-    end
-
-    failures.each do |failure|
-      expect(failure).to be_nil, "Found code smells in #{failure[:file]}"
-    end
-  end
-end

data/lib/generators/panda/core/dev_tools/USAGE

@@ -1,24 +0,0 @@
-Description:
-    Sets up or updates Panda Core development tools in your gem or Rails application.
-    This includes linting configurations, testing helpers, and CI/CD workflows.
-
-Example:
-    # Initial setup
-    rails generate panda:core:dev_tools
-
-    # Force update (overwrites existing files)
-    rails generate panda:core:dev_tools --force
-
-    # Skip adding dependencies to Gemfile
-    rails generate panda:core:dev_tools --skip-dependencies
-
-    This will:
-        - Copy .standard.yml, .yamllint, and .rspec configurations
-        - Set up GitHub Actions workflows for CI and releases
-        - Add development dependencies to your Gemfile
-        - Create testing helper configuration
-        - Add rake tasks for linting and security checks
-        - Track version for future updates
-
-    To check for updates later:
-        bundle exec rake panda:check_updates

data/lib/generators/panda/core/dev_tools/templates/lefthook.yml

@@ -1,13 +0,0 @@
----
-assert_lefthook_installed: true
-colors: true
-pre-commit:
-  parallel: true
-  jobs:
-    - name: bundle-audit
-      run: bundle exec bundle-audit --update
-    - name: bundle-outdated
-      run: bundle outdated --strict
-    - name: standardrb
-      run: bundle exec standardrb --fix {all_files}
-      glob: "**/*.rb"

data/lib/generators/panda/core/dev_tools/templates/spec_support_panda_core_helpers.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-require "panda/core/testing/rspec_config"
-require "panda/core/testing/omniauth_helpers"
-require "panda/core/testing/capybara_config"
-
-RSpec.configure do |config|
-  # Apply Panda Core RSpec configuration
-  Panda::Core::Testing::RSpecConfig.configure(config)
-  Panda::Core::Testing::RSpecConfig.setup_matchers
-
-  # Configure Capybara
-  Panda::Core::Testing::CapybaraConfig.configure
-
-  # Include helpers
-  config.include Panda::Core::Testing::OmniAuthHelpers, type: :system
-  config.include Panda::Core::Testing::CapybaraConfig::Helpers, type: :system
-end

data/lib/generators/panda/core/dev_tools_generator.rb

@@ -1,143 +0,0 @@
-# frozen_string_literal: true
-
-require "rails/generators"
-
-module Panda
-  module Core
-    module Generators
-      class DevToolsGenerator < Rails::Generators::Base
-        source_root File.expand_path("dev_tools/templates", __dir__)
-
-        desc "Set up or update Panda Core development tools in your gem/application"
-
-        class_option :force, type: :boolean, default: false,
-          desc: "Overwrite existing files"
-        class_option :skip_dependencies, type: :boolean, default: false,
-          desc: "Skip adding dependencies to Gemfile"
-
-        VERSION_FILE = ".panda-dev-tools-version"
-        CURRENT_VERSION = "1.0.0"
-
-        def check_for_updates
-          if File.exist?(VERSION_FILE)
-            installed_version = File.read(VERSION_FILE).strip
-            if installed_version != CURRENT_VERSION
-              say "Updating Panda Core dev tools from #{installed_version} to #{CURRENT_VERSION}", :yellow
-              @updating = true
-            else
-              say "Panda Core dev tools are up to date (#{CURRENT_VERSION})", :green
-              unless options[:force]
-                say "Use --force to reinstall anyway"
-                nil
-              end
-            end
-          else
-            say "Installing Panda Core dev tools #{CURRENT_VERSION}", :green
-            @updating = false
-          end
-        end
-
-        def copy_linting_configs
-          say "Copying linting configurations..."
-          copy_file ".standard.yml", force: options[:force] || @updating
-          copy_file ".yamllint", force: options[:force] || @updating
-          copy_file ".rspec", force: options[:force] || @updating
-          copy_file "lefthook.yml", force: options[:force] || @updating
-        end
-
-        def copy_github_workflows
-          say "Copying GitHub Actions workflows..."
-          directory ".github", ".github", force: options[:force] || @updating
-        end
-
-        def create_version_file
-          create_file VERSION_FILE, CURRENT_VERSION, force: true
-        end
-
-        def add_development_dependencies
-          say "Adding development dependencies to gemspec..."
-
-          if File.exist?("Gemfile")
-            append_to_file "Gemfile" do
-              <<~RUBY
-                
-                group :development, :test do
-                  # Panda Core development tools
-                  gem "standard"
-                  gem "brakeman"
-                  gem "bundler-audit"
-                  gem "yamllint"
-                end
-              RUBY
-            end
-          end
-        end
-
-        def create_spec_helper
-          say "Creating spec helper with Panda Core testing configuration..."
-
-          create_file "spec/support/panda_core_helpers.rb" do
-            <<~RUBY
-              # frozen_string_literal: true
-              
-              require 'panda/core/testing/rspec_config'
-              require 'panda/core/testing/omniauth_helpers'
-              require 'panda/core/testing/capybara_config'
-              
-              RSpec.configure do |config|
-                # Apply Panda Core RSpec configuration
-                Panda::Core::Testing::RSpecConfig.configure(config)
-                Panda::Core::Testing::RSpecConfig.setup_matchers
-                
-                # Configure Capybara
-                Panda::Core::Testing::CapybaraConfig.configure
-                
-                # Include helpers
-                config.include Panda::Core::Testing::OmniAuthHelpers, type: :system
-                config.include Panda::Core::Testing::CapybaraConfig::Helpers, type: :system
-              end
-            RUBY
-          end
-        end
-
-        def add_rake_tasks
-          say "Adding Panda Core rake tasks..."
-
-          append_to_file "Rakefile" do
-            <<~RUBY
-              
-              # Panda Core development tasks
-              namespace :panda do
-                desc "Run all linters"
-                task :lint do
-                  sh "bundle exec standardrb"
-                  sh "yamllint -c .yamllint ."
-                end
-                
-                desc "Run security checks"
-                task :security do
-                  sh "bundle exec brakeman --quiet"
-                  sh "bundle exec bundle-audit --update"
-                end
-                
-                desc "Run all quality checks"
-                task quality: [:lint, :security]
-              end
-            RUBY
-          end
-        end
-
-        def display_instructions
-          say "\n✅ Panda Core development tools have been set up!", :green
-          say "\nNext steps:"
-          say "  1. Run 'bundle install' to install new dependencies"
-          say "  2. Run 'bundle exec rake panda:quality' to check code quality"
-          say "  3. Customize .github/workflows for your gem's needs"
-          say "  4. Add 'require' statements to your spec_helper.rb or rails_helper.rb:"
-          say "     require 'support/panda_core_helpers'"
-          say "\nFor more information, see: docs/development_tools.md"
-        end
-      end
-    end
-  end
-end

data/lib/generators/panda/core/install_generator.rb

@@ -1,41 +0,0 @@
-module Panda
-  module Core
-    class InstallGenerator < Rails::Generators::Base
-      include Rails::Generators::Migration
-
-      source_root File.expand_path("templates", __dir__)
-
-      namespace "panda:core:install"
-
-      # Allow incompatible default types for Thor options
-      def self.allow_incompatible_default_type!
-        true
-      end
-
-      class_option :skip_migrations, type: :boolean, default: false,
-        desc: "Skip migrations installation"
-      class_option :orm, type: :string, default: "active_record",
-        desc: "ORM to be used for migrations"
-
-      def self.next_migration_number(dirname)
-        next_migration_number = current_migration_number(dirname) + 1
-        ActiveRecord::Migration.next_migration_number(next_migration_number)
-      end
-
-      def create_initializer
-        template "initializer.rb", "config/initializers/panda.rb"
-      end
-
-      def mount_engine
-        routes_file = File.join(destination_root, "config/routes.rb")
-        return unless File.exist?(routes_file)
-
-        route 'mount Panda::Core::Engine => "/"'
-      end
-
-      def show_readme
-        readme "README" if behavior == :invoke
-      end
-    end
-  end
-end

data/lib/generators/panda/core/templates/README

@@ -1,25 +0,0 @@
-===============================================================================
-
-Panda Core has been installed!
-
-Next steps:
-
-1. Install and run migrations:
-
-   rails panda:core:install:migrations
-   rails db:migrate
-
-2. Configure authentication providers in config/initializers/panda.rb
-   (Uncomment and configure the providers you want to use)
-
-3. Add the required OAuth gems to your Gemfile:
-
-   gem 'omniauth-google-oauth2'  # For Google authentication
-   gem 'omniauth-microsoft_graph' # For Microsoft authentication
-   gem 'omniauth-github'         # For GitHub authentication
-
-4. Configure your OAuth credentials in Rails credentials:
-
-   rails credentials:edit
-
-===============================================================================

data/lib/generators/panda/core/templates/initializer.rb

@@ -1,44 +0,0 @@
-Panda::Core.configure do |config|
-  config.admin_path = "/admin"
-
-  config.login_page_title = "Panda Admin"
-  config.admin_title = "Panda Admin"
-
-  # Configure authentication providers
-  # Uncomment and configure the providers you want to use
-  # Don't forget to add the corresponding gems (e.g., omniauth-google-oauth2)
-  #
-  # config.authentication_providers = {
-  #   google_oauth2: {
-  #     enabled: true,
-  #     name: "Google",  # Display name for the button
-  #     icon: "google",  # FontAwesome icon name (optional, auto-detected if not specified)
-  #     client_id: Rails.application.credentials.dig(:google, :client_id),
-  #     client_secret: Rails.application.credentials.dig(:google, :client_secret),
-  #     options: {
-  #       scope: "email,profile",
-  #       prompt: "select_account",
-  #       hd: "yourdomain.com" # Specify your domain here if you want to restrict admin logins
-  #     }
-  #   }
-  # }
-
-  # Configure the session token cookie name
-  config.session_token_cookie = :panda_session
-
-  # Configure the user class for the application
-  config.user_class = "Panda::Core::User"
-
-  # Configure the user identity class for the application
-  config.user_identity_class = "Panda::Core::UserIdentity"
-
-  # Configure the storage provider (default: :active_storage)
-  # config.storage_provider = :active_storage
-
-  # Configure the cache store (default: :memory_store)
-  # config.cache_store = :memory_store
-
-  # Configure EditorJS tools (optional)
-  # config.editor_js_tools = []
-  # config.editor_js_tool_config = {}
-end