kar 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd14a44367840ddf1ed8e199a4682bd4cfad4f734d06d3220d7aee30e92ea64c
-  data.tar.gz: fdd7c35b0aded9a6c25de853e6274cf4cd4a524c4f6113ceee710182d6188ee7
+  metadata.gz: 997bfcbcd92bf9aea3625eaa6f66622c9077e93e754c83328ee48a24d0d42a59
+  data.tar.gz: 1a32d287aa169199d98d8af143c3a12be8c84b3be894faf7c5a32479bf1887c8
 SHA512:
-  metadata.gz: 21cbecd6b7218e5d17d081db576e90015688d5957d796b65899138ee6e12a42a1d7a44447e70d16b65992fe2b7b0129eebe6a6a34c8d455a5c596aa1c15bea78
-  data.tar.gz: 40c5df4efcce865bb3f03fb9483a0b33313acbf6f6462bb33b89b2481dfae8497d7c664251f51b8b0d43ce84e4cc4e0ee3df28d00ecd85c79e9a20f25a43a9de
+  metadata.gz: d71c84b1473e99ceb209f8c9510f66823446be3ae68aca1e31e389f6ff5c23c6bdcad4cf3886e28b8144dbf7c04c76ef4dede8ed2721d6d75e9d5ae11e28c0c9
+  data.tar.gz: 240afac657222785391bb06b87254137e9fdacc71c323e155a12787d51abe163221c4c0560d1bb6bc89d68f1fbdd8fcb985a01f2ff1be289afdedbb4241a253a

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.1.2] - 2025-10-26
+
+- CargoTask, build extension in Rust
+
 ## [0.1.1] - 2025-10-24
 
 - URITask, handle redirection

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kar
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Kitaiti Makoto
@@ -80,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:

data/lib/kar/version.rb

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