kar 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9cb55eed4dafe4bbab2c0538ae1a8db4bfa7c7eec218bbcfd032e6338f6dd73f
-  data.tar.gz: a8fc42a08018db8aa2ed5a2d7a12f4450d130df764d4cd1462548929e2c8fb37
+  metadata.gz: 997bfcbcd92bf9aea3625eaa6f66622c9077e93e754c83328ee48a24d0d42a59
+  data.tar.gz: 1a32d287aa169199d98d8af143c3a12be8c84b3be894faf7c5a32479bf1887c8
 SHA512:
-  metadata.gz: '0913f70bb384324388c9b431e3da5de8859c5ca800b3a516ee28f8e976b00dbda7c9a73c19d09a05e07ecc2c751168f8d8a611cb69ba87fcc62e7aae4377233b'
-  data.tar.gz: 34ec977869d4ae40f8ca4109a92682ad92ed2265ec22abef08ca896cde6a6c323adbde54ba69b268cbb377a4d8ed554edd4272d58120d3eaf5e6f737c4b52a75
+  metadata.gz: d71c84b1473e99ceb209f8c9510f66823446be3ae68aca1e31e389f6ff5c23c6bdcad4cf3886e28b8144dbf7c04c76ef4dede8ed2721d6d75e9d5ae11e28c0c9
+  data.tar.gz: 240afac657222785391bb06b87254137e9fdacc71c323e155a12787d51abe163221c4c0560d1bb6bc89d68f1fbdd8fcb985a01f2ff1be289afdedbb4241a253a

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.1.2] - 2025-10-26
+
+- CargoTask, build extension in Rust
+
+## [0.1.1] - 2025-10-24
+
+- URITask, handle redirection
+
 ## [0.1.0] - 2024-01-09
 
 - Initial release

data/README.md

@@ -23,6 +23,7 @@ Usage
     download "local/path/to/file" => "https://example.net/remote/path/to/file"
     FILES = FileList["fileA", "fileB", "fileC"]
     files FILES
+    cargo "my_gem"
 
 Development
 -----------

data/kar.gemspec

@@ -1,10 +1,6 @@
-# frozen_string_literal: true
-
-require_relative "lib/kar/version"
-
 Gem::Specification.new do |spec|
   spec.name = "kar"
-  spec.version = Kar::VERSION
+  spec.version = "0.1.2"
   spec.authors = ["Kitaiti Makoto"]
   spec.email = ["KitaitiMakoto@gmail.com"]
 

data/lib/kar/cargotask.rb

@@ -0,0 +1,113 @@
+require "rake/clean"
+require "rubygems/ext"
+require "json"
+require "shellwords"
+require "stringio"
+
+module Kar
+  class CargoTask
+    include Rake::DSL
+
+    def initialize(target)
+      @target = target
+
+      define
+    end
+
+    private
+
+    def verbose?
+      Rake.verbose == true
+    end
+
+    def define
+      file dl_path => [manifest, lock_file] + src do |t|
+        results = Results.new
+        begin
+          Gem::Ext::CargoBuilder.new.build t.source, ".", results, [], lib_dir, File.expand_path(ext_dir)
+        rescue => error
+          $stderr.puts results unless verbose?
+          fail
+        end
+      end
+      CLEAN.include dl_name, dl_path
+
+      namespace :cargo do
+        task @target => dl_path
+
+        # TODO: Consider the case `target` is "validate"
+        namespace :validate do
+          task @target => manifest do |t|
+            `cargo metadata --format-version=1 --manifest-path=#{manifest.shellescape} --locked --quiet`
+            fail unless $?.success?
+          end
+        end
+
+        desc "Validate Cargo.lock files"
+        task validate: "cargo:validate:#{@target}"
+      end
+
+      desc "Build all extensions in Rust"
+      task cargo: "cargo:#{@target}"
+    end
+
+    def gemspec
+      @gemspec ||= Gem::Specification.load("#{@target}.gemspec")
+    end
+
+    def manifest
+      @manifest ||= gemspec.extensions.first
+    end
+
+    def lock_file
+      @lock_file ||= manifest.ext(".lock")
+    end
+
+    def ext_dir
+      @ext_dir ||= File.dirname(manifest)
+    end
+
+    def lib_dir
+      # When a gem include an extension, the first element of require_paths is the directory for extensions and the second is for Ruby files.
+      @lib_dir ||= gemspec.require_paths[1]
+    end
+
+    def dl_name
+      @dl_name ||= "#{gemspec.name}.#{RbConfig::CONFIG["DLEXT"]}"
+    end
+
+    def dl_path
+      @dl_path ||= File.join(lib_dir, dl_name)
+    end
+
+    def src
+      @src ||= FileList["#{ext_dir}/src/*/*.rs"]
+    end
+
+    class Results
+      def initialize
+        @io = verbose? ? $stdout : StringIO.new
+      end
+
+      def <<(output)
+        # Always break a line even when output isn't terminated by a line break
+        @io.puts output
+      end
+
+      def to_s
+        if verbose?
+          ""
+        else
+          @io.rewind
+          @io.read
+        end
+      end
+
+      private
+
+      def verbose?
+        Rake.verbose == true
+      end
+    end
+  end
+end

data/lib/kar/dsl.rb

@@ -1,4 +1,5 @@
 require "kar/uritask"
+require "kar/cargotask"
 
 module Kar
   # DSLs you can use in your Rakefiles
@@ -18,6 +19,9 @@ module Kar
   #
   #   # Downloads file from https://example.com/remote/file and save to local/file
   #   download "local/file" => "https://example.org/remote/file"
+  #
+  #   # Build extension in Rust
+  #   cargo "my_gem"
   module DSL
     def files(file_list)
       file_list.each do |file_name|
@@ -46,6 +50,27 @@ module Kar
       URITask.new args
     end
 
+    # Declare a cargo task which builds extension in Rust by Cargo.
+    #
+    # @example
+    #   # Rakefile
+    #   cargo "my_gem"
+    #
+    #   task build: :cargo
+    #
+    #   # shell
+    #   % rake cargo
+    #
+    # Also defines a cargo:validate task which validates version `Cargo.lock`s are up-to-date.
+    # It's useful to add them to the dependency of build task and prevent building invalid gem package.
+    #
+    # Uses {https://docs.ruby-lang.org/en/master/Gem/Ext/CargoBuilder.html Gem::Ext::CargoBuilder} internally unlike {https://oxidize-rb.org/docs/api-reference/rb-sys-gem-config#rbsysextensiontask RbSys::ExtensionTask}
+    # in order to build in the same way as `gem install` command, even though the output might be less usefull.
+    # When `RbSys::Extension` uses the same way, this function may be deprecated.
+    def cargo(target)
+      CargoTask.new target
+    end
+
     Rake::DSL.prepend self
   end
 end

data/lib/kar/uritask.rb

@@ -9,6 +9,8 @@ module Kar
   # Instanctiated in {DSL#download}
   class URITask < Rake::TaskLib
     module Util
+      REDIRECT_LIMIT = 3
+
       module_function
 
       # @todo Consider return value type
@@ -18,27 +20,54 @@ module Kar
       # @param headers [Hash<String, Object?>] HTTP headers
       # @return [String] File path content saved, same to +to+
       # @return [nil] if remote file responded with 304 Not Modified
-      def fetch_http(uri, to, headers = {})
-        http = Net::HTTP.new(uri.host, uri.port)
-        http.use_ssl = uri.scheme == "https"
-        http.start do |http|
-          File.open to, "wb" do |file|
-            http.request_get uri, headers do |response|
-              return if response.kind_of? Net::HTTPNotModified
-
-              response.read_body do |chunk|
-                file.write chunk
-              end
-              begin
-                File.utime Time.now, Time.httpdate(response["Last-Modified"]), to
-              rescue => err
-                warn err
+      def fetch_http(uri, to, headers = {}, redirected = 0)
+        if redirected > REDIRECT_LIMIT
+          raise "Too many HTTP redirects"
+        end
+        Net::HTTP.start uri.host, uri.port, use_ssl: uri.scheme == "https" do |http|
+          request = Net::HTTP::Get.new(uri, headers)
+          http.request request do |response|
+            case response
+            when Net::HTTPNotModified
+              # noop
+            when Net::HTTPOK
+              File.open to, "wb" do |file|
+                response.read_body do |chunk|
+                  file.write chunk
+                end
+                now = Time.now
+                last_modified = response["last-modified"]
+                mtime = last_modified ? Time.httpdate(last_modified) : now
+                File.utime now, Time.httpdate(response["Last-Modified"]), to
               end
+            when Net::HTTPRedirection
+              fetch_http URI(response["location"]), to, headers, redirected + 1
+            else
+              raise "#{response.code} #{response.message}\n#{response.body}"
             end
           end
         end
+
         to
       end
+
+      private
+
+      def fetch_http_with_redirection_handling(uri, headers = {})
+        Net::HTTP.start uri.host, uri.port, use_ssl: uri.scheme == "https" do |http|
+          request = Net::HTTP::Get.new(uri, headers)
+          http.request request do |response|
+            case response
+            when Net::HTTPRedirection
+              return fetch_http_with_redirection_handling(URI(response["location"]), headers)
+            when Net::HTTPOK
+              return response
+            else
+              raise "#{response.code} #{response.message}\n#{response.body}"
+            end
+          end
+        end
+      end
     end
 
     include Util

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: kar
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Kitaiti Makoto
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -81,9 +80,9 @@ files:
 - agpl-3.0.txt
 - kar.gemspec
 - lib/kar.rb
+- lib/kar/cargotask.rb
 - lib/kar/dsl.rb
 - lib/kar/uritask.rb
-- lib/kar/version.rb
 - sig/kar.rbs
 homepage: https://gitlab.com/KitaitiMakoto/kar
 licenses:
@@ -92,7 +91,6 @@ metadata:
   homepage_uri: https://gitlab.com/KitaitiMakoto/kar
   source_code_uri: https://gitlab.com/KitaitiMakoto/kar
   changelog_uri: https://gitlab.com/KitaitiMakoto/kar/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -107,8 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Rake utilities
 test_files: []

data/lib/kar/version.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-module Kar
-  VERSION = "0.1.0"
-end