sflkit 0.4.0__tar.gz → 0.5.1__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 (85) hide show
  1. {sflkit-0.4.0/src/sflkit.egg-info → sflkit-0.5.1}/PKG-INFO +5 -25
  2. {sflkit-0.4.0 → sflkit-0.5.1}/pyproject.toml +13 -4
  3. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/__init__.py +7 -4
  4. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/analysis_type.py +13 -13
  5. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/analyzer.py +22 -5
  6. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/factory.py +166 -89
  7. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/predicate.py +86 -63
  8. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/similarity.py +1 -1
  9. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/spectra.py +100 -49
  10. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/config.py +35 -0
  11. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/events/event_file.py +15 -1
  12. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/features/handler.py +55 -24
  13. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/features/value.py +26 -5
  14. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/features/vector.py +27 -14
  15. sflkit-0.5.1/src/sflkit/model/model.py +150 -0
  16. sflkit-0.5.1/src/sflkit/model/parallel.py +97 -0
  17. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/runners/__init__.py +3 -0
  18. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/runners/run.py +154 -11
  19. sflkit-0.5.1/src/sflkit/weights/models.py +329 -0
  20. {sflkit-0.4.0 → sflkit-0.5.1/src/sflkit.egg-info}/PKG-INFO +5 -25
  21. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit.egg-info/SOURCES.txt +4 -0
  22. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit.egg-info/requires.txt +1 -1
  23. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_cli.py +2 -1
  24. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_config.py +2 -2
  25. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_dependency_weights.py +4 -2
  26. sflkit-0.5.1/tests/test_features.py +451 -0
  27. sflkit-0.5.1/tests/test_parallelization.py +318 -0
  28. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_runner.py +3 -1
  29. sflkit-0.5.1/tests/test_runner_parallel.py +119 -0
  30. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_runner_pytest_versions.py +1 -1
  31. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_suggestions.py +2 -0
  32. sflkit-0.4.0/src/sflkit/model/model.py +0 -114
  33. sflkit-0.4.0/src/sflkit/weights/models.py +0 -300
  34. {sflkit-0.4.0 → sflkit-0.5.1}/LICENSE +0 -0
  35. {sflkit-0.4.0 → sflkit-0.5.1}/README.md +0 -0
  36. {sflkit-0.4.0 → sflkit-0.5.1}/setup.cfg +0 -0
  37. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/__init__.py +0 -0
  38. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/mapping.py +0 -0
  39. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/analysis/suggestion.py +0 -0
  40. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/cli.py +0 -0
  41. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/color.py +0 -0
  42. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/evaluation.py +0 -0
  43. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/events/__init__.py +0 -0
  44. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/events/mapping.py +0 -0
  45. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/features/__init__.py +0 -0
  46. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/instrumentation/__init__.py +0 -0
  47. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/instrumentation/dir_instrumentation.py +0 -0
  48. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/instrumentation/file_instrumentation.py +0 -0
  49. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/__init__.py +0 -0
  50. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/extract.py +0 -0
  51. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/finder.py +0 -0
  52. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/java/__init__.py +0 -0
  53. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/java/extract.py +0 -0
  54. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/java/factory.py +0 -0
  55. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/java/finder.py +0 -0
  56. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/java/visitor.py +0 -0
  57. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/language.py +0 -0
  58. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/meta.py +0 -0
  59. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/python/__init__.py +0 -0
  60. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/python/extract.py +0 -0
  61. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/python/factory.py +0 -0
  62. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/python/finder.py +0 -0
  63. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/python/visitor.py +0 -0
  64. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/language/visitor.py +0 -0
  65. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/logger.py +0 -0
  66. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/model/__init__.py +0 -0
  67. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/model/scope.py +0 -0
  68. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/weights/__init__.py +0 -0
  69. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit/weights/analyzer.py +0 -0
  70. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit.egg-info/dependency_links.txt +0 -0
  71. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit.egg-info/entry_points.txt +0 -0
  72. {sflkit-0.4.0 → sflkit-0.5.1}/src/sflkit.egg-info/top_level.txt +0 -0
  73. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_analysis_objects.py +0 -0
  74. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_analyzer.py +0 -0
  75. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_color.py +0 -0
  76. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_coverage.py +0 -0
  77. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_evaluation.py +0 -0
  78. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_events.py +0 -0
  79. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_execution.py +0 -0
  80. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_instrumentation.py +0 -0
  81. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_language.py +0 -0
  82. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_predicates.py +0 -0
  83. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_scope.py +0 -0
  84. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_spectra.py +0 -0
  85. {sflkit-0.4.0 → sflkit-0.5.1}/tests/test_visitors.py +0 -0
@@ -1,41 +1,21 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: sflkit
3
- Version: 0.4.0
3
+ Version: 0.5.1
4
4
  Summary: SFLKit: : A Workbench for Statistical Fault Localization
5
5
  Author-email: Marius Smytzek <marius.smytzek@cispa.de>
6
- License: MIT License
7
-
8
- Copyright (c) 2022 Marius Smytzek
9
-
10
- Permission is hereby granted, free of charge, to any person obtaining a copy
11
- of this software and associated documentation files (the "Software"), to deal
12
- in the Software without restriction, including without limitation the rights
13
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14
- copies of the Software, and to permit persons to whom the Software is
15
- furnished to do so, subject to the following conditions:
16
-
17
- The above copyright notice and this permission notice shall be included in all
18
- copies or substantial portions of the Software.
19
-
20
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
26
- SOFTWARE.
27
-
28
6
  Project-URL: Homepage, https://github.com/smythi93/sflkit/
29
7
  Project-URL: Bug Tracker, https://github.com/smythi93/sflkit/issues
30
8
  Classifier: Intended Audience :: Science/Research
9
+ Classifier: Programming Language :: Python :: 3.13
10
+ Classifier: Programming Language :: Python :: 3.12
11
+ Classifier: Programming Language :: Python :: 3.11
31
12
  Classifier: Programming Language :: Python :: 3.10
32
- Classifier: License :: OSI Approved :: MIT License
33
13
  Classifier: Topic :: Scientific/Engineering
34
14
  Classifier: Topic :: Software Development :: Testing
35
15
  Requires-Python: >=3.10
36
16
  Description-Content-Type: text/markdown
37
17
  License-File: LICENSE
38
- Requires-Dist: sflkitlib>=0.1.1
18
+ Requires-Dist: sflkitlib>=0.2.2
39
19
  Requires-Dist: numpy>=2.1.3
40
20
  Requires-Dist: matplotlib>=3.10.0
41
21
  Requires-Dist: pandas>=2.2.3
@@ -7,23 +7,25 @@ build-backend = "setuptools.build_meta"
7
7
 
8
8
  [project]
9
9
  name = "sflkit"
10
- version = "0.4.0"
10
+ dynamic = ["version"]
11
11
  authors = [
12
12
  { name = "Marius Smytzek", email = "marius.smytzek@cispa.de" },
13
13
  ]
14
14
  description = "SFLKit: : A Workbench for Statistical Fault Localization"
15
15
  readme = "README.md"
16
- license = { file = "LICENSE" }
16
+ license-files = ["LICENSE*"]
17
17
  requires-python = ">=3.10"
18
18
  classifiers = [
19
19
  "Intended Audience :: Science/Research",
20
+ "Programming Language :: Python :: 3.13",
21
+ "Programming Language :: Python :: 3.12",
22
+ "Programming Language :: Python :: 3.11",
20
23
  "Programming Language :: Python :: 3.10",
21
- "License :: OSI Approved :: MIT License",
22
24
  "Topic :: Scientific/Engineering",
23
25
  "Topic :: Software Development :: Testing"
24
26
  ]
25
27
  dependencies = [
26
- "sflkitlib>=0.1.1",
28
+ "sflkitlib>=0.2.2",
27
29
  "numpy>=2.1.3",
28
30
  "matplotlib>=3.10.0",
29
31
  "pandas>=2.2.3",
@@ -35,9 +37,16 @@ dependencies = [
35
37
  "Homepage" = "https://github.com/smythi93/sflkit/"
36
38
  "Bug Tracker" = "https://github.com/smythi93/sflkit/issues"
37
39
 
40
+ [tool.setuptools.dynamic]
41
+ version = {attr = "sflkit.__version__"}
42
+
38
43
  [project.scripts]
39
44
  sflkit = "sflkit.cli:main"
40
45
 
46
+ # only include packages in src/
47
+ [tool.setuptools.packages.find]
48
+ where = ["src"]
49
+
41
50
  [project.optional-dependencies]
42
51
  test = [
43
52
  "pytest>=8.3.4",
@@ -6,6 +6,9 @@ from sflkit.config import Config, parse_config
6
6
  from sflkit.instrumentation.dir_instrumentation import DirInstrumentation
7
7
 
8
8
 
9
+ __version__ = "0.5.1"
10
+
11
+
9
12
  def instrument_config(conf: Config):
10
13
  instrumentation = DirInstrumentation(
11
14
  conf.visitor, conf.mapping.path, test_visitor=conf.test_visitor
@@ -54,10 +57,10 @@ def analyze_config(conf: Config, analysis_dump: PathLike = None):
54
57
  results[analysis_type.name] = dict()
55
58
  for metric in conf.metrics:
56
59
  try:
57
- results[analysis_type.name][
58
- metric.__name__
59
- ] = analyzer.get_sorted_suggestions(
60
- conf.target_path, metric, analysis_type
60
+ results[analysis_type.name][metric.__name__] = (
61
+ analyzer.get_sorted_suggestions(
62
+ conf.target_path, metric, analysis_type
63
+ )
61
64
  )
62
65
  except (AttributeError, ValueError, TypeError) as e:
63
66
  raise e
@@ -1,6 +1,6 @@
1
+ import abc
1
2
  import enum
2
- from abc import abstractmethod
3
- from typing import List, Type, Optional
3
+ from typing import List, Type, Optional, Any
4
4
 
5
5
  from sflkit.events.event_file import EventFile
6
6
  from sflkit.model.scope import Scope
@@ -43,7 +43,7 @@ If you want to add new spectra or predicates, please register them here and in s
43
43
  """
44
44
 
45
45
 
46
- class AnalysisObject:
46
+ class AnalysisObject(abc.ABC):
47
47
  function_finder = None
48
48
  loop_finder = None
49
49
  branch_finder = None
@@ -58,17 +58,17 @@ class AnalysisObject:
58
58
  def __init__(self):
59
59
  self.suspiciousness: float = 0
60
60
  self.last_evaluation: EvaluationResult = EvaluationResult.UNOBSERVED
61
- self.hits = dict()
61
+ self.hits: dict[EventFile, dict[Optional[int], Any]] = dict()
62
62
 
63
63
  def adjust_weight(self, event_file: EventFile, weight: float):
64
64
  pass
65
65
 
66
- @abstractmethod
66
+ @abc.abstractmethod
67
67
  def serialize(self) -> dict:
68
68
  pass
69
69
 
70
70
  @staticmethod
71
- @abstractmethod
71
+ @abc.abstractmethod
72
72
  def deserialize(s: dict) -> "AnalysisObject":
73
73
  pass
74
74
 
@@ -82,7 +82,7 @@ class AnalysisObject:
82
82
  return f"{self.analysis_type()}"
83
83
 
84
84
  @staticmethod
85
- @abstractmethod
85
+ @abc.abstractmethod
86
86
  def analysis_type() -> AnalysisType:
87
87
  raise NotImplementedError()
88
88
 
@@ -93,19 +93,19 @@ class AnalysisObject:
93
93
  def calculate(self):
94
94
  pass
95
95
 
96
- @abstractmethod
96
+ @abc.abstractmethod
97
97
  def finalize(self, passed: List, failed: List):
98
98
  raise NotImplementedError()
99
99
 
100
- @abstractmethod
101
- def hit(self, id_, event, scope_: Scope = None):
100
+ @abc.abstractmethod
101
+ def hit(self, id_: EventFile, event, scope: Scope = None):
102
102
  raise NotImplementedError()
103
103
 
104
- @abstractmethod
104
+ @abc.abstractmethod
105
105
  def get_suggestion(self):
106
106
  raise NotImplementedError()
107
107
 
108
- @abstractmethod
108
+ @abc.abstractmethod
109
109
  def assign_suspiciousness(self):
110
110
  raise NotImplementedError()
111
111
 
@@ -114,7 +114,7 @@ class AnalysisObject:
114
114
  return any(map(lambda e: isinstance(event, e), events))
115
115
 
116
116
  @staticmethod
117
- @abstractmethod
117
+ @abc.abstractmethod
118
118
  def events() -> List[Type]:
119
119
  raise NotImplementedError()
120
120
 
@@ -1,5 +1,6 @@
1
1
  import json
2
2
  import os
3
+ from concurrent.futures import ThreadPoolExecutor
3
4
  from typing import List, Callable, Set, Dict, Optional, Any, Type
4
5
 
5
6
  from sflkit.analysis.analysis_type import AnalysisType, AnalysisObject
@@ -22,6 +23,7 @@ from sflkit.analysis.spectra import Line, Function, DefUse, Loop, Length
22
23
  from sflkit.analysis.suggestion import Suggestion
23
24
  from sflkit.events.event_file import EventFile
24
25
  from sflkit.model.model import Model, MetaModel
26
+ from sflkit.model.parallel import ParallelModel
25
27
 
26
28
 
27
29
  class AnalysisEncoder(json.JSONEncoder):
@@ -39,7 +41,9 @@ class Analyzer:
39
41
  irrelevant_event_files: Optional[List[EventFile]] = None,
40
42
  factory: Optional[AnalysisFactory] = None,
41
43
  meta_model: Optional[MetaModel] = None,
42
- model_class: Type[Model] = Model,
44
+ model_class: Type[Model] = None,
45
+ parallel: bool = False,
46
+ workers: int = 4,
43
47
  ):
44
48
  if (
45
49
  relevant_event_files is None
@@ -56,7 +60,13 @@ class Analyzer:
56
60
  if self.meta:
57
61
  self.model = meta_model
58
62
  else:
63
+ if model_class is None:
64
+ if parallel:
65
+ model_class = ParallelModel
66
+ else:
67
+ model_class = Model
59
68
  self.model = model_class(factory)
69
+ self.workers = workers
60
70
  self.paths: Dict[int, os.PathLike] = dict()
61
71
  self.max_suspiciousness = 0
62
72
  self.min_suspiciousness = 0
@@ -69,7 +79,7 @@ class Analyzer:
69
79
  self.model.prepare(event_file)
70
80
  with event_file:
71
81
  for event in event_file.load():
72
- event.handle(self.model)
82
+ event.handle(self.model, event_file)
73
83
  self.model.follow_up(event_file)
74
84
 
75
85
  def _finalize(self):
@@ -80,9 +90,16 @@ class Analyzer:
80
90
  def analyze(self):
81
91
  if self.meta:
82
92
  raise NotImplementedError("Not implemented for meta/loaded analyzer")
83
- for event_file in self.relevant_event_files + self.irrelevant_event_files:
84
- self.paths[event_file.run_id] = event_file.path
85
- self._analyze(event_file)
93
+ if self.workers > 1:
94
+ event_files = self.relevant_event_files + self.irrelevant_event_files
95
+ for event_file in event_files:
96
+ self.paths[event_file.run_id] = event_file.path
97
+ with ThreadPoolExecutor(max_workers=self.workers) as executor:
98
+ list(executor.map(self._analyze, event_files))
99
+ else:
100
+ for event_file in self.relevant_event_files + self.irrelevant_event_files:
101
+ self.paths[event_file.run_id] = event_file.path
102
+ self._analyze(event_file)
86
103
  self._finalize()
87
104
 
88
105
  def dump(self, path: os.PathLike, indent: Optional[int] = None):