cosmic-ray 0.0.0__tar.gz

cosmic_ray-0.0.0/LICENCE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2015-2017 Sixty North AS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

cosmic_ray-0.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include LICENSE.txt
+include README.md

cosmic_ray-0.0.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.1
+Name: cosmic_ray
+Version: 0.0.0
+Summary: Mutation testing
+Author-email: Sixty North AS <austin@sixty-north.com>
+License: Copyright (c) 2015-2017 Sixty North AS
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in
+        all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+        THE SOFTWARE.
+        
+Project-URL: repository, https://github.com/sixty-north/cosmic-ray
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+License-File: LICENCE.txt
+Requires-Dist: aiohttp
+Requires-Dist: anybadge
+Requires-Dist: click
+Requires-Dist: decorator
+Requires-Dist: exit_codes
+Requires-Dist: gitpython
+Requires-Dist: parso
+Requires-Dist: qprompt
+Requires-Dist: rich
+Requires-Dist: sqlalchemy
+Requires-Dist: stevedore
+Requires-Dist: toml
+Requires-Dist: yattag
+Provides-Extra: test
+Requires-Dist: hypothesis; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-mock; extra == "test"
+Provides-Extra: dev
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: flake8-pyproject; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: bump-my-version; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx_rtd_theme; extra == "docs"
+
+|Python version| |Python version windows| |Build Status| |Documentation|
+
+Cosmic Ray: mutation testing for Python
+=======================================
+
+
+   "Four human beings -- changed by space-born cosmic rays into something more than merely human."
+   
+   -- The Fantastic Four
+
+Cosmic Ray is a mutation testing tool for Python 3.
+
+It makes small changes to your source code, running your test suite for each
+one. Here's how the mutations look:
+
+.. image:: docs/source/cr-in-action.gif
+
+|full_documentation|_
+
+Contributing
+------------
+
+The easiest way to contribute is to use Cosmic Ray and submit reports for defects or any other issues you come across.
+Please see CONTRIBUTING.rst for more details.
+
+.. |Python version| image:: https://img.shields.io/badge/Python_version-3.5+-blue.svg
+   :target: https://www.python.org/
+.. |Python version windows| image:: https://img.shields.io/badge/Python_version_(windows)-3.7+-blue.svg
+   :target: https://www.python.org/
+.. |Build Status| image:: https://github.com/sixty-north/cosmic-ray/actions/workflows/python-package.yml/badge.svg
+   :target: https://github.com/sixty-north/cosmic-ray/actions/workflows/python-package.yml
+.. |Code Health| image:: https://landscape.io/github/sixty-north/cosmic-ray/master/landscape.svg?style=flat
+   :target: https://landscape.io/github/sixty-north/cosmic-ray/master
+.. |Code Coverage| image:: https://codecov.io/gh/sixty-north/cosmic-ray/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/Vimjas/covimerage/branch/master
+.. |Documentation| image:: https://readthedocs.org/projects/cosmic-ray/badge/?version=latest
+   :target: http://cosmic-ray.readthedocs.org/en/latest/
+.. |full_documentation| replace:: **Read the full documentation at readthedocs.**
+.. _full_documentation: http://cosmic-ray.readthedocs.org/en/latest/

cosmic_ray-0.0.0/README.rst

@@ -0,0 +1,39 @@
+|Python version| |Python version windows| |Build Status| |Documentation|
+
+Cosmic Ray: mutation testing for Python
+=======================================
+
+
+   "Four human beings -- changed by space-born cosmic rays into something more than merely human."
+   
+   -- The Fantastic Four
+
+Cosmic Ray is a mutation testing tool for Python 3.
+
+It makes small changes to your source code, running your test suite for each
+one. Here's how the mutations look:
+
+.. image:: docs/source/cr-in-action.gif
+
+|full_documentation|_
+
+Contributing
+------------
+
+The easiest way to contribute is to use Cosmic Ray and submit reports for defects or any other issues you come across.
+Please see CONTRIBUTING.rst for more details.
+
+.. |Python version| image:: https://img.shields.io/badge/Python_version-3.5+-blue.svg
+   :target: https://www.python.org/
+.. |Python version windows| image:: https://img.shields.io/badge/Python_version_(windows)-3.7+-blue.svg
+   :target: https://www.python.org/
+.. |Build Status| image:: https://github.com/sixty-north/cosmic-ray/actions/workflows/python-package.yml/badge.svg
+   :target: https://github.com/sixty-north/cosmic-ray/actions/workflows/python-package.yml
+.. |Code Health| image:: https://landscape.io/github/sixty-north/cosmic-ray/master/landscape.svg?style=flat
+   :target: https://landscape.io/github/sixty-north/cosmic-ray/master
+.. |Code Coverage| image:: https://codecov.io/gh/sixty-north/cosmic-ray/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/Vimjas/covimerage/branch/master
+.. |Documentation| image:: https://readthedocs.org/projects/cosmic-ray/badge/?version=latest
+   :target: http://cosmic-ray.readthedocs.org/en/latest/
+.. |full_documentation| replace:: **Read the full documentation at readthedocs.**
+.. _full_documentation: http://cosmic-ray.readthedocs.org/en/latest/

cosmic_ray-0.0.0/pyproject.toml

@@ -0,0 +1,93 @@
+[build-system]
+requires = ['setuptools']
+build-backend = 'setuptools.build_meta'
+
+[project]
+name = "cosmic_ray"
+requires-python = ">= 3.7"
+dynamic = ["version"]
+authors = [{ name = "Sixty North AS", email = "austin@sixty-north.com" }]
+description = "Mutation testing"
+readme = { file = "README.rst", content-type = "text/x-rst" }
+license = { file = "LICENCE.txt" }
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3.7",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Software Development :: Testing",
+
+]
+dependencies = [
+  "aiohttp",
+  "anybadge",
+  "click",
+  "decorator",
+  "exit_codes",
+  "gitpython",
+  "parso",
+  "qprompt",
+  "rich",
+  "sqlalchemy",
+  "stevedore",
+  "toml",
+  "yattag",
+]
+
+[project.optional-dependencies]
+test = ["hypothesis", "pytest", "pytest-mock"]
+dev = ["flake8", "flake8-pyproject", "ruff", "bump-my-version"]
+docs = ["sphinx", "sphinx_rtd_theme"]
+
+[project.scripts]
+cosmic-ray = "cosmic_ray.cli:main"
+cr-html = "cosmic_ray.tools.html:report_html"
+cr-report = "cosmic_ray.tools.report:report"
+cr-badge = "cosmic_ray.tools.badge:generate_badge"
+cr-rate = "cosmic_ray.tools.survival_rate:format_survival_rate"
+cr-xml = "cosmic_ray.tools.xml:report_xml"
+cr-filter-operators = "cosmic_ray.tools.filters.operators_filter:main"
+cr-filter-pragma = "cosmic_ray.tools.filters.pragma_no_mutate:main"
+cr-filter-git = "cosmic_ray.tools.filters.git:main"
+cr-http-workers = "cosmic_ray.tools.http_workers:main"
+
+[project.entry-points."cosmic_ray.operator_providers"]
+core = "cosmic_ray.operators.provider:OperatorProvider"
+
+[project.entry-points."cosmic_ray.distributors"]
+http = "cosmic_ray.distribution.http:HttpDistributor"
+local = "cosmic_ray.distribution.local:LocalDistributor"
+
+[project.urls]
+repository = "https://github.com/sixty-north/cosmic-ray"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.bumpversion]
+current_version = "8.3.9"
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = ["{major}.{minor}.{patch}"]
+tag = true
+commit = true
+message = "Bump version: {current_version} → {new_version}"
+tag_name = "release/v{new_version}"
+tag_message = "Bump version: {current_version} → {new_version}"
+
+[[tool.bumpversion.files]]
+filename = "src/cosmic_ray/version.py"
+
+[tool.flake8]
+max-line-length = 120
+
+[tool.ruff]
+line-length = 120

cosmic_ray-0.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cosmic_ray-0.0.0/src/cosmic_ray/__init__.py

@@ -0,0 +1 @@
+"""Cosmic Ray is a mutation testing tool for Python."""

cosmic_ray-0.0.0/src/cosmic_ray/ast/__init__.py

@@ -0,0 +1,109 @@
+"Tools for working with parso ASTs."
+
+from abc import ABC, abstractmethod
+import io
+
+import parso.python.tree
+import parso.tree
+
+
+class Visitor(ABC):
+    """AST visitor for parso trees.
+
+    This supports both simple traversal as well as editing of the tree.
+    """
+
+    def walk(self, node):
+        "Walk a parse tree, calling visit for each node."
+        node = self.visit(node)
+
+        if node is None:
+            return None
+
+        if isinstance(node, parso.tree.BaseNode):
+            walked = map(self.walk, node.children)
+            node.children = [child for child in walked if child is not None]
+
+        return node
+
+    @abstractmethod
+    def visit(self, node):
+        """Called for each node in the walk.
+
+        This should return a node that will replace the node argument in the AST. This can be
+        the node argument itself, a new node, or None. If None is returned, then the node is
+        removed from the tree.
+
+        Args:
+            node: The node currently being visited.
+
+        Returns:
+            A node or `None`.
+        """
+
+
+def ast_nodes(node):
+    """Iterable of all nodes in a tree.
+
+    Args:
+        node: The top node in a parso tree to iterate.
+
+    Yields:
+        All of the nodes in the tree.
+    """
+    yield node
+
+    if isinstance(node, parso.tree.BaseNode):
+        for child in node.children:
+            yield from ast_nodes(child)
+
+
+def get_ast(module_path):
+    """Get the AST for the code in a file.
+
+    Args:
+        module_path: pathlib.Path to the file containing the code.
+
+    Returns:
+        The parso parse tree for the code in `module_path`.
+    """
+    with module_path.open(mode="rt", encoding="utf-8") as handle:
+        source = handle.read()
+
+    return parso.parse(source)
+
+
+def is_none(node):
+    "Determine if a node is the `None` keyword."
+    return isinstance(node, parso.python.tree.Keyword) and node.value == "None"
+
+
+def is_number(node):
+    "Determine if a node is a number."
+    return isinstance(node, parso.python.tree.Number)
+
+
+def dump_node(node):
+    "Generate string version of node."
+    buffer = io.StringIO()
+    write = buffer.write
+
+    def do_dump(node, indent=""):
+        write("{}{}({}".format(indent, type(node).__name__, node.type))
+        value = getattr(node, "value", None)
+        if value:
+            value = value.replace("\n", "\\n")
+            write(", '{}'".format(value))
+        children = getattr(node, "children", None)
+        if children:
+            write(", [\n")
+            for child in children:
+                do_dump(child, indent + " " * 4)
+                write(",\n")
+            write("{}]".format(indent))
+        write(")")
+        if not indent:
+            write("\n")
+
+    do_dump(node)
+    return buffer.getvalue()

cosmic_ray-0.0.0/src/cosmic_ray/ast/ast_query.py

@@ -0,0 +1,115 @@
+"Tools for querying ASTs."
+
+
+class ASTQuery:
+    """
+    Allowing to navigate into any object and test attribute of any object:
+
+    Examples:
+    >>> ASTQuery(node).parent.match(Node, type='node').ok
+
+    Test if node.parent isinstance of Node and node.parent.type == 'node'
+    At each step (each '.' (dot)) you receive an ObjTest object, then
+
+    Navigation:
+    You can call any properties or functions of the base object
+    >>> ASTQuery(node).parent.children[2].get_next_sibling()
+
+    Test:
+    >>> ASTQuery(node).match(attr='value').match(Class)
+    All in once:
+    >>> ASTQuery(node).match(Class, attr='value')
+
+    Conditional navigation:
+    >>> ASTQuery(node).IF.match(attr='intermediate').parent.FI
+
+    Final result:
+    >>> ASTQuery(node).ok
+    >>> bool(ASTQuery(node))
+
+    """
+
+    def __init__(self, obj):
+        self.obj = obj
+
+    def _clone(self, obj) -> "ASTQuery":
+        "Clone this query."
+        return type(self)(obj)
+
+    def match(self, cls=None, **kwargs) -> "ASTQuery":
+        "Check if node matches a class."
+        obj = self.obj
+        if obj is None:
+            return self
+
+        if cls is None or isinstance(obj, cls):
+            for k, v in kwargs.items():
+                op = None
+                k__op = k.split("__")
+                if len(k__op) == 2:
+                    k, op = k__op
+                node_value = getattr(obj, k)
+                if op is None:
+                    if node_value != v:
+                        break
+                elif op == "in":
+                    if node_value not in v:
+                        break
+                else:
+                    raise ValueError("Can't handle operator {}".format(op))
+            else:
+                # All is true, continue recursion
+                return self
+
+        # A test fails
+        return self._clone(None)
+
+    @property
+    def ok(self):
+        "Is the query ok."
+        return bool(self.obj)
+
+    def __bool__(self):
+        return self.ok
+
+    def __getattr__(self, item) -> "ASTQuery":
+        obj = self.obj
+        if obj is None:
+            return self
+        return self._clone(getattr(obj, item))
+
+    @property
+    def IF(self):
+        "Conditional navigation."
+        return ASTQueryOptional(self.obj, obj_test=self)
+
+    def __call__(self, *args, **kwargs) -> "ASTQuery":
+        if self.obj is None:
+            return self
+        return self._clone(self.obj(*args, **kwargs))
+
+    def __getitem__(self, item) -> "ASTQuery":
+        if self.obj is None:
+            return self
+        return self._clone(self.obj[item])
+
+
+class ASTQueryOptional(ASTQuery):
+    "Manages conditional navigation."
+
+    def __init__(self, obj, obj_test=None):
+        super().__init__(obj)
+        self._initial = obj_test
+
+    def _clone(self, obj):
+        o = super()._clone(obj)
+        o._initial = self._initial  # pylint: disable=protected-access
+
+        return o
+
+    @property
+    def FI(self):
+        "End of conditional navigation."
+        if self:
+            return self._initial._clone(self.obj)  # pylint: disable=protected-access
+        return self._initial