angr 9.2.116__tar.gz → 9.2.117__tar.gz

angr-9.2.117/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.1
+Name: angr
+Version: 9.2.117
+Summary: A multi-architecture binary analysis toolkit, with the ability to perform dynamic symbolic execution and various static analyses on binaries
+Home-page: https://github.com/angr/angr
+License: BSD-2-Clause
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: CppHeaderParser
+Requires-Dist: GitPython
+Requires-Dist: ailment==9.2.117
+Requires-Dist: archinfo==9.2.117
+Requires-Dist: cachetools
+Requires-Dist: capstone==5.0.2
+Requires-Dist: cffi>=1.14.0
+Requires-Dist: claripy==9.2.117
+Requires-Dist: cle==9.2.117
+Requires-Dist: dpkt
+Requires-Dist: itanium-demangler
+Requires-Dist: mulpyplexer
+Requires-Dist: nampa
+Requires-Dist: networkx!=2.8.1,>=2.0
+Requires-Dist: protobuf>=3.19.0
+Requires-Dist: psutil
+Requires-Dist: pycparser>=2.18
+Requires-Dist: pyformlang
+Requires-Dist: pyvex==9.2.117
+Requires-Dist: rich>=13.1.0
+Requires-Dist: rpyc
+Requires-Dist: sortedcontainers
+Requires-Dist: sympy
+Requires-Dist: unicorn==2.0.1.post1
+Requires-Dist: unique-log-filter
+Requires-Dist: colorama; platform_system == "Windows"
+Provides-Extra: angrdb
+Requires-Dist: sqlalchemy; extra == "angrdb"
+Provides-Extra: docs
+Requires-Dist: furo; extra == "docs"
+Requires-Dist: myst-parser; extra == "docs"
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
+Provides-Extra: pcode
+Requires-Dist: pypcode~=3.0; extra == "pcode"
+Provides-Extra: testing
+Requires-Dist: keystone-engine; extra == "testing"
+Requires-Dist: pypcode~=3.0; extra == "testing"
+Requires-Dist: pytest; extra == "testing"
+Requires-Dist: pytest-split; extra == "testing"
+Requires-Dist: pytest-xdist; extra == "testing"
+Requires-Dist: sqlalchemy; extra == "testing"
+
+# angr
+
+[![Latest Release](https://img.shields.io/pypi/v/angr.svg)](https://pypi.python.org/pypi/angr/)
+[![Python Version](https://img.shields.io/pypi/pyversions/angr)](https://pypi.python.org/pypi/angr/)
+[![PyPI Statistics](https://img.shields.io/pypi/dm/angr.svg)](https://pypistats.org/packages/angr)
+[![License](https://img.shields.io/github/license/angr/angr.svg)](https://github.com/angr/angr/blob/master/LICENSE)
+
+angr is a platform-agnostic binary analysis framework.
+It is brought to you by [the Computer Security Lab at UC Santa Barbara](https://seclab.cs.ucsb.edu), [SEFCOM at Arizona State University](https://sefcom.asu.edu), their associated CTF team, [Shellphish](https://shellphish.net), the open source community, and **[@rhelmot](https://github.com/rhelmot)**.
+
+## Project Links
+Homepage: https://angr.io
+
+Project repository: https://github.com/angr/angr
+
+Documentation: https://docs.angr.io
+
+API Documentation: https://api.angr.io/en/latest/
+
+## What is angr?
+
+angr is a suite of Python 3 libraries that let you load a binary and do a lot of cool things to it:
+
+- Disassembly and intermediate-representation lifting
+- Program instrumentation
+- Symbolic execution
+- Control-flow analysis
+- Data-dependency analysis
+- Value-set analysis (VSA)
+- Decompilation
+
+The most common angr operation is loading a binary: `p = angr.Project('/bin/bash')` If you do this in an enhanced REPL like IPython, you can use tab-autocomplete to browse the [top-level-accessible methods](https://docs.angr.io/docs/toplevel) and their docstrings.
+
+The short version of "how to install angr" is `mkvirtualenv --python=$(which python3) angr && python -m pip install angr`.
+
+## Example
+
+angr does a lot of binary analysis stuff.
+To get you started, here's a simple example of using symbolic execution to get a flag in a CTF challenge.
+
+```python
+import angr
+
+project = angr.Project("angr-doc/examples/defcamp_r100/r100", auto_load_libs=False)
+
+@project.hook(0x400844)
+def print_flag(state):
+    print("FLAG SHOULD BE:", state.posix.dumps(0))
+    project.terminate_execution()
+
+project.execute()
+```
+
+# Quick Start
+
+- [Install Instructions](https://docs.angr.io/introductory-errata/install)
+- Documentation as [HTML](https://docs.angr.io/) and sources in the angr [Github repository](https://github.com/angr/angr/tree/master/docs)
+- Dive right in: [top-level-accessible methods](https://docs.angr.io/core-concepts/toplevel)
+- [Examples using angr to solve CTF challenges](https://docs.angr.io/examples).
+- [API Reference](https://angr.io/api-doc/)
+- [awesome-angr repo](https://github.com/degrigis/awesome-angr)

angr-9.2.117/angr/__init__.py

@@ -0,0 +1,147 @@
+# pylint: disable=wildcard-import
+# pylint: disable=wrong-import-position
+
+__version__ = "9.2.117"
+
+if bytes is str:
+    raise Exception(
+        """
+
+=-=-=-=-=-=-=-=-=-=-=-=-=  WELCOME TO THE FUTURE!  =-=-=-=-=-=-=-=-=-=-=-=-=-=
+
+angr has transitioned to python 3. Due to the small size of the team behind it,
+we can't reasonably maintain compatibility between both python 2 and python 3.
+If you want to continue using the most recent version of angr (you definitely
+want that, trust us) you should upgrade to python 3. It's like getting your
+vaccinations. It hurts a little bit initially but in the end it's worth it.
+
+For more information, see here: https://docs.angr.io/appendix/migration
+
+Good luck!
+"""
+    )
+
+from .utils.formatting import setup_terminal
+
+setup_terminal()
+del setup_terminal
+
+# let's set up some bootstrap logging
+import logging
+
+logging.getLogger("angr").addHandler(logging.NullHandler())
+from .misc.loggers import Loggers
+
+loggers = Loggers()
+del Loggers
+del logging
+
+# this must happen first, prior to initializing analyses
+from .sim_procedure import SimProcedure
+from .procedures import SIM_PROCEDURES, SimProcedures, SIM_LIBRARIES, SIM_TYPE_COLLECTIONS
+
+from . import sim_options
+
+options = sim_options  # alias
+
+# enums
+from .state_plugins.inspect import BP_BEFORE, BP_AFTER, BP_BOTH, BP_IPDB, BP_IPYTHON
+
+# other stuff
+from .state_plugins.inspect import BP
+from .state_plugins import SimStatePlugin
+
+from .project import Project, load_shellcode
+from .errors import *
+from .blade import Blade
+from .simos import SimOS
+from .block import Block
+from .sim_manager import SimulationManager
+from .analyses import Analysis, register_analysis
+from . import analyses
+from . import knowledge_plugins
+from . import exploration_techniques
+from .exploration_techniques import ExplorationTechnique
+from . import sim_type as types
+from .state_hierarchy import StateHierarchy
+
+from .sim_state import SimState
+from . import engines
+from .calling_conventions import default_cc, DEFAULT_CC, SYSCALL_CC, PointerWrapper, SimCC
+from .storage.file import (
+    SimFileBase,
+    SimFile,
+    SimPackets,
+    SimFileStream,
+    SimPacketsStream,
+    SimFileDescriptor,
+    SimFileDescriptorDuplex,
+)
+from .state_plugins.filesystem import SimMount, SimHostFilesystem
+from .state_plugins.heap import SimHeapBrk, SimHeapPTMalloc, PTChunk
+from . import concretization_strategies
+from .distributed import Server
+from .knowledge_base import KnowledgeBase
+from .procedures.definitions import load_external_definitions
+
+# for compatibility reasons
+from . import sim_manager as manager
+
+# now that we have everything loaded, re-grab the list of loggers
+loggers.load_all_loggers()
+
+load_external_definitions()
+
+__all__ = (
+    "SimProcedure",
+    "SIM_PROCEDURES",
+    "SIM_LIBRARIES",
+    "SIM_TYPE_COLLECTIONS",
+    "sim_options",
+    "options",
+    "BP_BEFORE",
+    "BP_AFTER",
+    "BP_BOTH",
+    "BP_IPDB",
+    "BP_IPYTHON",
+    "BP",
+    "SimStatePlugin",
+    "Project",
+    "load_shellcode",
+    "Blade",
+    "SimOS",
+    "Block",
+    "SimulationManager",
+    "Analysis",
+    "register_analysis",
+    "analyses",
+    "knowledge_plugins",
+    "exploration_techniques",
+    "ExplorationTechnique",
+    "types",
+    "StateHierarchy",
+    "SimState",
+    "engines",
+    "DEFAULT_CC",
+    "default_cc",
+    "SYSCALL_CC",
+    "PointerWrapper",
+    "SimCC",
+    "SimFileBase",
+    "SimFile",
+    "SimPackets",
+    "SimFileStream",
+    "SimPacketsStream",
+    "SimFileDescriptor",
+    "SimFileDescriptorDuplex",
+    "SimMount",
+    "SimHostFilesystem",
+    "SimHeapBrk",
+    "SimHeapPTMalloc",
+    "PTChunk",
+    "concretization_strategies",
+    "Server",
+    "manager",
+    "SimProcedures",
+    "KnowledgeBase",
+)