scientific-method-engine 20.0.0__tar.gz → 21.0.0__tar.gz

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 (97) hide show
  1. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/PKG-INFO +5 -3
  2. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/README.md +2 -0
  3. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/pyproject.toml +2 -2
  4. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/image.py +1 -1
  5. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_x86.py +6 -4
  6. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/.gitignore +0 -0
  7. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/LICENSE +0 -0
  8. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/__init__.py +0 -0
  9. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/__main__.py +0 -0
  10. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/cli.py +0 -0
  11. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ClearNoReturnFunctions.java +0 -0
  12. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/CreateFunctions.java +0 -0
  13. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ExportBoundedFlow.java +0 -0
  14. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ExportCallEdges.java +0 -0
  15. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ExportFunctionFingerprints.java +0 -0
  16. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ExportFunctionInventory.java +0 -0
  17. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/MergeFallThroughFragment.java +0 -0
  18. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/RecoverCitedFunctions.java +0 -0
  19. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/RepairReturningCallers.java +0 -0
  20. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportCallArguments.java +0 -0
  21. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportCallPaths.java +0 -0
  22. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportCallSitesWithScalars.java +0 -0
  23. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportCallsToRange.java +0 -0
  24. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportConstantFirstArgumentCalls.java +0 -0
  25. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportDataBytes.java +0 -0
  26. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportDecompileMatches.java +0 -0
  27. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportDecompileWindow.java +0 -0
  28. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportFilePatternInMemory.java +0 -0
  29. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportFirstArgumentCallSummary.java +0 -0
  30. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportFunctionScalarConstants.java +0 -0
  31. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportFunctionSummary.java +0 -0
  32. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportInstructionContext.java +0 -0
  33. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportInstructionWindow.java +0 -0
  34. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportMemoryBlockForFileOffset.java +0 -0
  35. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportMemoryBlocks.java +0 -0
  36. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportRandomnessCandidates.java +0 -0
  37. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportRangeBoundaries.java +0 -0
  38. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportReferences.java +0 -0
  39. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportScalarConstants.java +0 -0
  40. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportStringReferences.java +0 -0
  41. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/ReportSymbolReferences.java +0 -0
  42. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/RunQueryPlan.java +0 -0
  43. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/scientificmethod/FirstArgumentLookBack.java +0 -0
  44. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/scientificmethod/InstructionStart.java +0 -0
  45. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/scientificmethod/OperandConstants.java +0 -0
  46. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/scientificmethod/QueryBatch.java +0 -0
  47. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/ghidra/scientificmethod/Xxh3.java +0 -0
  48. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/__init__.py +0 -0
  49. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/argument_frames.py +0 -0
  50. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/derived_counts.py +0 -0
  51. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/dispatch.py +0 -0
  52. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/effect_order.py +0 -0
  53. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/inventory.py +0 -0
  54. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/loops.py +0 -0
  55. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/machine.py +0 -0
  56. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/memory_scopes.py +0 -0
  57. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/pcode.py +0 -0
  58. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/pcode_backend.py +0 -0
  59. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/pe.py +0 -0
  60. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/ranges.py +0 -0
  61. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/reach.py +0 -0
  62. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/relational.py +0 -0
  63. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/reports.py +0 -0
  64. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/result_flow.py +0 -0
  65. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/scan_index.py +0 -0
  66. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/table_bounds.py +0 -0
  67. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/trace.py +0 -0
  68. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/src/scientific_method_engine/x86/values.py +0 -0
  69. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/java/QueryBatchHarness.java +0 -0
  70. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/oracle.py +0 -0
  71. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_config_encoding.py +0 -0
  72. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_continuation_budget.py +0 -0
  73. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_derived_counts.py +0 -0
  74. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_dispatch.py +0 -0
  75. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_effect_order.py +0 -0
  76. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_enter_frames.py +0 -0
  77. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_entry_frame.py +0 -0
  78. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_indirect_far_transfers.py +0 -0
  79. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_interrupt_models.py +0 -0
  80. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_inventory_check.py +0 -0
  81. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_join_terms.py +0 -0
  82. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_loops.py +0 -0
  83. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_memory_scopes.py +0 -0
  84. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_nested_frame_request.py +0 -0
  85. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_oracle.py +0 -0
  86. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_pe.py +0 -0
  87. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_ranges.py +0 -0
  88. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_reach.py +0 -0
  89. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_relational_controls.py +0 -0
  90. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_return_checks.py +0 -0
  91. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_scan_index.py +0 -0
  92. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_successor_rule.py +0 -0
  93. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_table_bounds.py +0 -0
  94. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_table_continuations.py +0 -0
  95. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_term_limit.py +0 -0
  96. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_upstream_gaps.py +0 -0
  97. {scientific_method_engine-20.0.0 → scientific_method_engine-21.0.0}/tests/test_volatile_memory.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: scientific-method-engine
3
- Version: 20.0.0
3
+ Version: 21.0.0
4
4
  Summary: Bounded instruction-derived x86 evidence reports for segmented MZ/FBOV and PE32/i386 code.
5
5
  Project-URL: Source, https://github.com/kibertoad/refurbished-dinosaurs-toolkit/tree/main/packages/scientific-method-engine
6
6
  Author: kibertoad
@@ -8,8 +8,8 @@ License-Expression: MIT
8
8
  License-File: LICENSE
9
9
  Requires-Python: >=3.12
10
10
  Requires-Dist: capstone==5.0.9
11
- Requires-Dist: pypcode==4.0.1
12
- Requires-Dist: xxhash==4.0.1
11
+ Requires-Dist: pypcode==4.1.0
12
+ Requires-Dist: xxhash==4.1.0
13
13
  Provides-Extra: test
14
14
  Requires-Dist: unicorn==2.1.4; extra == 'test'
15
15
  Description-Content-Type: text/markdown
@@ -20,6 +20,8 @@ Bounded instruction-derived x86 evidence reports for segmented 16-bit MZ/FBOV co
20
20
  PE32/i386 code. The engine decodes instructions with Capstone, takes their values, flags and
21
21
  branch conditions from Ghidra's SLEIGH specification through pypcode, follows bounded paths and
22
22
  emits `bounded-x86-v1` JSON. It never runs the original program. It needs Python 3.12 or later.
23
+ It pins `capstone==5.0.9`, `pypcode==4.1.0` and `xxhash==4.1.0`, because reports depend on the
24
+ decoder, and refuses to build a report under any other Capstone or pypcode.
23
25
 
24
26
  ```sh
25
27
  uv add --group research scientific-method-engine # or: pip install scientific-method-engine
@@ -4,6 +4,8 @@ Bounded instruction-derived x86 evidence reports for segmented 16-bit MZ/FBOV co
4
4
  PE32/i386 code. The engine decodes instructions with Capstone, takes their values, flags and
5
5
  branch conditions from Ghidra's SLEIGH specification through pypcode, follows bounded paths and
6
6
  emits `bounded-x86-v1` JSON. It never runs the original program. It needs Python 3.12 or later.
7
+ It pins `capstone==5.0.9`, `pypcode==4.1.0` and `xxhash==4.1.0`, because reports depend on the
8
+ decoder, and refuses to build a report under any other Capstone or pypcode.
7
9
 
8
10
  ```sh
9
11
  uv add --group research scientific-method-engine # or: pip install scientific-method-engine
@@ -5,13 +5,13 @@ build-backend = "hatchling.build"
5
5
  [project]
6
6
  name = "scientific-method-engine"
7
7
  # The release workflow writes the published version from the package's release tag.
8
- version = "20.0.0"
8
+ version = "21.0.0"
9
9
  description = "Bounded instruction-derived x86 evidence reports for segmented MZ/FBOV and PE32/i386 code."
10
10
  readme = "README.md"
11
11
  requires-python = ">=3.12"
12
12
  license = "MIT"
13
13
  authors = [{ name = "kibertoad" }]
14
- dependencies = ["capstone==5.0.9", "pypcode==4.0.1", "xxhash==4.0.1"]
14
+ dependencies = ["capstone==5.0.9", "pypcode==4.1.0", "xxhash==4.1.0"]
15
15
 
16
16
  [project.optional-dependencies]
17
17
  # Unicorn is the tests' concrete oracle (ADR 0003, decision 4). Its core is GPLv2, so it never
@@ -24,7 +24,7 @@ REQUIRED_CAPSTONE = "5.0.9"
24
24
  # The engine's rules for which flags to keep are checked against this SLEIGH specification, such as
25
25
  # the OF of SHR, which pypcode 4.0.0 writes as 0 where 4.0.1 writes the CPU's value.
26
26
  PYPCODE_VERSION = pypcode.__version__
27
- REQUIRED_PYPCODE = "4.0.1"
27
+ REQUIRED_PYPCODE = "4.1.0"
28
28
  MAX_SOURCE = 256 * 1024 * 1024
29
29
  XXH3_FORM = re.compile("[0-9a-f]{32}")
30
30
 
@@ -4,6 +4,7 @@ import itertools
4
4
  import json
5
5
  import os
6
6
  from pathlib import Path
7
+ import re
7
8
  import subprocess
8
9
  import sys
9
10
  import tempfile
@@ -2992,13 +2993,14 @@ class ReporterTests(unittest.TestCase):
2992
2993
  self.assertIsNone(image_module.installed("capstone"))
2993
2994
 
2994
2995
  def test_pypcode_guard_refuses_another_sleigh_specification(self):
2995
- # Which flags the engine keeps after a shift is checked against pypcode 4.0.1's SLEIGH files;
2996
+ # Which flags the engine keeps after a shift is checked against pypcode 4.1.0's SLEIGH files;
2996
2997
  # pypcode 4.0.0 writes the OF of SHR by one as 0.
2997
2998
  self.assertEqual(image_module.PYPCODE_VERSION, image_module.REQUIRED_PYPCODE)
2998
2999
  data = bytes.fromhex("c3")
2999
- with mock.patch.object(image_module, "PYPCODE_VERSION", "4.0.0"):
3000
- with self.assertRaisesRegex(ValueError, r"requires pypcode==4\.0\.1; pypcode 4\.0\.0 is installed"):
3001
- Image(data, configuration(data))
3000
+ for other in ("4.0.0", "4.0.1"):
3001
+ with self.subTest(pypcode=other), mock.patch.object(image_module, "PYPCODE_VERSION", other):
3002
+ with self.assertRaisesRegex(ValueError, rf"requires pypcode==4\.1\.0; pypcode {re.escape(other)} is installed"):
3003
+ Image(data, configuration(data))
3002
3004
 
3003
3005
  def test_cli_identity_and_errors(self):
3004
3006
  with tempfile.TemporaryDirectory() as folder: