rubydex 0.1.0.beta1-x86_64-linux

data/exe/rdx

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+require "optparse"
+
+OptionParser.new do |parser|
+  parser.banner = "Usage: [path1, path2]"
+
+  parser.on("--version", "Print the gem's version") do
+    require "rubydex/version"
+    puts "v#{Rubydex::VERSION}"
+    exit
+  end
+
+  parser.on("-h", "--help", "Prints this help") do
+    puts parser
+    exit
+  end
+end.parse!
+
+require "rubydex"
+
+workspace_path = ARGV.first
+
+# If a workspace path is passed, we need to ensure that Bundler is setup in that context so that we find the
+# dependencies for that project
+if workspace_path
+  gemfile_path = File.join(workspace_path, "Gemfile")
+
+  if File.exist?(gemfile_path)
+    ENV["BUNDLE_GEMFILE"] = gemfile_path
+
+    begin
+      Bundler.setup
+    rescue Bundler::BundlerError => e
+      $stderr.puts(<<~MESSAGE)
+        Bundle setup failed for #{gemfile_path}. Indexing of dependencies may be partial
+        Error:
+          #{e.message}
+      MESSAGE
+    end
+  end
+end
+
+graph = Rubydex::Graph.new(workspace_path: workspace_path)
+graph.index_workspace

data/ext/rubydex/extconf.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "mkmf"
+require "pathname"
+
+release = ENV["RELEASE"]
+gem_dir = Pathname.new("../..").expand_path(__dir__)
+root_dir = gem_dir.join("rust")
+target_dir = root_dir.join("target")
+target_dir = target_dir.join("x86_64-pc-windows-gnu") if Gem.win_platform?
+target_dir = target_dir.join(release ? "release" : "debug")
+
+bindings_path = root_dir.join("rubydex-sys").join("rustbindings.h")
+
+cargo_args = ["--manifest-path #{root_dir.join("Cargo.toml")}"]
+cargo_args << "--release" if release
+
+if Gem.win_platform?
+  cargo_args << "--target x86_64-pc-windows-gnu"
+  ENV["RUSTFLAGS"] = "-C target-feature=+crt-static"
+end
+
+append_cflags("-Werror=unused-but-set-variable")
+append_cflags("-Werror=implicit-function-declaration")
+
+if Gem.win_platform?
+  $LDFLAGS << " #{target_dir.join("librubydex_sys.a")}"
+
+  # On Windows, statically link system libraries to avoid having to distribute and load DLLs
+  #
+  # These libraries are the ones informed by `cargo rustc -- --print native-static-libs`, which displays the
+  # libraries necessary for statically linking the Rust code on the current platform
+  ["kernel32", "ntdll", "userenv", "ws2_32", "dbghelp", "msvcrt"].each do |lib|
+    $LDFLAGS << " -l#{lib}"
+  end
+else
+  append_ldflags("-Wl,-rpath,#{target_dir}")
+  # We cannot use append_ldflags here because the Rust code is only compiled later. If it's not compiled yet, this will
+  # fail and the flag will not be added
+  $LDFLAGS << " -L#{target_dir} -lrubydex_sys"
+end
+
+create_makefile("rubydex/rubydex")
+
+cargo_command = if ENV["SANITIZER"]
+  ENV["RUSTFLAGS"] = "-Zsanitizer=#{ENV["SANITIZER"]}"
+  "cargo +nightly build -Zbuild-std #{cargo_args.join(" ")}".strip
+else
+  "cargo build #{cargo_args.join(" ")}".strip
+end
+
+rust_srcs = Dir.glob("#{root_dir}/**/*.rs")
+
+makefile = File.read("Makefile")
+new_makefile = makefile.gsub("$(OBJS): $(HDRS) $(ruby_headers)", <<~MAKEFILE.chomp)
+  .PHONY: compile_rust
+  RUST_SRCS = #{File.expand_path("Cargo.toml", root_dir)} #{File.expand_path("Cargo.lock", root_dir)} #{rust_srcs.join(" ")}
+
+  .rust_built: $(RUST_SRCS)
+  \t#{cargo_command} || (echo "Compiling Rust failed" && exit 1)
+  \t$(COPY) #{bindings_path} #{__dir__}
+  \ttouch $@
+
+  compile_rust: .rust_built
+
+  $(OBJS): $(HDRS) $(ruby_headers) .rust_built
+MAKEFILE
+
+new_makefile.gsub!("$(Q) $(POSTLINK)", <<~MAKEFILE.chomp)
+  $(Q) $(POSTLINK)
+  \t$(Q)$(RM) .rust_built
+MAKEFILE
+
+# Bundle all dependency licenses when building a release version of the gem
+if release
+  unless system("cargo about --version > /dev/null 2>&1")
+    abort <<~MESSAGE
+      ERROR: cargo-about is not installed and required to build the release version of the gem.
+      Please install it by running:
+        cargo install cargo-about
+    MESSAGE
+  end
+
+  licenses_file = root_dir.join("THIRD_PARTY_LICENSES.html")
+  about_config = root_dir.join("about.toml")
+  about_template = root_dir.join("about.hbs")
+
+  new_makefile.gsub!(".rust_built: $(RUST_SRCS)", <<~MAKEFILE.chomp)
+    #{licenses_file}: #{about_config} #{about_template}
+    \t$(Q)$(RM) #{licenses_file}
+    \tcargo about generate #{about_template} --manifest-path #{root_dir.join("Cargo.toml")} --workspace > #{licenses_file}
+    \t$(COPY) #{licenses_file} #{gem_dir}
+
+    .rust_built: $(RUST_SRCS) #{licenses_file}
+  MAKEFILE
+end
+
+File.write("Makefile", new_makefile)
+
+begin
+  require "extconf_compile_commands_json"
+
+  ExtconfCompileCommandsJson.generate!
+  ExtconfCompileCommandsJson.symlink!
+rescue LoadError # rubocop:disable Lint/SuppressedException
+end

data/lib/rubydex/comment.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Rubydex
+  class Comment
+    #: String
+    attr_reader :string
+
+    #: Location
+    attr_reader :location
+
+    #: (?string: String, ?location: Location) -> void
+    def initialize(string:, location:)
+      @string = string
+      @location = location
+    end
+  end
+end

data/lib/rubydex/diagnostic.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Rubydex
+  class Diagnostic
+    #: Symbol
+    attr_reader :rule
+
+    #: String
+    attr_reader :message
+
+    #: Location
+    attr_reader :location
+
+    #: (rule: Symbol, message: String, location: Location) -> void
+    def initialize(rule:, message:, location:)
+      @rule = rule
+      @message = message
+      @location = location
+    end
+  end
+end

data/lib/rubydex/graph.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Rubydex
+  # The global graph representing all declarations and their relationships for the workspace
+  #
+  # Note: this class is partially defined in C to integrate with the Rust backend
+  class Graph
+    #: (?workspace_path: String) -> void
+    def initialize(workspace_path: Dir.pwd)
+      @workspace_path = workspace_path
+    end
+
+    # Index all files and dependencies of the workspace that exists in `@workspace_path`
+    #: -> String?
+    def index_workspace
+      paths = Dir.glob("#{@workspace_path}/**/*.rb")
+      paths.concat(
+        workspace_dependency_paths.flat_map do |path|
+          Dir.glob("#{path}/**/*.rb")
+        end,
+      )
+      index_all(paths)
+    end
+
+    private
+
+    # Gathers the paths we have to index for all workspace dependencies
+    def workspace_dependency_paths
+      specs = Bundler.locked_gems&.specs
+      return [] unless specs
+
+      paths = specs.filter_map do |lazy_spec|
+        spec = Gem::Specification.find_by_name(lazy_spec.name)
+        spec.require_paths.map { |path| File.join(spec.full_gem_path, path) }
+      rescue Gem::MissingSpecError
+        nil
+      end
+
+      paths.flatten!
+      paths.uniq!
+      paths
+    end
+  end
+end

data/lib/rubydex/location.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Rubydex
+  class Location
+    include Comparable
+
+    #: String
+    attr_reader :uri
+
+    #: Integer
+    attr_reader :start_line, :end_line, :start_column, :end_column
+
+    #: (?uri: String, ?start_line: Integer, ?end_line: Integer, ?start_column: Integer, ?end_column: Integer) -> void
+    def initialize(uri:, start_line:, end_line:, start_column:, end_column:)
+      @uri = uri
+      @start_line = start_line
+      @end_line = end_line
+      @start_column = start_column
+      @end_column = end_column
+    end
+
+    #: () -> String
+    def path
+      uri = URI(@uri)
+      raise Rubydex::Error, "URI is not a file:// URI: #{@uri}" unless uri.scheme == "file"
+
+      path = uri.path
+      # TODO: This has to go away once we have a proper URI abstraction
+      path.delete_prefix!("/") if Gem.win_platform?
+      path
+    end
+
+    #: (other: BasicObject) -> Integer
+    def <=>(other)
+      return -1 unless other.is_a?(Location)
+
+      a = [@uri, @start_line, @start_column, @end_line, @end_column]
+      b = [other.uri, other.start_line, other.start_column, other.end_line, other.end_column]
+      a <=> b
+    end
+
+    #: -> String
+    def to_s
+      "#{path}:#{@start_line}:#{@start_column}-#{@end_line}:#{@end_column}"
+    end
+  end
+end

data/lib/rubydex/version.rb

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

data/lib/rubydex.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "bundler"
+require "uri"
+
+module Rubydex
+  class Error < StandardError; end
+end
+
+require "rubydex/version"
+
+begin
+  # Load the precompiled version of the library
+  ruby_version = /(\d+\.\d+)/.match(RUBY_VERSION)
+  require "rubydex/#{ruby_version}/rubydex"
+rescue LoadError
+  # It's important to leave for users that can not or don't want to use the gem with precompiled binaries.
+  require "rubydex/rubydex"
+end
+
+require "rubydex/location"
+require "rubydex/comment"
+require "rubydex/diagnostic"
+require "rubydex/graph"

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: rubydex
+version: !ruby/object:Gem::Version
+  version: 0.1.0.beta1
+platform: x86_64-linux
+authors:
+- Shopify
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2026-01-21 00:00:00.000000000 Z
+dependencies: []
+description: A high performance static analysis suite for Ruby, built in Rust with
+  Ruby APIs
+email:
+- ruby@shopify.com
+executables:
+- rdx
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- THIRD_PARTY_LICENSES.html
+- exe/rdx
+- ext/rubydex/extconf.rb
+- lib/rubydex.rb
+- lib/rubydex/3.2/rubydex.so
+- lib/rubydex/3.3/rubydex.so
+- lib/rubydex/3.4/rubydex.so
+- lib/rubydex/4.0/rubydex.so
+- lib/rubydex/comment.rb
+- lib/rubydex/diagnostic.rb
+- lib/rubydex/graph.rb
+- lib/rubydex/location.rb
+- lib/rubydex/version.rb
+homepage: https://github.com/Shopify/rubydex
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/Shopify/rubydex
+  source_code_uri: https://github.com/Shopify/rubydex
+  changelog_uri: https://github.com/Shopify/rubydex/releases
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 4.1.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.11
+requirements: []
+rubygems_version: 3.4.19
+signing_key: 
+specification_version: 4
+summary: A high performance static analysis suite for Ruby
+test_files: []