rubydex 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c776445f3a3589b62c6f4e1987d424f91aa020585434182c4d16087097e28fb1
-  data.tar.gz: 4d5e1862670c7dd767bce180f70dda589237bf9696b82c99d971b58f2b6ec9bb
+  metadata.gz: 9fe9d5528801028a40419f3e7b35f5b74406ae2c24f6ce6252270fe15c2b9b77
+  data.tar.gz: 92595d6014a20544bdace0135d4aeea060ee969ab3a10544d02de6796ff9f84e
 SHA512:
-  metadata.gz: 82cc3034740d1e985a938492228a72b77fb4ea3687e07d87ec0cabfb3c342f26db21cc93f1559879037a45ab1d9eed0bb0869c64f55d6ec16ecd50226a5177a8
-  data.tar.gz: e8f7f5ef9e65ab9bbb82fa4cb1f69db91d8df4204ce008beef5f529b18b929a5b4c383ce4083d90fb05a9e054c35e6d04ca58d4b911f2db2e29a7c9c5a6e4698
+  metadata.gz: d43a2e6d81744f688d12ab483b8b4539a7a56144f0d7c7cf20540506bb376903c5d309c255b743ba77277fc82e03f86b70e0416149fdd490743844e913c24be6
+  data.tar.gz: 18f6195b18761efdafbe0b9ae7fb9c1ab64bbb607a080fb58792b9f574d17cb6ed25560ff957c5b925186019abbbe509396c2f88dd903c2e625d0265fbb10efa

data/THIRD_PARTY_LICENSES.html

@@ -50,8 +50,8 @@
 
         <h2>Overview of licenses:</h2>
         <ul class="licenses-overview">
-            <li><a href="#Apache-2.0">Apache License 2.0</a> (147)</li>
-            <li><a href="#MIT">MIT License</a> (29)</li>
+            <li><a href="#Apache-2.0">Apache License 2.0</a> (157)</li>
+            <li><a href="#MIT">MIT License</a> (30)</li>
             <li><a href="#Unicode-3.0">Unicode License v3</a> (19)</li>
             <li><a href="#BSD-2-Clause">BSD 2-Clause &quot;Simplified&quot; License</a> (2)</li>
             <li><a href="#BSD-3-Clause">BSD 3-Clause &quot;New&quot; or &quot;Revised&quot; License</a> (1)</li>
@@ -1049,18 +1049,36 @@
                     <li><a
                             href=" https://github.com/toml-rs/toml ">serde_spanned
                             0.6.9</a></li>
+                    <li><a
+                            href=" https://github.com/toml-rs/toml ">serde_spanned
+                            1.1.1</a></li>
+                    <li><a
+                            href=" https://github.com/tikv/jemallocator ">tikv-jemalloc-ctl
+                            0.7.0</a></li>
                     <li><a
                             href=" https://github.com/toml-rs/toml ">toml
                             0.8.23</a></li>
+                    <li><a
+                            href=" https://github.com/toml-rs/toml ">toml
+                            1.1.2+spec-1.1.0</a></li>
                     <li><a
                             href=" https://github.com/toml-rs/toml ">toml_datetime
                             0.6.11</a></li>
+                    <li><a
+                            href=" https://github.com/toml-rs/toml ">toml_datetime
+                            1.1.1+spec-1.1.0</a></li>
                     <li><a
                             href=" https://github.com/toml-rs/toml ">toml_edit
                             0.22.27</a></li>
+                    <li><a
+                            href=" https://github.com/toml-rs/toml ">toml_parser
+                            1.1.2+spec-1.1.0</a></li>
                     <li><a
                             href=" https://github.com/toml-rs/toml ">toml_write
                             0.1.2</a></li>
+                    <li><a
+                            href=" https://github.com/toml-rs/toml ">toml_writer
+                            1.1.1+spec-1.1.0</a></li>
                 </ul>
                 <pre class="license-text">                                 Apache License
                            Version 2.0, January 2004
@@ -1993,7 +2011,7 @@ limitations under the License.
                             0.3.2</a></li>
                     <li><a
                             href=" https://github.com/rust-lang/hashbrown ">hashbrown
-                            0.15.4</a></li>
+                            0.17.1</a></li>
                     <li><a
                             href=" https://github.com/withoutboats/heck ">heck
                             0.5.0</a></li>
@@ -2005,7 +2023,7 @@ limitations under the License.
                             1.2.1</a></li>
                     <li><a
                             href=" https://github.com/indexmap-rs/indexmap ">indexmap
-                            2.10.0</a></li>
+                            2.14.0</a></li>
                     <li><a
                             href=" https://github.com/rust-itertools/itertools ">itertools
                             0.13.0</a></li>
@@ -2048,6 +2066,12 @@ limitations under the License.
                     <li><a
                             href=" https://github.com/Stebalien/tempfile ">tempfile
                             3.20.0</a></li>
+                    <li><a
+                            href=" https://github.com/tikv/jemallocator ">tikv-jemalloc-sys
+                            0.7.1+5.3.1-0-g81034ce1f1373e37dc865038e1bc8eeecf559ce8</a></li>
+                    <li><a
+                            href=" https://github.com/tikv/jemallocator ">tikv-jemallocator
+                            0.7.0</a></li>
                     <li><a
                             href=" https://github.com/servo/rust-url ">url
                             2.5.4</a></li>
@@ -2931,6 +2955,9 @@ limitations under the License.
                     <li><a
                             href=" https://github.com/rust-lang/rust-analyzer/tree/master/lib/line-index ">line-index
                             0.1.2</a></li>
+                    <li><a
+                            href=" https://github.com/dtolnay/paste ">paste
+                            1.0.15</a></li>
                     <li><a
                             href=" https://github.com/as1100k/pastey ">pastey
                             0.2.1</a></li>
@@ -2972,10 +2999,13 @@ limitations under the License.
                             1.0.20</a></li>
                     <li><a
                             href=" https://github.com/serde-rs/serde ">serde
-                            1.0.219</a></li>
+                            1.0.228</a></li>
+                    <li><a
+                            href=" https://github.com/serde-rs/serde ">serde_core
+                            1.0.228</a></li>
                     <li><a
                             href=" https://github.com/serde-rs/serde ">serde_derive
-                            1.0.219</a></li>
+                            1.0.228</a></li>
                     <li><a
                             href=" https://github.com/serde-rs/serde ">serde_derive_internals
                             0.29.1</a></li>
@@ -3929,6 +3959,9 @@ DEALINGS IN THE SOFTWARE.
                     <li><a
                             href=" https://github.com/winnow-rs/winnow ">winnow
                             0.7.12</a></li>
+                    <li><a
+                            href=" https://github.com/winnow-rs/winnow ">winnow
+                            1.0.3</a></li>
                 </ul>
                 <pre class="license-text">Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/exe/rdx

@@ -35,6 +35,8 @@ def __with_timer(message, &block)
 end
 
 graph = Rubydex::Graph.new
+graph.load_config
+
 __with_timer("Indexing workspace...") { graph.index_workspace }
 __with_timer("Resolving graph...") { graph.resolve }
 

data/ext/rubydex/declaration.c

@@ -5,6 +5,11 @@
 #include "rustbindings.h"
 #include "utils.h"
 
+/*
+ * RDoc parser workaround for https://github.com/ruby/rdoc/issues/1744:
+ * mRubydex = rb_define_module("Rubydex")
+ */
+
 VALUE cDeclaration;
 VALUE cNamespace;
 VALUE cClass;
@@ -46,42 +51,32 @@ VALUE rdxi_declaration_class_for_kind(CDeclarationKind kind) {
     }
 }
 
-// Declaration#name -> String
+/*
+ * call-seq:
+ *   name -> String?
+ *
+ * Returns the fully qualified declaration name.
+ */
 static VALUE rdxr_declaration_name(VALUE self) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
     const char *name = rdx_declaration_name(graph, data->id);
 
-    if (name == NULL) {
-        return Qnil;
-    }
-
-    VALUE str = rb_utf8_str_new_cstr(name);
-    free_c_string(name);
-
-    return str;
+    return rdxi_owned_c_string_to_ruby(name);
 }
 
-// Declaration#unqualified_name -> String
+/*
+ * call-seq:
+ *   unqualified_name -> String?
+ *
+ * Returns the declaration name without namespace qualification.
+ */
 static VALUE rdxr_declaration_unqualified_name(VALUE self) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
     const char *name = rdx_declaration_unqualified_name(graph, data->id);
 
-    if (name == NULL) {
-        return Qnil;
-    }
-
-    VALUE str = rb_utf8_str_new_cstr(name);
-    free_c_string(name);
-
-    return str;
+    return rdxi_owned_c_string_to_ruby(name);
 }
 
 // Body function for rb_ensure in Declaration#definitions
@@ -115,10 +110,7 @@ static VALUE declaration_definitions_ensure(VALUE args) {
 // Size function for the Declaration#definitions enumerator
 static VALUE declaration_definitions_size(VALUE self, VALUE _args, VALUE _eobj) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
     struct DefinitionsIter *iter = rdx_declaration_definitions_iter_new(graph, data->id);
     size_t len = rdx_definitions_iter_len(iter);
     rdx_definitions_iter_free(iter);
@@ -126,18 +118,19 @@ static VALUE declaration_definitions_size(VALUE self, VALUE _args, VALUE _eobj)
     return SIZET2NUM(len);
 }
 
-// Declaration#definitions: () -> Enumerator[Definition]
-// Returns an enumerator that yields all definitions for this declaration lazily
+/*
+ * call-seq:
+ *   definitions -> Enumerator[Rubydex::Definition]
+ *
+ * Returns an enumerator that yields all definitions for this declaration lazily.
+ */
 static VALUE rdxr_declaration_definitions(VALUE self) {
     if (!rb_block_given_p()) {
         return rb_enumeratorize_with_size(self, rb_str_new2("definitions"), 0, NULL, declaration_definitions_size);
     }
 
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     void *iter = rdx_declaration_definitions_iter_new(graph, data->id);
     VALUE args = rb_ary_new_from_args(2, self, ULL2NUM((uintptr_t)iter));
@@ -146,14 +139,15 @@ static VALUE rdxr_declaration_definitions(VALUE self) {
     return self;
 }
 
-// Declaration#member: (String member) -> Declaration
-// Returns a declaration handle for the given member
+/*
+ * call-seq:
+ *   member(name) -> Rubydex::Declaration?
+ *
+ * Returns a declaration handle for the named member, or nil if no member exists.
+ */
 static VALUE rdxr_declaration_member(VALUE self, VALUE name) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     if (TYPE(name) != T_STRING) {
         rb_raise(rb_eTypeError, "expected String");
@@ -171,8 +165,12 @@ static VALUE rdxr_declaration_member(VALUE self, VALUE name) {
     return rb_class_new_instance(2, argv, decl_class);
 }
 
-// Namespace#find_member: (String member, only_inherited: false) -> Declaration?
-// Searches for a member in the ancestor chain of the declaration
+/*
+ * call-seq:
+ *   find_member(name, only_inherited: false) -> Rubydex::Declaration?
+ *
+ * Searches for a member in the declaration's ancestor chain.
+ */
 static VALUE rdxr_declaration_find_member(int argc, VALUE *argv, VALUE self) {
     VALUE member, opts;
     rb_scan_args(argc, argv, "1:", &member, &opts);
@@ -190,10 +188,7 @@ static VALUE rdxr_declaration_find_member(int argc, VALUE *argv, VALUE self) {
     }
 
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     const CDeclaration *decl = rdx_declaration_find_member(graph, data->id, StringValueCStr(member), only_inherited);
     if (decl == NULL) {
@@ -207,13 +202,15 @@ static VALUE rdxr_declaration_find_member(int argc, VALUE *argv, VALUE self) {
     return rb_class_new_instance(2, result_argv, decl_class);
 }
 
-// Declaration#singleton_class -> SingletonClass
+/*
+ * call-seq:
+ *   singleton_class -> Rubydex::SingletonClass?
+ *
+ * Returns the singleton class declaration, or nil if none exists.
+ */
 static VALUE rdxr_declaration_singleton_class(VALUE self) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
     const CDeclaration *decl = rdx_declaration_singleton_class(graph, data->id);
 
     if (decl == NULL) {
@@ -227,13 +224,15 @@ static VALUE rdxr_declaration_singleton_class(VALUE self) {
     return rb_class_new_instance(2, argv, decl_class);
 }
 
-// Declaration#owner -> Declaration
+/*
+ * call-seq:
+ *   owner -> Rubydex::Declaration
+ *
+ * Returns the owner declaration.
+ */
 static VALUE rdxr_declaration_owner(VALUE self) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
     const CDeclaration *decl = rdx_declaration_owner(graph, data->id);
 
     if (decl == NULL) {
@@ -247,17 +246,19 @@ static VALUE rdxr_declaration_owner(VALUE self) {
     return rb_class_new_instance(2, argv, decl_class);
 }
 
-// Declaration#ancestors: () -> Enumerator[Declaration]
+/*
+ * call-seq:
+ *   ancestors -> Enumerator[Rubydex::Namespace]
+ *
+ * Returns an enumerator that yields ancestor namespaces.
+ */
 static VALUE rdxr_declaration_ancestors(VALUE self) {
     if (!rb_block_given_p()) {
         return rb_enumeratorize(self, rb_str_new2("ancestors"), 0, NULL);
     }
 
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     void *iter = rdx_declaration_ancestors(graph, data->id);
     if (iter == NULL) {
@@ -270,17 +271,19 @@ static VALUE rdxr_declaration_ancestors(VALUE self) {
     return self;
 }
 
-// Declaration#descendants: () -> Enumerator[Declaration]
+/*
+ * call-seq:
+ *   descendants -> Enumerator[Rubydex::Namespace]
+ *
+ * Returns an enumerator that yields descendant namespaces.
+ */
 static VALUE rdxr_declaration_descendants(VALUE self) {
     if (!rb_block_given_p()) {
         return rb_enumeratorize(self, rb_str_new2("descendants"), 0, NULL);
     }
 
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     void *iter = rdx_declaration_descendants(graph, data->id);
     if (iter == NULL) {
@@ -293,17 +296,19 @@ static VALUE rdxr_declaration_descendants(VALUE self) {
     return self;
 }
 
-// Namespace#members: () -> Enumerator[Declaration]
+/*
+ * call-seq:
+ *   members -> Enumerator[Rubydex::Declaration]
+ *
+ * Returns an enumerator that yields member declarations.
+ */
 static VALUE rdxr_declaration_members(VALUE self) {
     if (!rb_block_given_p()) {
         return rb_enumeratorize(self, rb_str_new2("members"), 0, NULL);
     }
 
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     void *iter = rdx_declaration_members(graph, data->id);
     if (iter == NULL) {
@@ -319,10 +324,7 @@ static VALUE rdxr_declaration_members(VALUE self) {
 // Size function for constant declaration references enumerator
 static VALUE constant_declaration_references_size(VALUE self, VALUE _args, VALUE _eobj) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     struct ConstantReferencesIter *iter = rdx_declaration_constant_references_iter_new(graph, data->id);
     if (iter == NULL) {
@@ -334,8 +336,12 @@ static VALUE constant_declaration_references_size(VALUE self, VALUE _args, VALUE
     return SIZET2NUM(len);
 }
 
-// Namespace#references, Constant#references, ConstantAlias#references
-// Returns an enumerator that yields constant references to this declaration
+/*
+ * call-seq:
+ *   references -> Enumerator[Rubydex::ConstantReference]
+ *
+ * Returns an enumerator that yields constant references to this declaration.
+ */
 static VALUE rdxr_constant_declaration_references(VALUE self) {
     if (!rb_block_given_p()) {
         return rb_enumeratorize_with_size(self, rb_str_new2("references"), 0, NULL,
@@ -343,10 +349,7 @@ static VALUE rdxr_constant_declaration_references(VALUE self) {
     }
 
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     void *iter = rdx_declaration_constant_references_iter_new(graph, data->id);
     if (iter == NULL) {
@@ -362,10 +365,7 @@ static VALUE rdxr_constant_declaration_references(VALUE self) {
 // Size function for method declaration references enumerator
 static VALUE method_declaration_references_size(VALUE self, VALUE _args, VALUE _eobj) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     struct MethodReferencesIter *iter = rdx_declaration_method_references_iter_new(graph, data->id);
     if (iter == NULL) {
@@ -377,8 +377,12 @@ static VALUE method_declaration_references_size(VALUE self, VALUE _args, VALUE _
     return SIZET2NUM(len);
 }
 
-// Method#references
-// Returns an enumerator that yields method references to this declaration
+/*
+ * call-seq:
+ *   references -> Enumerator[Rubydex::MethodReference]
+ *
+ * Returns an enumerator that yields method references to this declaration.
+ */
 static VALUE rdxr_method_declaration_references(VALUE self) {
     if (!rb_block_given_p()) {
         return rb_enumeratorize_with_size(self, rb_str_new2("references"), 0, NULL,
@@ -386,10 +390,7 @@ static VALUE rdxr_method_declaration_references(VALUE self) {
     }
 
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     void *iter = rdx_declaration_method_references_iter_new(graph, data->id);
     if (iter == NULL) {
@@ -402,7 +403,12 @@ static VALUE rdxr_method_declaration_references(VALUE self) {
     return self;
 }
 
-// Placeholder for variable declarations that don't yet support references
+/*
+ * call-seq:
+ *   references -> Array[untyped]
+ *
+ * Returns an empty array because variable declarations do not yet support reference lookup.
+ */
 static VALUE rdxr_variable_declaration_references(VALUE self) {
     return rb_ary_new();
 }
@@ -420,13 +426,15 @@ static VALUE rdxi_visibility_to_symbol(CVisibility visibility) {
     }
 }
 
-// Declaration#visibility -> Symbol
+/*
+ * call-seq:
+ *   visibility -> Symbol
+ *
+ * Returns the declaration visibility.
+ */
 static VALUE rdxr_declaration_visibility(VALUE self) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     const CVisibility *visibility = rdx_graph_visibility(graph, data->id);
     if (visibility == NULL) {
@@ -439,15 +447,16 @@ static VALUE rdxr_declaration_visibility(VALUE self) {
     return symbol;
 }
 
-// ConstantAlias#target -> Declaration?
-// Returns the first resolved target declaration for this constant alias, or nil if none of its definitions resolved to
-// a target
+/*
+ * call-seq:
+ *   target -> Rubydex::Declaration?
+ *
+ * Returns the first resolved target declaration for this constant alias, or nil if none of its definitions resolved to
+ * a target.
+ */
 static VALUE rdxr_constant_alias_target(VALUE self) {
     HandleData *data;
-    TypedData_Get_Struct(self, HandleData, &handle_type, data);
-
-    void *graph;
-    TypedData_Get_Struct(data->graph_obj, void *, &graph_type, graph);
+    void *graph = rdxi_graph_from_handle(self, &data);
 
     const CDeclaration *decl = rdx_constant_alias_target(graph, data->id);
     if (decl == NULL) {