flipper 0.28.3 → 1.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32360e70231522c5c5b41e5e9e889fd0d4df13c59ba223dd5416433d904954e5
-  data.tar.gz: 5ec60d72b7b00d4d4bb5458d5746a4df4b89f3656fa9d4c7bfeddb27caae9c81
+  metadata.gz: c886665703939f49361ef42fb82e951383cb53bd99f2b1d902add786f6793da0
+  data.tar.gz: b7af2d5972cc409f075390871dc96b225e495133917e0c5024db297760252e73
 SHA512:
-  metadata.gz: 12e61dc74aa548fe5b266c1d909e650190416d8350adfd12c608a84b16b5ede9cce4b753d74c5fed472506bfb0dd9a3e0e768bcb193f6f751408f9550513774e
-  data.tar.gz: a2c0dc70d0fd50848fe9aedc2ed9f8f396dd51f5b604badc1477efd0249104e9fa7276d5161ac95e25992d8b1765eadd491e9a1a1d79640c6644e9fdd69442f2
+  metadata.gz: 338ccb2e6d9ddeaa6f6a1f20755e7799dcda40341c22831f8eda1f25df5f08bf4c61d67333e9bdebf94172107842b07e7ddb3ec7a54a2d057663f109e78f5a5d
+  data.tar.gz: bbfdb72c366e7fa334d8c3903b799366bed22d755cf6771c532d1335cccf7e9480c8a752c700a449f1ae837ae273be5b9c06ef58bc38b56570d96ef417edbded

data/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: flippercloud

data/.github/workflows/ci.yml

@@ -1,53 +1,99 @@
 name: CI
-on: [push, pull_request]
+on: [push]
+
 jobs:
   test:
     name: Test on ruby ${{ matrix.ruby }} and rails ${{ matrix.rails }}
     runs-on: ubuntu-latest
+    timeout-minutes: 20
     services:
       redis:
         image: redis
-        ports: ['6379:6379']
+        ports: ["6379:6379"]
         options: >-
           --health-cmd "redis-cli ping"
           --health-interval 10s
           --health-timeout 5s
           --health-retries 5
+      memcached:
+        image: memcached
+        ports: ["11211:11211"]
+      postgres:
+        image: postgres:13
+        ports:
+          - 5432:5432
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
     strategy:
+      fail-fast: false
       matrix:
-        ruby: ['2.6', '2.7', '3.0', '3.1', '3.2']
-        rails: ['5.2', '6.0.0', '6.1.0', '7.0.0']
+        ruby: ["2.6", "2.7", "3.0", "3.1", "3.2", "3.3"]
+        rails: ["5.2", "6.0.0", "6.1.0", "7.0.0", "7.1.0", "7.2.0", "8.0.0"]
         exclude:
+          - ruby: "2.6"
+            rails: "7.1.0"
           - ruby: "2.6"
             rails: "7.0.0"
+          - ruby: "2.6"
+            rails: "7.2.0"
+          - ruby: "2.6"
+            rails: "8.0.0"
+          - ruby: "2.7"
+            rails: "7.1.0"
+          - ruby: "2.7"
+            rails: "7.2.0"
+          - ruby: "2.7"
+            rails: "8.0.0"
           - ruby: "3.0"
             rails: "5.2"
+          - ruby: "3.0"
+            rails: "7.2.0"
+          - ruby: "3.0"
+            rails: "8.0.0"
           - ruby: "3.1"
             rails: "5.2"
           - ruby: "3.1"
             rails: "6.0.0"
+          - ruby: "3.1"
+            rails: "8.0.0"
           - ruby: "3.2"
             rails: "5.2"
           - ruby: "3.2"
             rails: "6.0.0"
           - ruby: "3.2"
             rails: "6.1.0"
+          - ruby: "3.3"
+            rails: "5.2"
+          - ruby: "3.3"
+            rails: "6.0.0"
+          - ruby: "3.3"
+            rails: "6.1.0"
     env:
-      SQLITE3_VERSION: 1.4.1
+      SQLITE3_VERSION: ${{ matrix.rails == '8.0.0' && '2.1.0' || '1.4.1' }}
       REDIS_URL: redis://localhost:6379/0
       CI: true
       RAILS_VERSION: ${{ matrix.rails }}
+      MYSQL_USER: root
+      MYSQL_PASSWORD: root
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
     steps:
-      - name: Setup memcached
-        uses: KeisukeYamashita/memcached-actions@v1
+      - name: Set up MySQL
+        run: sudo /etc/init.d/mysql start
       - name: Start MongoDB
-        uses: supercharge/mongodb-github-action@1.9.0
+        uses: supercharge/mongodb-github-action@1.12.1
         with:
           mongodb-version: 4.0
       - name: Check out repository code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v6
       - name: Do some action caching
-        uses: actions/cache@v3
+        uses: actions/cache@v5
         with:
           path: vendor/bundle
           key: ${{ runner.os }}-gems-${{ matrix.ruby }}-${{ matrix.rails }}-${{ hashFiles('**/Gemfile.lock') }}

data/.github/workflows/examples.yml

@@ -1,14 +1,15 @@
 name: Examples
-on: [push, pull_request]
+on: [push]
 jobs:
   test:
-    if: github.repository_owner == 'jnunemaker'
-    name: Test on ruby ${{ matrix.ruby }} and rails ${{ matrix.rails }}
+    if: github.repository_owner == 'flippercloud'
+    name: Example on ruby ${{ matrix.ruby }} and rails ${{ matrix.rails }}
     runs-on: ubuntu-latest
+    timeout-minutes: 20
     services:
       redis:
         image: redis
-        ports: ['6379:6379']
+        ports: ["6379:6379"]
         options: >-
           --health-cmd "redis-cli ping"
           --health-interval 10s
@@ -16,20 +17,49 @@ jobs:
           --health-retries 5
     strategy:
       matrix:
-        ruby: ['2.6', '2.7', '3.0', '3.1']
-        rails: ['5.2', '6.0.0', '6.1.0', '7.0.0']
+        ruby: ["2.6", "2.7", "3.0", "3.1", "3.2", "3.3"]
+        rails: ["5.2", "6.0.0", "6.1.0", "7.0.0", "7.1.0", "7.2.0", "8.0.0"]
         exclude:
+          - ruby: "2.6"
+            rails: "7.1.0"
           - ruby: "2.6"
             rails: "7.0.0"
+          - ruby: "2.6"
+            rails: "7.2.0"
+          - ruby: "2.6"
+            rails: "8.0.0"
+          - ruby: "2.7"
+            rails: "7.1.0"
+          - ruby: "2.7"
+            rails: "7.2.0"
+          - ruby: "2.7"
+            rails: "8.0.0"
           - ruby: "3.0"
             rails: "5.2"
+          - ruby: "3.0"
+            rails: "7.2.0"
+          - ruby: "3.0"
+            rails: "8.0.0"
           - ruby: "3.1"
             rails: "5.2"
           - ruby: "3.1"
             rails: "6.0.0"
-
+          - ruby: "3.1"
+            rails: "8.0.0"
+          - ruby: "3.2"
+            rails: "5.2"
+          - ruby: "3.2"
+            rails: "6.0.0"
+          - ruby: "3.2"
+            rails: "6.1.0"
+          - ruby: "3.3"
+            rails: "5.2"
+          - ruby: "3.3"
+            rails: "6.0.0"
+          - ruby: "3.3"
+            rails: "6.1.0"
     env:
-      SQLITE3_VERSION: 1.4.1
+      SQLITE3_VERSION: ${{ matrix.rails == '8.0.0' && '2.1.0' || '1.4.1' }}
       REDIS_URL: redis://localhost:6379/0
       CI: true
       RAILS_VERSION: ${{ matrix.rails }}
@@ -37,13 +67,13 @@ jobs:
       - name: Setup memcached
         uses: KeisukeYamashita/memcached-actions@v1
       - name: Start MongoDB
-        uses: supercharge/mongodb-github-action@1.9.0
+        uses: supercharge/mongodb-github-action@1.12.1
         with:
           mongodb-version: 4.0
       - name: Check out repository code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v6
       - name: Do some action caching
-        uses: actions/cache@v3
+        uses: actions/cache@v5
         with:
           path: vendor/bundle
           key: ${{ runner.os }}-gems-${{ matrix.ruby }}-${{ matrix.rails }}-${{ hashFiles('**/Gemfile.lock') }}
@@ -59,4 +89,17 @@ jobs:
       - name: Run Examples with Rails ${{ matrix.rails }}
         env:
           FLIPPER_CLOUD_TOKEN: ${{ secrets.FLIPPER_CLOUD_TOKEN }}
+          FLIPPER_CLOUD_TOKEN_26_52: ${{ secrets.FLIPPER_CLOUD_TOKEN_26_52 }}
+          FLIPPER_CLOUD_TOKEN_26_60: ${{ secrets.FLIPPER_CLOUD_TOKEN_26_60 }}
+          FLIPPER_CLOUD_TOKEN_26_61: ${{ secrets.FLIPPER_CLOUD_TOKEN_26_61 }}
+          FLIPPER_CLOUD_TOKEN_27_52: ${{ secrets.FLIPPER_CLOUD_TOKEN_27_52 }}
+          FLIPPER_CLOUD_TOKEN_27_60: ${{ secrets.FLIPPER_CLOUD_TOKEN_27_60 }}
+          FLIPPER_CLOUD_TOKEN_27_61: ${{ secrets.FLIPPER_CLOUD_TOKEN_27_61 }}
+          FLIPPER_CLOUD_TOKEN_27_70: ${{ secrets.FLIPPER_CLOUD_TOKEN_27_70 }}
+          FLIPPER_CLOUD_TOKEN_30_60: ${{ secrets.FLIPPER_CLOUD_TOKEN_30_60 }}
+          FLIPPER_CLOUD_TOKEN_30_61: ${{ secrets.FLIPPER_CLOUD_TOKEN_30_61 }}
+          FLIPPER_CLOUD_TOKEN_30_70: ${{ secrets.FLIPPER_CLOUD_TOKEN_30_70 }}
+          FLIPPER_CLOUD_TOKEN_31_61: ${{ secrets.FLIPPER_CLOUD_TOKEN_31_61 }}
+          FLIPPER_CLOUD_TOKEN_31_70: ${{ secrets.FLIPPER_CLOUD_TOKEN_31_70 }}
+          RAILS_VERSION: ${{ matrix.rails }}
         run: script/examples

data/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write   # RubyGems trusted publishing (OIDC)
+      contents: write   # Create GitHub Releases
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+
+      - name: Build all gems
+        run: |
+          for gemspec in *.gemspec; do
+            gem build "$gemspec"
+          done
+          mkdir -p pkg
+          mv *.gem pkg/
+          echo "Built gems:"
+          ls -la pkg/
+
+      - name: Configure RubyGems credentials
+        uses: rubygems/configure-rubygems-credentials@v1.0.0
+
+      - name: Publish all gems
+        run: |
+          # Push core gem first since other gems depend on it
+          echo "Pushing flipper core gem..."
+          gem push pkg/flipper-[0-9]*.gem || echo "Core gem already pushed, continuing..."
+
+          for gem_file in pkg/flipper-*.gem; do
+            basename="$(basename "$gem_file")"
+            if [[ "$basename" =~ ^flipper-[0-9] ]]; then
+              continue
+            fi
+            echo "Pushing $basename..."
+            gem push "$gem_file" || echo "Failed to push $basename, continuing..."
+          done
+
+      - name: Create draft GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          draft: true
+          generate_release_notes: true
+          files: pkg/*.gem

data/.superset/config.json

@@ -0,0 +1,4 @@
+{
+  "setup": ["script/conductor-setup"],
+  "teardown": []
+}

data/CLAUDE.md

@@ -0,0 +1,93 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+### Testing
+- `bundle exec rake` - Run all tests (RSpec, Minitest, and Rails tests)
+- `bundle exec rspec` - Run RSpec tests only
+- `bundle exec rake spec:ui` - Run UI-specific specs
+- `bundle exec rake test` - Run Minitest tests only
+- `bundle exec rake test_rails` - Run Rails generator tests
+- `script/test` - Bootstrap and run tests across multiple Rails versions (5.0-8.0)
+
+### Development Setup
+- `script/bootstrap` - Bundle install dependencies and setup binstubs
+- `script/console` - Start interactive console with Flipper loaded (uses Pry)
+- `script/server` - Start local UI server on port 9999 for testing web interface
+
+### Releasing
+1. Bump version in `lib/flipper/version.rb`, commit, and push to main
+2. Tag and push: `git tag v1.x.x && git push origin v1.x.x`
+3. GitHub Actions (`.github/workflows/release.yml`) builds and publishes all 12 gems via RubyGems trusted publishing, then creates a draft GitHub Release
+4. Edit and publish the draft release at https://github.com/flippercloud/flipper/releases
+
+- `bundle exec rake build` - Build all gems locally into pkg/ directory
+- `script/release` - Manual fallback for local releases (prompts for OTP)
+
+**After releasing**, purge the cached release URLs on flippercloud.io:
+- `/release`
+- `/release.json`
+
+## Architecture Overview
+
+Flipper is a feature flag library for Ruby with a modular adapter-based architecture:
+
+### Core Components
+
+**DSL Layer** (`lib/flipper/dsl.rb`):
+- Main interface for feature flag operations
+- Delegates to Feature instances
+- Handles memoization and instrumentation
+- Thread-safe instance management
+
+**Feature** (`lib/flipper/feature.rb`):
+- Represents individual feature flags
+- Manages enable/disable operations through gates
+- Handles instrumentation events
+- Works with adapters for persistence
+
+**Adapters** (`lib/flipper/adapters/`):
+- Pluggable storage backends (Redis, ActiveRecord, Memory, etc.)
+- Common interface for all storage implementations
+- Support for caching, failover, and synchronization patterns
+
+**Gates** (`lib/flipper/gates/`):
+- Different targeting mechanisms:
+  - Boolean (on/off for everyone)
+  - Actor (specific users/entities)
+  - Group (predefined user groups)
+  - Percentage of Actors (rollout to X% of users)
+  - Percentage of Time (probabilistic enabling)
+  - Expression (complex conditional logic)
+
+### Multi-Gem Structure
+
+The project is structured as multiple gems:
+- `flipper` - Core library
+- `flipper-ui` - Web interface
+- `flipper-api` - REST API
+- `flipper-cloud` - Cloud service integration
+- `flipper-*` - Various adapter gems (redis, active_record, mongo, etc.)
+
+### Key Patterns
+
+**Configuration**: Global configuration through `Flipper.configure` with per-thread instances
+**Instrumentation**: Built-in event system for monitoring and debugging
+**Memoization**: Automatic caching of feature checks within request/thread scope
+**Type Safety**: Strong typing system for actors, percentages, and other values
+
+### Serialization and HTTP
+
+Use `Flipper::Typecast` for JSON and gzip serialization instead of calling `JSON.generate`/`JSON.parse` or `Zlib` directly:
+- `Typecast.to_json(hash)` / `Typecast.from_json(string)` for JSON serialization
+- `Typecast.to_gzip(string)` / `Typecast.from_gzip(string)` for gzip compression
+
+For outbound HTTP requests, use `Flipper::Adapters::Http::Client` instead of raw `Net::HTTP`. It provides timeouts, retries (`max_retries`), SSL verification, and diagnostic headers (user-agent, client-language, client-platform, etc.). See `lib/flipper/cloud/migrate.rb` for an example.
+
+### Testing
+
+Uses both RSpec (currently preferred for new tests) and Minitest. Shared adapter specs ensure consistency across all storage backends. Extensive testing across multiple Rails versions (5.0-8.0).
+
+`Flipper.configuration` is reset to nil before each spec (in `spec/spec_helper.rb`), but `Flipper::UI.configuration` is **not** globally reset. When modifying UI config in tests, set the value in `before` and reset it in `after` to match the existing pattern throughout the spec suite.