Metadata-Version: 2.4
Name: ydata-profiling-multilingual
Version: 1.0.8
Summary: forked from ydataai/ydata-profiling and modify the code to support international multilingual functionality
Home-page: https://github.com/landonzeng/ydata-profiling-multilingual
Author: Landon Zeng
Author-email: YData Labs Inc <opensource@ydata.ai>, landonzeng <landonzeng@qq.com>
License: The MIT License (MIT)
        
        Copyright (c) 2016 Jos Polfliet, 2019-2021 Simon Brugman, 2022-Present YData Labs Inc
        
        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: Homepage, https://github.com/landonzeng/ydata-profiling-multilingual
Project-URL: Repository, https://github.com/landonzeng/ydata-profiling-multilingual
Project-URL: Original Repository, https://github.com/ydataai/ydata-profiling
Keywords: pandas,data-science,data-analysis,python,jupyter,ipython,i18n,multilingual,ydata-profiling-fork
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Healthcare Industry
Classifier: Topic :: Scientific/Engineering
Classifier: Framework :: IPython
Classifier: Programming Language :: Python :: 3
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
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: scipy<1.16,>=1.4.1
Requires-Dist: pandas!=1.4.0,<3.0,>1.1
Requires-Dist: matplotlib<=3.10,>=3.5
Requires-Dist: pydantic>=2
Requires-Dist: PyYAML<6.1,>=5.0.0
Requires-Dist: jinja2<3.2,>=2.11.1
Requires-Dist: visions[type_image_path]<0.8.2,>=0.7.5
Requires-Dist: numpy<2.2,>=1.16.0
Requires-Dist: htmlmin==0.1.12
Requires-Dist: phik<0.13,>=0.11.1
Requires-Dist: requests<3,>=2.24.0
Requires-Dist: tqdm<5,>=4.48.2
Requires-Dist: seaborn<0.14,>=0.10.1
Requires-Dist: multimethod<2,>=1.4
Requires-Dist: statsmodels<1,>=0.13.2
Requires-Dist: typeguard<5,>=3
Requires-Dist: imagehash==4.3.1
Requires-Dist: wordcloud>=1.9.3
Requires-Dist: dacite>=1.8
Requires-Dist: numba<=0.61,>=0.56.0
Requires-Dist: click>=7.0
Provides-Extra: dev
Requires-Dist: black>=20.8b1; extra == "dev"
Requires-Dist: isort>=5.0.7; extra == "dev"
Requires-Dist: pre-commit>=2.8.2; extra == "dev"
Requires-Dist: virtualenv>=20.0.33; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Requires-Dist: myst-parser>=0.18.1; extra == "dev"
Requires-Dist: sphinx_rtd_theme>=0.4.3; extra == "dev"
Requires-Dist: sphinx-autodoc-typehints>=1.10.3; extra == "dev"
Requires-Dist: sphinx-multiversion>=0.2.3; extra == "dev"
Requires-Dist: autodoc_pydantic; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs<1.7.0,>=1.6.0; extra == "docs"
Requires-Dist: mkdocs-material<10.0.0,>=9.0.12; extra == "docs"
Requires-Dist: mkdocs-material-extensions<2.0.0,>=1.1.1; extra == "docs"
Requires-Dist: mkdocs-table-reader-plugin<=2.2.0; extra == "docs"
Requires-Dist: mike<2.2.0,>=2.1.1; extra == "docs"
Requires-Dist: mkdocstrings[python]<1.0.0,>=0.20.0; extra == "docs"
Requires-Dist: mkdocs-badges; extra == "docs"
Provides-Extra: notebook
Requires-Dist: jupyter>=1.0.0; extra == "notebook"
Requires-Dist: ipywidgets>=7.5.1; extra == "notebook"
Provides-Extra: spark
Requires-Dist: pyspark>=3.0; extra == "spark"
Requires-Dist: pyarrow>=4.0.0; extra == "spark"
Requires-Dist: pandas>1.1; extra == "spark"
Requires-Dist: numpy>=1.16.0; extra == "spark"
Requires-Dist: visions[type_image_path]<0.7.7,>=0.7.5; extra == "spark"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: coverage<8,>=6.5; extra == "test"
Requires-Dist: codecov; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: nbval; extra == "test"
Requires-Dist: pyarrow; extra == "test"
Requires-Dist: twine>=3.1.1; extra == "test"
Requires-Dist: kaggle; extra == "test"
Provides-Extra: unicode
Requires-Dist: tangled-up-in-unicode==0.2.0; extra == "unicode"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# YData Profiling Multilingual
 
> **Note**: This is a fork of [ydataai/ydata-profiling](https://github.com/ydataai/ydata-profiling) with added international multilingual functionality. I only implemented multilingual language support - all core profiling features remain unchanged from the original project.

[![Build Status](https://github.com/ydataai/pandas-profiling/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/ydataai/pandas-profiling/actions/workflows/tests.yml)
[![PyPI download month](https://img.shields.io/pypi/dm/ydata-profiling.svg)](https://pypi.python.org/pypi/ydata-profiling/)
[![](https://pepy.tech/badge/pandas-profiling)](https://pypi.org/project/ydata-profiling/)
[![Code Coverage](https://codecov.io/gh/ydataai/pandas-profiling/branch/master/graph/badge.svg?token=gMptB4YUnF)](https://codecov.io/gh/ydataai/pandas-profiling)
[![Release Version](https://img.shields.io/github/release/ydataai/pandas-profiling.svg)](https://github.com/ydataai/pandas-profiling/releases)
[![Python Version](https://img.shields.io/pypi/pyversions/ydata-profiling)](https://pypi.org/project/ydata-profiling/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)
 
## 🌍 What I Added
 
This fork adds comprehensive internationalization (i18n) support to the original ydata-profiling:
 
- **🔤 Multi-language Support**: Built-in English, Chinese, and framework for custom languages
- **🛠️ Custom Translations**: Users can create and load their own translation files
- **📊 Localized Reports**: All UI elements, labels, and messages are translatable
- **⚙️ Translation Tools**: Command-line utilities for creating and validating translations
- **🔄 100% Backward Compatibility**: Works exactly like original ydata-profiling
 
## 🙏 Credits
 
- **Original Project**: [ydata-profiling](https://github.com/ydataai/ydata-profiling) by YData team
- **Multilingual Enhancement**: Added by [Landon Zeng](https://github.com/landonzeng)
- **What I Did**: Only implemented i18n functionality - all core features are from the original project
 
## 🚀 Quick Start
 
### Installation
 
```bash
pip install ydata-profiling-multilingual
```

### Basic Usage (Same as Original + Language Support)

```python
import pandas as pd
from ydata_profiling import ProfileReport
 
# Create sample data
df = pd.DataFrame({
    'numeric': [1, 2, 3, 4, 5],
    'categorical': ['A', 'B', 'A', 'C', 'B'],
})
 
# Generate report in Chinese (NEW FEATURE)
profile = ProfileReport(df, title="数据分析报告", locale='zh')
profile.to_file("chinese_report.html")
 
# Generate report in English (same as original)
profile = ProfileReport(df, title="Data Analysis Report")
profile.to_file("english_report.html")
```
## 🌐 Supported Languages
- English (en) - Default
- Chinese Simplified (zh) - 简体中文
- Custom Languages - Add your own!

## 🔧 New Multilingual Features
### Export Translation Template

```bash
# Use new command line tool
ydata-profiling-translate create-template -l en -o ./my_template.json
```
### Create Custom Translation
```python
from ydata_profiling.i18n import load_translation_file, set_locale
 
# Load your custom translation file
load_translation_file('my_french.json', 'fr')
 
# Generate French report
profile = ProfileReport(df, title="Rapport d'Analyse", locale='fr')
```

### Load Translation Directory
```python
from ydata_profiling.i18n import add_translation_directory
 
# Load all translations from a directory
add_translation_directory('./my_translations/')
```

## 📚 Examples
Check the examples/ folder for complete workflows:
```python
# Run the complete example
python examples/translation_workflow_example.py
```

## 🔄 Migration from Original
If you're using the original ydata-profiling, migration is seamless:
```python
# Your existing code works unchanged
from ydata_profiling import ProfileReport
profile = ProfileReport(df)  # Still works!
 
# Just add locale for multilingual support
profile = ProfileReport(df, locale='zh')  # Now with Chinese!
```

## 🤝 Contributing
This project focuses only on multilingual functionality. For core profiling features:
- Core Issues: Please report to original ydata-profiling
- Translation Issues: Report here at ydata-profiling-multilingual

### Adding New Languages
1. Export English template: ydata-profiling-translate create-template
2. Translate the JSON file
3. Submit PR with your translation

## 📄 License
Same as original project: MIT License

## 🔗 Links
- Original Project: [ydata-profiling](https://github.com/ydataai/ydata-profiling)
- This Fork: [ydata-profiling-multilingual](https://github.com/landonzeng/ydata-profiling-multilingual)
- My GitHub: [landonzeng](https://github.com/landonzeng)

## ⚠️ Disclaimer
I am not affiliated with YData. This is an independent fork that adds multilingual support. All core profiling algorithms and features are from the original ydata-profiling project. I only implemented the internationalization layer.

## 🌟 If this multilingual version helps you, please star both repositories:
- ⭐ Original ydata-profiling
- ⭐ This multilingual fork
