chrome_devtools_rails 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c60e34e0904582d3e8c0531e9324d9bb6f8e6224fc58d3589b5f78cee5b4b596
-  data.tar.gz: 912ac8c111b3383eb7389397945069a4d7b070ab573936f2e3648cad5a841d1c
+  metadata.gz: 9c381d4a513a6e86b1421ef6b69b91f89890772fd3e0722ac9ab30fed11f60c6
+  data.tar.gz: 6795b53860fc2af2e34195868cd2a52cb24e44d7f8ec1b8359c94ac1777a87c2
 SHA512:
-  metadata.gz: 1380a9d09a80ee92e2743e012ee465513cea02daf18ad01edf6a4d881acb562dad539bdb4998f6da28759a43f726045318fd98676f2d445b82ecd54e6e5ec44a
-  data.tar.gz: 51de32faa41e403cb1cab7f6a666145f870c5adfdb8b6fd8cba01148f0dff8171974ad024e2bd53e5bd61062953dcad2a936d992f22072232a4dfbc847f99768
+  metadata.gz: cfa03fc5f125c04ce9e3f4796b60d244289c373f7d07e2a797e2d09fe3c532119ade82fa047dc1ba28c083ee786e7cd0285ce586faa9c4f11f0e9cfaf83eb7db
+  data.tar.gz: 512dfb00464bf454619d392c57f3affe8f8c8c2128d0c67721d5f88abf2098c2018471a8d60566d576fe070a74cb6bcc8ecdf81556476a933bc5d44dcc9425d6

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daniel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -12,6 +12,14 @@ This engine is **automatically mounted** and only active in **development mode**
 
 ---
 
+## ⚠️ Rails 8.2+ ships this natively
+
+As of **Rails 8.2**, Rails serves this endpoint itself through a built-in `Rails::DevToolsController` ([rails/rails#56245](https://github.com/rails/rails/pull/56245)). On Rails 8.2 or newer, uncomment the generated devtools route in `config/routes.rb` and you no longer need this gem.
+
+This gem is still useful on **Rails 8.0 and 8.1**, which have no native support. When it detects Rails 8.2+, it keeps serving the endpoint but emits a deprecation warning so you know you can switch to the native controller and drop the dependency.
+
+---
+
 ## 🚀 Usage
 
 1. Visit your Rails app on `localhost`.
@@ -41,7 +49,7 @@ No route configuration is needed — the engine mounts itself automatically in d
 
 ## ✅ Requirements
 
-- Ruby ≥ 3.1
+- Ruby ≥ 3.2
 - Rails ≥ 8.0.2
 - Google Chrome v89+ (with DevTools workspace support)
 
@@ -51,14 +59,8 @@ No route configuration is needed — the engine mounts itself automatically in d
 
 Pull requests are welcome on GitHub at [https://github.com/6temes/chrome_devtools_rails](https://github.com/6temes/chrome_devtools_rails).
 
-Ideas for improvement:
-
-- Add support for regenerating the UUID
-- Configurable root path
-- Rake task or generator to inspect the current workspace config
-
 ---
 
 ## 📄 License
 
-This gem is open source and released under the [MIT License](https://opensource.org/licenses/MIT).
+This gem is open source and released under the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -1,8 +1,10 @@
-require "bundler/setup"
-
-APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
-load "rails/tasks/engine.rake"
+require "bundler/gem_tasks"
+require "rake/testtask"
 
-load "rails/tasks/statistics.rake"
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+  t.verbose = false
+end
 
-require "bundler/gem_tasks"
+task default: :test

data/lib/chrome_devtools_rails/engine.rb

@@ -10,6 +10,8 @@ module ChromeDevtoolsRails
               as: :chrome_devtools_json
         end
       end
+
+      ChromeDevtoolsRails.warn_if_superseded if Rails.env.development?
     end
   end
 end

data/lib/chrome_devtools_rails/version.rb

@@ -1,3 +1,3 @@
 module ChromeDevtoolsRails
-  VERSION = "0.1.0"
+  VERSION = ENV.fetch("CHROME_DEVTOOLS_RAILS_VERSION", "0.0.0.dev")
 end

data/lib/chrome_devtools_rails.rb

@@ -1,2 +1,31 @@
 require "chrome_devtools_rails/version"
 require "chrome_devtools_rails/engine"
+
+module ChromeDevtoolsRails
+  # Rails serves /.well-known/appspecific/com.chrome.devtools.json natively from
+  # this version on, via the built-in Rails::DevToolsController, which makes this
+  # gem unnecessary. See https://github.com/rails/rails/pull/56245.
+  RAILS_NATIVE_SUPPORT_VERSION = Gem::Version.new("8.2")
+
+  def self.deprecator
+    @_deprecator ||= ActiveSupport::Deprecation.new("1.0", "chrome_devtools_rails")
+  end
+
+  def self.superseded_by_rails?
+    Rails.gem_version >= RAILS_NATIVE_SUPPORT_VERSION
+  end
+
+  # Emitted at boot once Rails ships its own endpoint, so apps know they can drop
+  # the gem. The route is still served, so nothing breaks on upgrade — this only
+  # nudges migration to the native controller.
+  def self.warn_if_superseded
+    return unless superseded_by_rails?
+
+    deprecator.warn(
+      "chrome_devtools_rails is no longer needed on Rails #{Rails.version}: Rails serves " \
+      "/.well-known/appspecific/com.chrome.devtools.json natively via Rails::DevToolsController. " \
+      "Uncomment the devtools route in config/routes.rb and remove this gem from your Gemfile. " \
+      "See https://github.com/rails/rails/pull/56245."
+    )
+  end
+end

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: chrome_devtools_rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
-- "Daniel Lopez \U0001F47E"
+- Daniel López Prat
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -38,8 +38,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
-- MIT-LICENSE
+- LICENSE
 - README.md
 - Rakefile
 - app/controllers/chrome_devtools_rails/devtools_controller.rb
@@ -50,11 +49,10 @@ homepage: https://github.com/6temes/chrome_devtools_rails
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/6temes/chrome_devtools_rails
-  source_code_uri: https://github.com/6temes/chrome_devtools_rails/tree/main
-  documentation_uri: https://github.com/6temes/chrome_devtools_rails/blob/main/README.md
-  changelog_uri: https://github.com/6temes/chrome_devtools_rails/blob/main/CHANGELOG.md
-  allowed_push_host: https://rubygems.org
+  bug_tracker_uri: https://github.com/6temes/chrome_devtools_rails/issues
+  changelog_uri: https://github.com/6temes/chrome_devtools_rails/releases
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/6temes/chrome_devtools_rails
 rdoc_options: []
 require_paths:
 - lib
@@ -62,14 +60,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Serve com.chrome.devtools.json for Chrome automatic workspace setup
 test_files: []

data/CHANGELOG.md

@@ -1,14 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.1.0] - 2023-05-19
-
-### Added
-- Initial release
-- Automatic workspace mapping for Chrome DevTools
-- Serves JSON file at `/.well-known/appspecific/com.chrome.devtools.json`
-- UUID persistence in `tmp/chrome_devtools_uuid`

data/MIT-LICENSE

@@ -1,20 +0,0 @@
-Copyright Daniel Lopez 👾
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.