karafka 2.5.3 → 2.5.4.rc1

data/.github/workflows/ci_macos_arm64.yml

@@ -1,151 +0,0 @@
-name: CI macOS ARM64 Swarm
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-on:
-  pull_request:
-    branches: [ master ]
-  schedule:
-    - cron:  '0 2 * * *'
-
-permissions:
-  contents: read
-
-env:
-  BUNDLE_RETRY: 6
-  BUNDLE_JOBS: 4
-  CONFLUENT_VERSION: "8.0.0"
-
-jobs:
-  swarm-macos:
-    timeout-minutes: 30
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby:
-          - '3.5.0-preview1'
-          - '3.4'
-          - '3.3'
-          - '3.2'
-        macos-version:
-          - 'macos-14'
-          - 'macos-15'
-        exclude:
-          - ruby: '3.5.0-preview1'
-            macos-version: 'macos-14'
-    runs-on: ${{ matrix.macos-version }}
-    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-
-      - name: Remove Gemfile.lock for Ruby preview versions
-        if: contains(matrix.ruby, 'preview')
-        run: rm -f Gemfile.lock
-
-      - name: Install Bash 4+ and Kerberos
-        run: |
-          brew install bash
-          brew list krb5 &>/dev/null || brew install krb5
-          echo "/opt/homebrew/bin" >> $GITHUB_PATH
-      - name: Install and Start Confluent Community Kafka (KRaft)
-        run: |
-          brew install openjdk@17
-          export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"
-          export JAVA_HOME="/opt/homebrew/opt/openjdk@17"
-
-          curl -O "https://packages.confluent.io/archive/8.0/confluent-community-${CONFLUENT_VERSION}.tar.gz"
-          tar -xzf "confluent-community-${CONFLUENT_VERSION}.tar.gz"
-
-          export CONFLUENT_HOME="$(pwd)/confluent-${CONFLUENT_VERSION}"
-          export PATH="$CONFLUENT_HOME/bin:$PATH"
-          cd "$CONFLUENT_HOME"
-
-          # Find the correct server config
-          KRAFT_CONFIG=""
-          for config in "etc/kafka/kraft/server.properties" "config/kraft/server.properties" "etc/kafka/server.properties"; do
-            if [ -f "$config" ]; then
-              KRAFT_CONFIG="$config"
-              echo "Found config: $KRAFT_CONFIG"
-              break
-            fi
-          done
-
-          if [ -z "$KRAFT_CONFIG" ]; then
-            echo "❌ No server config found"
-            exit 1
-          fi
-
-          # Configure KRaft for single-node setup
-          cat >> "$KRAFT_CONFIG" << 'EOF'
-
-          # KRaft mode configuration for single-node setup
-          process.roles=broker,controller
-          node.id=1
-          controller.quorum.voters=1@127.0.0.1:9093
-          listeners=PLAINTEXT://0.0.0.0:9092,CONTROLLER://127.0.0.1:9093
-          advertised.listeners=PLAINTEXT://127.0.0.1:9092
-          controller.listener.names=CONTROLLER
-          inter.broker.listener.name=PLAINTEXT
-          log.dirs=/tmp/kraft-combined-logs
-
-          # Enable simple ACL authorization for testing
-          authorizer.class.name=org.apache.kafka.metadata.authorizer.StandardAuthorizer
-          super.users=User:ANONYMOUS
-          allow.everyone.if.no.acl.found=true
-          EOF
-
-          echo "Updated KRaft configuration"
-
-          CLUSTER_ID=$(bin/kafka-storage random-uuid)
-          bin/kafka-storage format -t "$CLUSTER_ID" -c "$KRAFT_CONFIG"
-          bin/kafka-server-start "$KRAFT_CONFIG" &
-
-          sleep 20
-
-          for i in {1..30}; do
-            if bin/kafka-topics --bootstrap-server 127.0.0.1:9092 --list >/dev/null 2>&1; then
-              echo "✅ Confluent Community ${CONFLUENT_VERSION} (KRaft) is ready!"
-              break
-            fi
-            [ $i -eq 30 ] && { echo "❌ Kafka failed to start"; exit 1; }
-            sleep 2
-          done
-
-      - name: Remove Gemfile.lock for Ruby dev/preview versions
-        if: contains(matrix.ruby, 'dev') || contains(matrix.ruby, 'preview') || contains(matrix.ruby, 'rc')
-        run: rm -f Gemfile.lock
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@d5126b9b3579e429dd52e51e68624dda2e05be25 # v1.267.0
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-          bundler: 'latest'
-
-      - name: Run swarm unit specs
-        run: bundle exec rspec spec/lib/karafka/swarm/ --tag mode:fork
-
-      - name: Run all swarm integration specs
-        env:
-          KARAFKA_PRO_LICENSE_TOKEN: ${{ secrets.KARAFKA_PRO_LICENSE_TOKEN }}
-          KARAFKA_PRO_USERNAME: ${{ secrets.KARAFKA_PRO_USERNAME }}
-          KARAFKA_PRO_PASSWORD: ${{ secrets.KARAFKA_PRO_PASSWORD }}
-          KARAFKA_PRO_VERSION: ${{ secrets.KARAFKA_PRO_VERSION }}
-          KARAFKA_PRO_LICENSE_CHECKSUM: ${{ secrets.KARAFKA_PRO_LICENSE_CHECKSUM }}
-        run: bin/integrations swarm
-
-  ci-success-macos:
-    name: CI macOS ARM64 Swarm Success
-    runs-on: ubuntu-latest
-    if: always()
-    needs:
-      - swarm-macos
-    steps:
-      - name: Check all jobs passed
-        if: |
-          contains(needs.*.result, 'failure') ||
-          contains(needs.*.result, 'cancelled') ||
-          contains(needs.*.result, 'skipped')
-        run: exit 1
-      - run: echo "All macOS ARM64 Swarm CI checks passed!"

data/.github/workflows/push.yml

@@ -1,35 +0,0 @@
-name: Push Gem
-
-on:
-  push:
-    tags:
-      - v*
-
-permissions:
-  contents: read
-
-jobs:
-  push:
-    if: github.repository_owner == 'karafka'
-    runs-on: ubuntu-latest
-    environment: deployment
-
-    permissions:
-      contents: write
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-        with:
-          fetch-depth: 0
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@d5126b9b3579e429dd52e51e68624dda2e05be25 # v1.267.0
-        with:
-          bundler-cache: false
-
-      - name: Bundle install
-        run: |
-          bundle install --jobs 4 --retry 3
-
-      - uses: rubygems/release-gem@1c162a739e8b4cb21a676e97b087e8268d8fc40b # v1.1.2

data/.github/workflows/trigger-wiki-refresh.yml

@@ -1,30 +0,0 @@
-name: Trigger Wiki Refresh
-
-on:
-  release:
-    types: [published]
-  push:
-    branches: [master]
-
-jobs:
-  trigger-wiki-refresh:
-    runs-on: ubuntu-latest
-    environment: wiki-trigger
-    if: github.repository_owner == 'karafka'
-    steps:
-      - name: Trigger wiki refresh
-        uses: peter-evans/repository-dispatch@5fc4efd1a4797ddb68ffd0714a238564e4cc0e6f # v4.0.0
-        with:
-          token: ${{ secrets.WIKI_REPO_TOKEN }}
-          repository: karafka/wiki
-          event-type: sync-trigger
-          client-payload: |
-            {
-              "repository": "${{ github.repository }}",
-              "event_name": "${{ github.event_name }}",
-              "release_tag": "${{ github.event.release.tag_name || '' }}",
-              "release_name": "${{ github.event.release.name || '' }}",
-              "commit_sha": "${{ github.sha }}",
-              "commit_message": "Trigger Wiki Refresh",
-              "triggered_by": "${{ github.actor }}"
-            }

data/.github/workflows/verify-action-pins.yml

@@ -1,16 +0,0 @@
-name: Verify Action Pins
-on:
-  pull_request:
-    paths:
-      - '.github/workflows/**'
-jobs:
-  verify_action_pins:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-      - name: Check SHA pins
-        run: |
-          if grep -E -r "uses: .*/.*@(v[0-9]+|main|master)($|[[:space:]]|$)" --include="*.yml" --include="*.yaml" .github/workflows/ | grep -v "#"; then
-            echo "::error::Actions should use SHA pins, not tags or branch names"
-            exit 1
-          fi

data/.gitignore

@@ -1,69 +0,0 @@
-# bundler state
-/.bundle
-/vendor/bundle/
-/vendor/ruby/
-/ruby/
-app.god
-
-# minimal Rails specific artifacts
-/.coditsu/local.yml
-db/*.sqlite3
-/log/development.log
-/log/production.log
-/log/test.log
-/tmp/*
-*.gem
-*.~
-
-# various artifacts
-**.war
-*.rbc
-*.sassc
-.byebug_history
-.redcar/
-.capistrano/
-.sass-cache
-/config/god/sidekiq.rb
-/config/puma.rb
-/coverage.data
-/coverage/
-/doc/api/
-/doc/app/
-/doc/yard
-/doc/features.html
-/doc/specs.html
-/spec/tmp/*
-/cache
-/capybara*
-/capybara-*.html
-/gems
-/specifications
-rerun.txt
-pickle-email-*.html
-
-# If you find yourself ignoring temporary files generated by your text editor
-# or operating system, you probably want to add a global ignore instead:
-#   git config --global core.excludesfile ~/.gitignore_global
-#
-# Here are some files you may want to ignore globally:
-
-# scm revert files
-**.orig
-
-# Mac finder artifacts
-.DS_Store
-
-# Netbeans project directory
-/nbproject
-
-# RubyMine project files
-.idea
-
-# Textmate project files
-/*.tmproj
-
-# vim artifacts
-**.swp
-
-# documentation
-.yardoc

data/.rspec

@@ -1,7 +0,0 @@
---require spec_helper
-# Integration specs run with their one framework, not via RSpec
---exclude-pattern "spec/integrations/**/*_spec.rb"
-# Do not run pro at the same time as default specs as it would cause state conflicts
---tag ~type:pro
-# Do not run fork because they need to run in isolation
---tag ~mode:fork

data/.ruby-gemset

@@ -1 +0,0 @@
-karafka

data/.ruby-version

@@ -1 +0,0 @@
-3.4.7

data/.yard-lint.yml

@@ -1,174 +0,0 @@
-# YARD-Lint Configuration
-# See https://github.com/mensfeld/yard-lint for documentation
-
-# Global settings for all validators
-AllValidators:
-  # YARD command-line options (applied to all validators by default)
-  YardOptions:
-    - --private
-    - --protected
-
-  # Global file exclusion patterns
-  Exclude:
-    - '\.git'
-    - 'vendor/**/*'
-    - 'node_modules/**/*'
-    - 'spec/**/*'
-    - 'test/**/*'
-
-  # Exit code behavior (error, warning, convention, never)
-  FailOnSeverity: error
-
-  # Minimum documentation coverage percentage (0-100)
-  # Fails if coverage is below this threshold
-  MinCoverage: 99.0
-
-  # Diff mode settings
-  DiffMode:
-    # Default base ref for --diff (auto-detects main/master if not specified)
-    DefaultBaseRef: ~
-
-# Documentation validators
-Documentation/UndocumentedObjects:
-  Description: 'Checks for classes, modules, and methods without documentation.'
-  Enabled: true
-  Severity: error
-  ExcludedMethods:
-    - 'initialize/0'  # Exclude parameter-less initialize
-    - '/^_/'          # Exclude private methods (by convention)
-
-Documentation/UndocumentedMethodArguments:
-  Description: 'Checks for method parameters without @param tags.'
-  Enabled: true
-  Severity: error
-
-Documentation/UndocumentedBooleanMethods:
-  Description: 'Checks that question mark methods document their boolean return.'
-  Enabled: true
-  Severity: error
-
-Documentation/UndocumentedOptions:
-  Description: 'Detects methods with options hash parameters but no @option tags.'
-  Enabled: true
-  Severity: error
-
-Documentation/MarkdownSyntax:
-  Description: 'Detects common markdown syntax errors in documentation.'
-  Enabled: true
-  Severity: error
-
-# Tags validators
-Tags/Order:
-  Description: 'Enforces consistent ordering of YARD tags.'
-  Enabled: true
-  Severity: error
-  EnforcedOrder:
-    - param
-    - option
-    - return
-    - raise
-    - example
-
-Tags/InvalidTypes:
-  Description: 'Validates type definitions in @param, @return, @option tags.'
-  Enabled: true
-  Severity: error
-  ValidatedTags:
-    - param
-    - option
-    - return
-
-Tags/TypeSyntax:
-  Description: 'Validates YARD type syntax using YARD parser.'
-  Enabled: true
-  Severity: error
-  ValidatedTags:
-    - param
-    - option
-    - return
-    - yieldreturn
-
-Tags/MeaninglessTag:
-  Description: 'Detects @param/@option tags on classes, modules, or constants.'
-  Enabled: true
-  Severity: error
-  CheckedTags:
-    - param
-    - option
-  InvalidObjectTypes:
-    - class
-    - module
-    - constant
-
-Tags/CollectionType:
-  Description: 'Validates Hash collection syntax consistency.'
-  Enabled: true
-  Severity: error
-  EnforcedStyle: long  # 'long' for Hash{K => V} (YARD standard), 'short' for {K => V}
-  ValidatedTags:
-    - param
-    - option
-    - return
-    - yieldreturn
-
-Tags/TagTypePosition:
-  Description: 'Validates type annotation position in tags.'
-  Enabled: true
-  Severity: error
-  CheckedTags:
-    - param
-    - option
-  # EnforcedStyle: 'type_after_name' (YARD standard: @param name [Type])
-  #                or 'type_first' (@param [Type] name)
-  EnforcedStyle: type_after_name
-
-Tags/ApiTags:
-  Description: 'Enforces @api tags on public objects.'
-  Enabled: false  # Opt-in validator
-  Severity: error
-  AllowedApis:
-    - public
-    - private
-    - internal
-
-Tags/OptionTags:
-  Description: 'Requires @option tags for methods with options parameters.'
-  Enabled: true
-  Severity: error
-
-# Warnings validators - catches YARD parser errors
-Warnings/UnknownTag:
-  Description: 'Detects unknown YARD tags.'
-  Enabled: true
-  Severity: error
-
-Warnings/UnknownDirective:
-  Description: 'Detects unknown YARD directives.'
-  Enabled: true
-  Severity: error
-
-Warnings/InvalidTagFormat:
-  Description: 'Detects malformed tag syntax.'
-  Enabled: true
-  Severity: error
-
-Warnings/InvalidDirectiveFormat:
-  Description: 'Detects malformed directive syntax.'
-  Enabled: true
-  Severity: error
-
-Warnings/DuplicatedParameterName:
-  Description: 'Detects duplicate @param tags.'
-  Enabled: true
-  Severity: error
-
-Warnings/UnknownParameterName:
-  Description: 'Detects @param tags for non-existent parameters.'
-  Enabled: true
-  Severity: error
-
-# Semantic validators
-Semantic/AbstractMethods:
-  Description: 'Ensures @abstract methods do not have real implementations.'
-  Enabled: true
-  Severity: error

data/CODE_OF_CONDUCT.md

@@ -1,46 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at maciej@mensfeld.pl. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
-
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/

data/CONTRIBUTING.md

@@ -1,32 +0,0 @@
-# Contributing
-
-## Introduction
-
-First, thank you for considering contributing to the Karafka ecosystem! It's people like you that make the open source community such a great community! 😊
-
-We welcome any type of contribution, not only code. You can help with:
-- **QA**: file bug reports, the more details you can give the better (e.g. screenshots with the console open)
-- **Marketing**: writing blog posts, howto's, printing stickers, ...
-- **Community**: presenting the project at meetups, organizing a dedicated meetup for the local community, ...
-- **Code**: take a look at the [open issues](https://github.com/karafka/karafka/issues). Even if you can't write code, commenting on them, showing that you care about a given issue matters. It helps us triage them.
-
-## Submitting code
-
-Any code change should be submitted as a pull request. The description should explain what the code does and give steps to execute it. The pull request should also contain tests.
-
-### Code review process
-
-Each pull request must pass all the rspec specs and meet our quality requirements.
-
-To check if everything is as it should be, we use [Coditsu](https://coditsu.io) that combines multiple linters and code analyzers for both code and documentation. Once you're done with your changes, submit a pull request.
-
-### Contributing to Pro components
-
-All of Karafka components are open-source. However, the `Pro` components are licenses under `LICENSE-COMM`.
-
-By sending a pull request to the pro components, you are agreeing to transfer the copyright of your code to Maciej Mensfeld.
-
-## Questions
-
-If you have any questions, create an [issue](https://github.com/karafka/karafka/issues) (protip: do a quick search first to see if someone else didn't ask the same question before!).
-You can also reach us at contact@karafka.io.

data/Gemfile

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gemspec
-
-# Karafka gem does not require activejob, karafka-web or fugit to work
-# They are added here because they are part of the integration suite
-# Since some of those are only needed for some specs, they should never be required automatically
-group :integrations, :test do
-  gem 'fugit', require: false
-  gem 'rspec', require: false
-  gem 'stringio'
-  gem 'warning'
-end
-
-group :integrations do
-  gem 'activejob', require: false
-  gem 'karafka-testing', '>= 2.5.0', require: false
-  gem 'karafka-web', '>= 0.11.1', require: false
-end
-
-group :test do
-  gem 'byebug'
-  gem 'factory_bot'
-  gem 'ostruct'
-  gem 'simplecov'
-  gem 'yard-lint'
-end