marameters 4.0.1 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/README.adoc +0 -1
  4. data/lib/marameters/signatures/defaulter.rb +1 -1
  5. data/lib/marameters/sourcers/function.rb +28 -0
  6. data/lib/marameters/sourcers/readers/any.rb +29 -0
  7. data/lib/marameters/sourcers/readers/disk.rb +18 -0
  8. data/lib/marameters/sourcers/readers/memory.rb +10 -0
  9. data/lib/marameters/sources/extractor.rb +3 -0
  10. data/lib/marameters/sources/reader.rb +3 -0
  11. data/marameters.gemspec +1 -1
  12. data.tar.gz.sig +0 -0
  13. metadata +6 -2
  14. metadata.gz.sig +3 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 1499010bf03407332bde415ad66e861d6ba68dbcd71c2612b8bb205ca9002e86
4
- data.tar.gz: 0a019c4746630f7b5160468a69e1b1b944273ec6a5938d1a63816f25f3cdff7c
3
+ metadata.gz: 4e75fcf0d2ce27a87be66111142b52633ccd85f157a8590f85e0bc22f3d45383
4
+ data.tar.gz: 8195f5f72414fe01cb28acc32df595f380bc072f5dac47a905a87646c4086b89
5
5
  SHA512:
6
- metadata.gz: be3f541897eabc80c899fe2f1a4c2e7d0c9ea78b6c75df0443d9f24c6123b684f0dacbe61061a86f0c5796eefb251b2fde9f69bd9fc533a973f82b40360e4460
7
- data.tar.gz: a725045f723817c8c124699e1902063e689c09dcf8dbe44d46c48fd27191cf6b0f80379f8b8d4d5383d5cccf40a13cd4d41d52c33efc418f65358c947d4081cc
6
+ metadata.gz: 37a9ebbb23019fe2a76e62737b3bef254bd2ca62908d45fe047492f1615a72ec74c110b272bd3081d8984f2fea581535b83cdf4590b41b61492a64664b3bc3a9
7
+ data.tar.gz: 2e440c9a5d431da24abd551ae7ffc5f712bacf53203e2de82d0d25806b762dcc031f5fb4425809081fa635f287fccadc279e3c2a4c3a6cd8cdb3452d0ff4a267
checksums.yaml.gz.sig CHANGED
Binary file
data/README.adoc CHANGED
@@ -449,7 +449,6 @@ puts Marameters.signature([[:key, :demo, :test]])
449
449
  # With proc (no parameters).
450
450
  puts Marameters.signature([[:key, :demo, proc { Object.new }]])
451
451
  # "demo: Object.new"
452
- # ⚠️ The above will answer "demo: nil" if used in IRB since the source can't be found.
453
452
 
454
453
  # With proc (with parameters).
455
454
  puts Marameters.signature([[:key, :demo, proc { |no| no }]])
data/lib/marameters/signatures/defaulter.rb CHANGED
@@ -3,7 +3,7 @@
3
3
  module Marameters
4
4
  module Signatures
5
5
  # Computes a method parameter's default value.
6
- Defaulter = lambda do |value, extractor: Sources::Extractor.new|
6
+ Defaulter = lambda do |value, extractor: Sourcers::Function.new|
7
7
  case value
8
8
  when Proc
9
9
  fail TypeError, "Use procs instead of lambdas for defaults." if value.lambda?
data/lib/marameters/sourcers/function.rb ADDED
@@ -0,0 +1,28 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Marameters
4
+ module Sourcers
5
+ # Obtains the literal source of a function's body.
6
+ class Function
7
+ PATTERN = /
8
+ (?:(?<function>proc|->))? # Statement.
9
+ \s* # Optional space.
10
+ \{ # Block open.
11
+ (?<body>.*?) # Source code body.
12
+ \} # Block close.
13
+ /x
14
+
15
+ def initialize pattern: PATTERN, reader: Readers::Any.new
16
+ @pattern = pattern
17
+ @reader = reader
18
+ freeze
19
+ end
20
+
21
+ def call(function) = reader.call(function).then { |line| line.match(pattern)[:body].strip }
22
+
23
+ private
24
+
25
+ attr_reader :pattern, :reader
26
+ end
27
+ end
28
+ end
data/lib/marameters/sourcers/readers/any.rb ADDED
@@ -0,0 +1,29 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Marameters
4
+ module Sourcers
5
+ module Readers
6
+ # Reads source code of callable from disk or memory.
7
+ class Any
8
+ def initialize parser: RubyVM::InstructionSequence, disk: Disk, memory: Memory
9
+ @parser = parser
10
+ @disk = disk
11
+ @memory = memory
12
+ freeze
13
+ end
14
+
15
+ def call callable
16
+ instructions = parser.of callable
17
+
18
+ fail StandardError, "Unable to load source for: #{callable.inspect}." unless instructions
19
+
20
+ instructions.absolute_path ? disk.call(instructions) : memory.call(instructions)
21
+ end
22
+
23
+ private
24
+
25
+ attr_reader :parser, :disk, :memory
26
+ end
27
+ end
28
+ end
29
+ end
data/lib/marameters/sourcers/readers/disk.rb ADDED
@@ -0,0 +1,18 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Marameters
4
+ module Sourcers
5
+ module Readers
6
+ # Reads source code from on-disk instruction sequence.
7
+ Disk = lambda do |instructions|
8
+ path = instructions.absolute_path
9
+ line_start, column_start, line_end, column_end = instructions.to_a.dig 4, :code_location
10
+ lines = File.read(path).lines[(line_start - 1)..(line_end - 1)]
11
+ lines[-1] = lines.last.byteslice(...column_end)
12
+ lines[0] = lines.first.byteslice(column_start..)
13
+
14
+ lines.join
15
+ end
16
+ end
17
+ end
18
+ end
data/lib/marameters/sourcers/readers/memory.rb ADDED
@@ -0,0 +1,10 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Marameters
4
+ module Sourcers
5
+ module Readers
6
+ # Reads source code from in-memory instruction sequence.
7
+ Memory = -> instructions { instructions.script_lines.join.chomp }
8
+ end
9
+ end
10
+ end
data/lib/marameters/sources/extractor.rb CHANGED
@@ -13,6 +13,9 @@ module Marameters
13
13
  /x
14
14
 
15
15
  def initialize pattern: PATTERN, reader: Reader.new
16
+ warn "`#{self.class}` is deprecated, use `Sourcers::Function` instead.",
17
+ category: :deprecated
18
+
16
19
  @pattern = pattern
17
20
  @reader = reader
18
21
  @fallback = "nil"
data/lib/marameters/sources/reader.rb CHANGED
@@ -5,6 +5,9 @@ module Marameters
5
5
  # Reads object source code from memory or file (assumes implementation is a one-liner).
6
6
  class Reader
7
7
  def initialize offset: 1, parser: RubyVM::InstructionSequence, io: File
8
+ warn "`#{self.class}` is deprecated, use `Sourcers::Readers::Any` instead.",
9
+ category: :deprecated
10
+
8
11
  @offset = offset
9
12
  @parser = parser
10
13
  @io = io
data/marameters.gemspec CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Gem::Specification.new do |spec|
4
4
  spec.name = "marameters"
5
- spec.version = "4.0.1"
5
+ spec.version = "4.1.0"
6
6
  spec.authors = ["Brooke Kuhlmann"]
7
7
  spec.email = ["brooke@alchemists.io"]
8
8
  spec.homepage = "https://alchemists.io/projects/marameters"
data.tar.gz.sig CHANGED
Binary file
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: marameters
3
3
  version: !ruby/object:Gem::Version
4
- version: 4.0.1
4
+ version: 4.1.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Brooke Kuhlmann
@@ -34,7 +34,7 @@ cert_chain:
34
34
  3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
35
35
  gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
36
36
  -----END CERTIFICATE-----
37
- date: 2024-12-28 00:00:00.000000000 Z
37
+ date: 2025-01-10 00:00:00.000000000 Z
38
38
  dependencies:
39
39
  - !ruby/object:Gem::Dependency
40
40
  name: refinements
@@ -84,6 +84,10 @@ files:
84
84
  - lib/marameters/signatures/forwarder.rb
85
85
  - lib/marameters/signatures/inheritor.rb
86
86
  - lib/marameters/signatures/super.rb
87
+ - lib/marameters/sourcers/function.rb
88
+ - lib/marameters/sourcers/readers/any.rb
89
+ - lib/marameters/sourcers/readers/disk.rb
90
+ - lib/marameters/sourcers/readers/memory.rb
87
91
  - lib/marameters/sources/extractor.rb
88
92
  - lib/marameters/sources/reader.rb
89
93
  - marameters.gemspec
metadata.gz.sig CHANGED
@@ -1,2 +1,3 @@
1
- �V�7>dP)����u��%�� ye�ٺ�%*��B#4r�n
2
- �[>��%"NX�z����L4B��-A|
1
+ >$ �&u ���Zv����"'���Cv-Y��2����k��J��2�3 /���ֿH�$ �>��L��P���T�‹�)��޼A�Hqma$JR�DS4��B�m�N9��j�:��T�N��Aq)b�T���uO��7so+� b�����L�tE��
2
+ |��w�e�^��O�Y���o>eTa���# -6im���5ÁK�|�X%�u�eV)C>�%YH,k%3�g@ m�;��>G�+�>�+@��y*W�
3
+ [�q�t�ZCߚ�k�չ&�b��ʂ��V���',�������v�y��"�8����-��I��#��P