klee 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 508af2506e1d6db7fbadde901c29284c219ee4cf7471dac68a21d34110b82a2d
-  data.tar.gz: c9dcc725e9a626c9f1ff45c68e46868eaa25166ccf4e88d93bcd0009a3a7211e
+  metadata.gz: b40d9febee207cdff655e91d94f0f719188454fa98592a5cb9fa7b54521ed0c7
+  data.tar.gz: 701294ca8f65152b881f6492caa4e51979e4de81dec22735989829ae87b8a015
 SHA512:
-  metadata.gz: e411a8b0c08b4304327663139192ccaed4a05d62048b94b151564065d71b5c3f574c780b3e278c127c54368744a2cd99ad5fd8ba514fb1f1545b65a1977fb17d
-  data.tar.gz: dcc64449cbfc1d0f60243f4a2eeee661d5075a271b79c3906b476af37bcc9624b6d740424df96596103f13af663932003aa76b002bb453a82b8da413c68f8d3f
+  metadata.gz: 57dc53e9ff93189272b0a5ad5d203e9921f21376c1142db3f37d5b1074808dd92f57b4b2bc2181e43f4ca0df64a9c75e467f40efaf61b0b0bc380e4aa1830a7a
+  data.tar.gz: 07a3b7c9588044077452430f1ebb9dba9a5f23443d141fcb7bb6b6b2ec4f32182cd1cd024178f9b87850aacdabe1d778ec9dc9f18d8ddd972ccaafa40993365f

data/CHANGELOG.md

@@ -1,5 +1,31 @@
-## [Unreleased]
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## [0.1.1] - 2026-01-29
+
+### Changed
+
+- Switch to supporting ruby 3.4 and up. (84fdd9c)
+- Require ruby 3.4 and above (067ec87)
+
+### Added
+
+- Reissue for version and release support. (885fe28)
+- SimpleCov for coverage reporting (889d169)
+- Coverage comment from PRs (067ec87)
+- Klee.scan() method for codebase-wide analysis with glob patterns (3e509a1)
+- ConceptIndex for aggregating domain concepts across files (3e509a1)
+- CollaboratorIndex for pairwise co-occurrence and clustering (3e509a1)
+- FileAnalyzer using Prism AST to extract classes, methods, and collaborators (3e509a1)
+- Configurable threshold and ignore list for filtering noise (3e509a1)
+- Method-level scope option for tighter coupling analysis (3e509a1)
 
 ## [0.1.0] - 2022-05-01
 
+### Added
+
 - Initial release

data/README.md

@@ -52,6 +52,55 @@ filtered = Klee.object_concepts(Something, modifiers: %i[fill_in_ hover_over_ _m
 filtered[4] #=> Set of concepts excluding any common modifiers
 ```
 
+### Scan a codebase for domain concepts
+
+Discover hidden vocabulary across your entire codebase by analyzing class and method names.
+
+```ruby
+codebase = Klee.scan("app/**/*.rb", "lib/**/*.rb")
+
+# See all concepts ranked by frequency
+codebase.concepts.rank
+# => {
+#   "user" => { classes: Set["User", "UserSession"], methods: Set["current_user", "find_user"] },
+#   "account" => { classes: Set["Account", "AccountManager"], methods: Set["account_balance"] },
+#   ...
+# }
+
+# Drill into a specific concept
+codebase.concepts[:account]
+# => { classes: Set["Account", "AccountManager"], methods: Set["account_balance", "close_account"] }
+
+# Filter noise with ignore list and threshold
+codebase = Klee.scan("app/**/*.rb",
+                     ignore: %i[new create get set find all],
+                     threshold: 3)
+```
+
+### Find collaborator clusters
+
+Discover which objects frequently work together across your codebase.
+
+```ruby
+codebase = Klee.scan("app/**/*.rb", threshold: 3)
+
+# Pairwise co-occurrence (which objects appear together in files)
+codebase.collaborators.pairs
+# => { ["account", "user"] => 15, ["session", "user"] => 12, ... }
+
+# Method-level co-occurrence (tighter coupling)
+codebase.collaborators.pairs(scope: :method)
+# => { ["account", "user"] => 8, ... }
+
+# What collaborates with a specific object
+codebase.collaborators.for(:user)
+# => { "account" => 15, "session" => 12, "order" => 5 }
+
+# Derived clusters (connected components)
+codebase.collaborators.clusters
+# => [Set["user", "account", "session"], Set["order", "payment", "invoice"]]
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/klee/concepts.rb

@@ -26,7 +26,7 @@ module Klee
 
     def clear
       clearable = instance_variables - %i[@method_names @modifiers]
-      clearable.each { send(:remove_instance_variable, _1) }
+      clearable.each { send(:remove_instance_variable, it) }
     end
 
     def each(&block)
@@ -34,7 +34,7 @@ module Klee
     end
 
     def samples
-      @samples ||= method_names.flat_map{ words(_1) }.tally
+      @samples ||= method_names.flat_map { words(it) }.tally
     end
 
     def max
@@ -52,7 +52,7 @@ module Klee
     private
 
     def modifier_matcher
-      @modifier_matcher ||= Regexp.new modifiers.map{ Regexp.quote(_1) }.join("|")
+      @modifier_matcher ||= Regexp.new modifiers.map { Regexp.quote(it) }.join("|")
     end
 
     def words(method_name)
@@ -66,7 +66,7 @@ module Klee
         end
         .gsub(/\s/, "")
         .split("_")
-        .delete_if { _1.empty? }
+        .delete_if { it.empty? }
     end
   end
 end

data/lib/klee/gestalt.rb

@@ -1,4 +1,3 @@
-require "set"
 module Klee
   class Gestalt
     def initialize(object, patterns:, ignored:)
@@ -49,15 +48,15 @@ module Klee
     end
 
     def prefixes
-      plot.select { |key, _| patterns.prefixes.include?(key) }
+      plot.slice(*patterns.prefixes)
     end
 
     def infixes
-      plot.select { |key, _| patterns.infixes.include?(key) }
+      plot.slice(*patterns.infixes)
     end
 
     def suffixes
-      plot.select { |key, _| patterns.suffixes.include?(key) }
+      plot.slice(*patterns.suffixes)
     end
 
     def unusual?(*items)

data/lib/klee/patterns.rb

@@ -9,7 +9,7 @@ module Klee
 
     def prefix(which)
       @patterns[__callee__].add which
-      send("to_#{__callee__}", which).tap { match(_1) }
+      send("to_#{__callee__}", which).tap { match(it) }
     end
     alias_method :suffix, :prefix
     alias_method :infix, :prefix
@@ -40,7 +40,7 @@ module Klee
     end
 
     def key_for(pattern)
-      keys.find { pattern =~ _1 }
+      keys.find { pattern =~ it }
     end
 
     private

data/lib/klee/version.rb

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

data/lib/klee.rb

@@ -1,9 +1,15 @@
 # frozen_string_literal: true
 
+# require "classifier-reborn"
 require_relative "klee/version"
 require_relative "klee/patterns"
 require_relative "klee/gestalt"
 require_relative "klee/concepts"
+require_relative "klee/collaborators"
+require_relative "klee/file_analyzer"
+require_relative "klee/concept_index"
+require_relative "klee/collaborator_index"
+require_relative "klee/codebase"
 
 module Klee
   class Error < StandardError; end
@@ -20,10 +26,14 @@ module Klee
     Patterns.new(&block)
   end
 
-  def self.concepts(*methond_names, modifiers: [])
-    Concepts.new(*methond_names, modifiers: [])
+  def self.concepts(*method_names, modifiers: [])
+    Concepts.new(*method_names, modifiers: [])
   end
 
+  # def self.classifier
+  #   @classifier ||= ClassifierReborn::Bayes.new "Interesting", "Uninteresting"
+  # end
+
   def self.object_concepts(object, modifiers: [])
     names = if object.respond_to?(:public_instance_methods)
       object.public_instance_methods(false)
@@ -38,4 +48,12 @@ module Klee
     ignored: Class.instance_methods)
     Gestalt.new(object, patterns: patterns, ignored: ignored).trace(threshold: threshold)
   end
+
+  def self.collaborators(const)
+    Klee::Collaborators.new(const)
+  end
+
+  def self.scan(*patterns, ignore: [], threshold: 2)
+    Codebase.new(*patterns, ignore: ignore, threshold: threshold)
+  end
 end

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: klee
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Jim Gay
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-05-06 00:00:00.000000000 Z
-dependencies: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: prism
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Evaluate the similarities and differences in your objects. Art does not
   reflect what is seen, rather it makes the hidden visible.
 email:
@@ -38,7 +51,6 @@ metadata:
   homepage_uri: https://github.com/saturnflyer/klee
   source_code_uri: https://github.com/saturnflyer/klee
   changelog_uri: https://github.com/saturnflyer/klee/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -46,15 +58,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.27
-signing_key:
+rubygems_version: 4.0.5
 specification_version: 4
 summary: Evaluate the similarities and differences in your objects
 test_files: []