Metadata-Version: 2.4
Name: evo_django_kits
Version: 0.1.2
Summary: Awesome evo_django_kits created by maycuatroi
Home-page: https://github.com/maycuatroi/evo-django-kits/
Author: maycuatroi
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: django
Requires-Dist: python-dotenv
Requires-Dist: loguru
Requires-Dist: django-filter
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: coverage; extra == "test"
Requires-Dist: flake8; extra == "test"
Requires-Dist: black; extra == "test"
Requires-Dist: isort; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: codecov; extra == "test"
Requires-Dist: mypy; extra == "test"
Requires-Dist: gitchangelog; extra == "test"
Requires-Dist: mkdocs; extra == "test"
Requires-Dist: GitPython; extra == "test"
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: summary

# evo_django_kits

[![CI](https://github.com/maycuatroi/evo-django-kits/actions/workflows/main.yml/badge.svg)](https://github.com/maycuatroi/evo-django-kits/actions/workflows/main.yml)
[![PyPI version](https://badge.fury.io/py/evo-django-kits.svg)](https://badge.fury.io/py/evo-django-kits)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/evo-django-kits)](https://pypi.org/project/evo-django-kits/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/evo-django-kits)](https://pypi.org/project/evo-django-kits/)
[![PyPI - License](https://img.shields.io/pypi/l/evo-django-kits)](https://pypi.org/project/evo-django-kits/)
[![GitHub issues](https://img.shields.io/github/issues/maycuatroi/evo-django-kits)](https://github.com/maycuatroi/evo-django-kits/issues)

Awesome evo_django_kits created by maycuatroi

## Install it from PyPI

```bash
pip install evo-django-kits
```

## Usage

```py
from evo_django_kits import BaseClass
from evo_django_kits import base_function

BaseClass().base_method()
base_function()
```

```bash
$ python -m evo_django_kits
#or
$ evo_django_kits
```

## Development

Read the [CONTRIBUTING.md](CONTRIBUTING.md) file.

# PNG Data Extractor

This repository contains tools to extract and analyze data from PNG files, with special focus on extracting C2PA (Content Authenticity Initiative) metadata that may be embedded in images generated by AI systems like ChatGPT.

## Background

PNG files contain structured data in "chunks". In addition to standard PNG chunks, some AI-generated images contain C2PA metadata which provides provenance information. This metadata is often stored in text chunks (tEXt or iTXt) or in JUMBF (JPEG Universal Metadata Box Format) containers.

## Tools Included

This repository includes several Python scripts for analyzing PNG files:

1. **png_data_extractor.py** - Extracts standard PNG chunks and basic metadata
2. **c2pa_extractor.py** - Focuses on extracting C2PA/CAI specific metadata
3. **extract_binary_data.py** - Analyzes binary patterns looking for JUMBF boxes and signature patterns
4. **analyze_png.py** - Combined tool that uses all three approaches

## Requirements

- Python 3.6+
- No external dependencies (only standard library modules)

## Usage

### Analyze a PNG file with all tools at once:

```bash
python analyze_png.py path/to/your/image.png
```

This will generate several JSON files with analysis results:

- `image.png_analysis.json` - Standard PNG chunk analysis
- `image.png_c2pa.json` - C2PA metadata analysis
- `image.png_binary.json` - Binary pattern analysis
- `image.png_combined.json` - Combined analysis

### Save output to a specific directory:

```bash
python analyze_png.py path/to/your/image.png -o output_directory
```

### Print only a summary without saving files:

```bash
python analyze_png.py path/to/your/image.png -s
```

### Using individual tools:

You can also use each tool separately:

```bash
python png_data_extractor.py path/to/your/image.png
python c2pa_extractor.py path/to/your/image.png
python extract_binary_data.py path/to/your/image.png
```

## What Data Is Extracted

These tools extract:

1. **Standard PNG Information**

   - All PNG chunks with their types, lengths, and data
   - Basic image information (dimensions, color type, bit depth)
   - Contents of text chunks

2. **C2PA/CAI Metadata**

   - Claim generators and assertions
   - AI model information
   - Digital source type
   - URNs and other identifier information
   - Signature data

3. **Binary Analysis**
   - JUMBF box structures
   - Content provenance signatures
   - ASCII strings related to C2PA/CAI

## Example Output

The summary output looks like:

```
============================================================
PNG ANALYSIS SUMMARY FOR: example.png
============================================================

File size: 12345 bytes

PNG Chunks: 8
  - IHDR: 1
  - tEXt: 2
  - iTXt: 1
  - IDAT: 3
  - IEND: 1

C2PA Data:
  - C2PA metadata entries: 3
  - Claims found: 1
  - Assertions found: 2
  - AI Generated: Yes
  - AI Model: ChatGPT

Binary Analysis:
  - JUMBF boxes found: 5
  - C2PA signatures found: 3
  - Relevant strings found: 12

============================================================
For detailed information, check the generated JSON files.
============================================================
```

## Understanding the Results

For detailed analysis, check the generated JSON files which contain all extracted information. The C2PA/CAI metadata can help verify:

- If an image was generated by AI
- Which AI model generated it
- When it was created
- Other provenance and authenticity information

## License

MIT
