tailwindcss-ruby 4.0.0.beta.9-x86_64-linux-gnu

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5fd996ff6a3bb853f9c35e7b07ccb86320d06713219e1a2ad75b82bc87ec8899
+  data.tar.gz: eb7d9f34a84ea69e1a69acc5247e341c91db0a03d9ada90053f5e371421ce8c0
+SHA512:
+  metadata.gz: 435eca761f758669a149cd2fc00d9c6c8cc025d57997e55709e4ea1aa3f59f488d005afbacc6c6558b7681579e4b63ff558b14c36bfd062c7004386e0de50360
+  data.tar.gz: 017f65cf2507c6d14bb066a687e35da46565a64a3774710e2e9b812e9cca221f25ec759e3bc43ba1df8e5e7ddcfbb39523a7593ab8e9066267494c3a64c65fb3

data/LICENSE-DEPENDENCIES

@@ -0,0 +1,26 @@
+tailwindcss-ruby may redistribute executables from the https://github.com/tailwindlabs/tailwindcss project
+
+The license for that software can be found at https://github.com/tailwindlabs/tailwindcss/blob/master/LICENSE which is reproduced here for your convenience:
+
+    MIT License
+    
+    Copyright (c) Adam Wathan <adam.wathan@gmail.com>
+    Copyright (c) Jonathan Reinink <jonathan@reinink.ca>
+    
+    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/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020-2024 Mike Dalessio, David Heinemeier Hansson
+
+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

@@ -0,0 +1,159 @@
+# Tailwindcss::Ruby
+
+A self-contained `tailwindcss` executable, wrapped up in a ruby gem. That's it. Nothing else.
+
+If you're looking to leverage tailwindcss in your Rails project, please see https://github.com/rails/tailwindcss-rails for integration that is supported by the Rails team.
+
+
+## Installation
+
+This gem wraps [the standalone executable version](https://tailwindcss.com/blog/standalone-cli) of the Tailwind CSS v3 framework. These executables are platform specific, so there are actually separate underlying gems per platform, but the correct gem will automatically be picked for your platform.
+
+Supported platforms are:
+
+- arm64-darwin (macos-arm64)
+- x64-mingw32 (windows-x64)
+- x64-mingw-ucr (windows-x64)
+- x86_64-darwin (macos-x64)
+- x86_64-linux (linux-x64)
+- aarch64-linux (linux-arm64)
+- arm-linux (linux-armv7)
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add tailwindcss-ruby
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install tailwindcss-ruby
+```
+
+### Using a local installation of `tailwindcss`
+
+If you are not able to use the vendored standalone executables (for example, if you're on an unsupported platform), you can use a [local installation](https://tailwindcss.com/docs/installation) of the `tailwindcss` executable by setting an environment variable named `TAILWINDCSS_INSTALL_DIR` to the directory path containing the executable.
+
+For example, if you've installed `tailwindcss` so that the executable is found at `/path/to/node_modules/bin/tailwindcss`, then you should set your environment variable like so:
+
+``` sh
+TAILWINDCSS_INSTALL_DIR=/path/to/node_modules/bin
+```
+
+or, for relative paths like `./node_modules/.bin/tailwindcss`:
+
+``` sh
+TAILWINDCSS_INSTALL_DIR=node_modules/.bin
+```
+
+
+## Versioning
+
+This gem will always have the same version number as the underlying TailwindCSS release. For example, the gem with version v3.4.13 will package upstream TailwindCSS v3.4.13.
+
+If there ever needs to be multiple releases for the same version of TailwindCSS, the version will contain an additional digit. For example, if we re-released TailwindCSS v3.4.13, it might be shipped in gem version v3.4.13.1 or v3.4.13.2.
+
+
+## Usage
+
+### Ruby
+
+The gem makes available `Tailwindcss::Ruby.executable` which is the path to the vendored standalone executable.
+
+``` ruby
+require "tailwindcss/ruby"
+Tailwindcss::Ruby.executable
+# => "/path/to/installs/ruby/3.3.5/lib/ruby/gems/3.3.0/gems/tailwindcss-ruby-0.1.0-x86_64-linux/exe/x86_64-linux/tailwindcss"
+```
+
+
+### Command line
+
+This gem provides an executable `tailwindcss` shim that will run the vendored standalone executable.
+
+``` bash
+# where is the shim?
+$ bundle exec which tailwindcss
+/path/to/installs/ruby/3.3/bin/tailwindcss
+
+# run the actual executable through the shim
+$ bundle exec tailwindcss --help
+["/path/to/installs/ruby/3.3.5/lib/ruby/gems/3.3.0/gems/tailwindcss-ruby-0.1.0-x86_64-linux/exe/x86_64-linux/tailwindcss", "--help"]
+
+tailwindcss v3.4.3
+
+Usage:
+   tailwindcss [--input input.css] [--output output.css] [--watch] [options...]
+   tailwindcss init [--full] [--postcss] [options...]
+
+Commands:
+   init [options]
+
+Options:
+   -i, --input              Input file
+   -o, --output             Output file
+   -w, --watch              Watch for changes and rebuild as needed
+   -p, --poll               Use polling instead of filesystem events when watching
+       --content            Content paths to use for removing unused classes
+       --postcss            Load custom PostCSS configuration
+   -m, --minify             Minify the output
+   -c, --config             Path to a custom config file
+       --no-autoprefixer    Disable autoprefixer
+   -h, --help               Display usage information
+```
+
+
+## Troubleshooting
+
+### `ERROR: Cannot find the tailwindcss executable` for supported platform
+
+Some users are reporting this error even when running on one of the supported native platforms:
+
+- arm64-darwin
+- x64-mingw32
+- x64-mingw-ucrt
+- x86_64-darwin
+- x86_64-linux
+- aarch64-linux
+
+#### Check Bundler PLATFORMS
+
+A possible cause of this is that Bundler has not been told to include native gems for your current platform. Please check your `Gemfile.lock` file to see whether your native platform is included in the `PLATFORMS` section. If necessary, run:
+
+``` sh
+bundle lock --add-platform <platform-name>
+```
+
+and re-bundle.
+
+
+#### Check BUNDLE_FORCE_RUBY_PLATFORM
+
+Another common cause of this is that bundler is configured to always use the "ruby" platform via the
+`BUNDLE_FORCE_RUBY_PLATFORM` config parameter being set to `true`. Please remove this configuration:
+
+``` sh
+bundle config unset force_ruby_platform
+# or
+bundle config set --local force_ruby_platform false
+```
+
+and re-bundle.
+
+See https://bundler.io/man/bundle-config.1.html for more information.
+
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/flavorjones/tailwindcss-ruby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/flavorjones/tailwindcss-ruby/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+Tailwind CSS is [released under the MIT License](https://github.com/tailwindlabs/tailwindcss/blob/next/LICENSE).
+
+## Code of Conduct
+
+Everyone interacting in the Tailwindcss::Ruby project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/flavorjones/tailwindcss-ruby/blob/main/CODE_OF_CONDUCT.md).

data/exe/tailwindcss

@@ -0,0 +1,19 @@
+#! /usr/bin/env ruby
+# because rubygems shims assume a gem's executables are Ruby
+
+require "tailwindcss/ruby"
+
+begin
+  command = [Tailwindcss::Ruby.executable, *ARGV]
+  puts command.inspect
+  if Gem.win_platform?
+    # use system rather than exec as exec inexplicably fails to find the executable on Windows
+    # see related https://github.com/rubys/sprockets-esbuild/pull/4
+    system(*command, exception: true)
+  else
+    exec(*command)
+  end
+rescue Tailwindcss::Ruby::UnsupportedPlatformException, Tailwindcss::Ruby::ExecutableNotFoundException => e
+  STDERR.puts("ERROR: " + e.message)
+  exit 1
+end

data/lib/tailwindcss/ruby/upstream.rb

@@ -0,0 +1,19 @@
+module Tailwindcss
+  module Ruby
+    module Upstream
+      VERSION = "v4.0.0-beta.9"
+
+      # rubygems platform name => upstream release filename
+      NATIVE_PLATFORMS = {
+        "arm64-darwin" => "tailwindcss-macos-arm64",
+        "x64-mingw32" => "tailwindcss-windows-x64.exe",
+        "x64-mingw-ucrt" => "tailwindcss-windows-x64.exe",
+        "x86_64-darwin" => "tailwindcss-macos-x64",
+        "x86_64-linux-gnu" => "tailwindcss-linux-x64",
+        "x86_64-linux-musl" => "tailwindcss-linux-x64-musl",
+        "aarch64-linux-gnu" => "tailwindcss-linux-arm64",
+        "aarch64-linux-musl" => "tailwindcss-linux-arm64-musl",
+      }
+    end
+  end
+end

data/lib/tailwindcss/ruby/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Tailwindcss
+  module Ruby
+    VERSION = "4.0.0.beta.9"
+  end
+end

data/lib/tailwindcss/ruby.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require_relative "ruby/version"
+require_relative "ruby/upstream"
+
+module Tailwindcss
+  module Ruby
+    DEFAULT_DIR = File.expand_path(File.join(__dir__, "..", "..", "exe"))
+    GEM_NAME = "tailwindcss-ruby"
+
+    # raised when the host platform is not supported by upstream tailwindcss's binary releases
+    class UnsupportedPlatformException < StandardError
+    end
+
+    # raised when the tailwindcss executable could not be found where we expected it to be
+    class ExecutableNotFoundException < StandardError
+    end
+
+    # raised when TAILWINDCSS_INSTALL_DIR does not exist
+    class DirectoryNotFoundException < StandardError
+    end
+
+    class << self
+      def platform
+        [:cpu, :os].map { |m| Gem::Platform.local.send(m) }.join("-")
+      end
+
+      def executable(exe_path: DEFAULT_DIR)
+        tailwindcss_install_dir = ENV["TAILWINDCSS_INSTALL_DIR"]
+        if tailwindcss_install_dir
+          if File.directory?(tailwindcss_install_dir)
+            warn "NOTE: using TAILWINDCSS_INSTALL_DIR to find tailwindcss executable: #{tailwindcss_install_dir}"
+            exe_path = tailwindcss_install_dir
+            exe_file = File.expand_path(File.join(tailwindcss_install_dir, "tailwindcss"))
+          else
+            raise DirectoryNotFoundException, <<~MESSAGE
+              TAILWINDCSS_INSTALL_DIR is set to #{tailwindcss_install_dir}, but that directory does not exist.
+            MESSAGE
+          end
+        else
+          if Tailwindcss::Ruby::Upstream::NATIVE_PLATFORMS.keys.none? { |p| Gem::Platform.match_gem?(Gem::Platform.new(p), GEM_NAME) }
+            raise UnsupportedPlatformException, <<~MESSAGE
+              #{GEM_NAME} does not support the #{platform} platform
+              See https://github.com/flavorjones/tailwindcss-ruby#using-a-local-installation-of-tailwindcss
+              for more details.
+            MESSAGE
+          end
+
+          exe_file = Dir.glob(File.expand_path(File.join(exe_path, "*", "tailwindcss"))).find do |f|
+            Gem::Platform.match_gem?(Gem::Platform.new(File.basename(File.dirname(f))), GEM_NAME)
+          end
+        end
+
+        if exe_file.nil? || !File.exist?(exe_file)
+          raise ExecutableNotFoundException, <<~MESSAGE
+            Cannot find the tailwindcss executable for #{platform} in #{exe_path}
+
+            If you're using bundler, please make sure you're on the latest bundler version:
+
+                gem install bundler
+                bundle update --bundler
+
+            Then make sure your lock file includes this platform by running:
+
+                bundle lock --add-platform #{platform}
+                bundle install
+
+            See `bundle lock --help` output for details.
+
+            If you're still seeing this message after taking those steps, try running
+            `bundle config` and ensure `force_ruby_platform` isn't set to `true`. See
+            https://github.com/flavorjones/tailwindcss-ruby#check-bundle_force_ruby_platform
+            for more details.
+          MESSAGE
+        end
+
+        exe_file
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: tailwindcss-ruby
+version: !ruby/object:Gem::Version
+  version: 4.0.0.beta.9
+platform: x86_64-linux-gnu
+authors:
+- Mike Dalessio
+- David Heinemeier Hansson
+bindir: exe
+cert_chain: []
+date: 2025-01-10 00:00:00.000000000 Z
+dependencies: []
+description: A self-contained `tailwindcss` executable, wrapped up in a ruby gem.
+  That's it. Nothing else.
+email:
+- mike.dalessio@gmail.com
+- david@loudthinking.com
+executables:
+- tailwindcss
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE-DEPENDENCIES
+- LICENSE.txt
+- README.md
+- exe/tailwindcss
+- exe/x86_64-linux-gnu/tailwindcss
+- lib/tailwindcss/ruby.rb
+- lib/tailwindcss/ruby/upstream.rb
+- lib/tailwindcss/ruby/version.rb
+homepage: https://github.com/flavorjones/tailwindcss-ruby
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/flavorjones/tailwindcss-ruby
+  changelog_uri: https://github.com/flavorjones/tailwindcss-ruby/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: A self-contained `tailwindcss` executable.
+test_files: []