Metadata-Version: 2.1
Name: wh1tem0cha
Version: 0.3
Summary: Python Module for Parsing & Reverse Engineering Mach-O Executables.
Home-page: https://github.com/CYB3RMX/Wh1teM0cha
Author: CYB3RMX
Author-email: cyb3rmx0@gmail.com
Project-URL: Bug Tracker, https://github.com/CYB3RMX/Wh1teM0cha/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE

# Wh1teM0cha
<img src="https://img.shields.io/badge/-Python-black?style=for-the-badge&logo=python&logoColor=white">
<p align="center">
<img src="https://github.com/CYB3RMX/Wh1teM0cha/assets/61325408/322d3083-cb78-4630-ae71-1ae33f5dc543" width="400" style="margin=auto;">
  <br>
<br><b>Python Module for Parsing & Reverse Engineering Mach-O Executables.</b><br>
</p>
<br>

# Installation
- <i>You can simply run this command.</i>
```bash
pip3 install wh1tem0cha
```

# How to Use
> [!NOTE]
> This section contains brief information about the module.
> For more information please visit <a href="https://github.com/CYB3RMX/Wh1teM0cha/blob/main/docs/USECASES.md">USECASES.md</a>

## General Information About Target Binary
- <i>Description</i>: With this feature you can get general information from target MACH-O binary.<br>
```python
from wh1tem0cha import Wh1teM0cha

wm = Wh1teM0cha("target_binary_file")
wm.get_binary_info()
```
![wm1](https://github.com/CYB3RMX/Wh1teM0cha/assets/42123683/42cb05f0-22d4-47fb-bf4c-ba8b1c3a36a1)

## List Segments
- <i>Description</i>: This method is for parsing and listing segments.<br>
```python
from wh1tem0cha import Wh1teM0cha

wm = Wh1teM0cha("target_binary_file")
wm.get_segments()
```
![wm2](https://github.com/CYB3RMX/Wh1teM0cha/assets/42123683/065dd2ca-30be-4d6d-bdfb-8a55d6f64690)

### Get Target Segment Information
- <i>Description</i>: With this method you can get additional information about the target segment.<br>
```python
from wh1tem0cha import Wh1teM0cha

wm = Wh1teM0cha("target_binary_file")
wm.segment_info("__TEXT")
```
![wm3](https://github.com/CYB3RMX/Wh1teM0cha/assets/42123683/c6022cde-975f-4f95-b813-9daf7bccb37c)

## List Sections
- <i>Description</i>: This method is for parsing and listing sections.<br>
```python
from wh1tem0cha import Wh1teM0cha

wm = Wh1teM0cha("target_binary_file")
wm.get_sections()
```
![wm4](https://github.com/CYB3RMX/Wh1teM0cha/assets/42123683/474f9105-bfd4-40a4-80d9-48e55246194d)

### Get Target Section Information
- <i>Description</i>: With this method you can get additional information about the target section.<br>
```python
from wh1tem0cha import Wh1teM0cha

wm = Wh1teM0cha("target_binary_file")
wm.section_info("__text")
```
![wm5](https://github.com/CYB3RMX/Wh1teM0cha/assets/42123683/15555c54-bee2-4aa8-b649-5883f8148790)

