Metadata-Version: 2.4
Name: demand-tools
Version: 0.2.8
Summary: Набор функций для работы с датафреймами и загрузки данных
Author: Dmitry Romanov
License: MIT
Keywords: pandas,data-processing
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: pandas>=2.0.0
Requires-Dist: tqdm>=4.66.0
Requires-Dist: requests>=2.32.0
Provides-Extra: dev
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: isort>=5.13.0; extra == "dev"
Requires-Dist: radon>=7.0.0; extra == "dev"

# dp_tools

# Установка

```bash
pip install demand-tools
```
# Набор функций
**def report_nan**

    
    Формирует отчёт по количеству пропущенных и «пустых» значений в DataFrame.

    Для каждой колонки подсчитывается:
      - `na_count`: количество значений, распознанных как NA/NaN/None;
      - `blank_count`: количество ячеек, содержащих пустую строку, строку из пробелов
        или маркер '(blank)'.

    Возвращаемый DataFrame позволяет быстро оценить качество данных перед дальнейшей
    обработкой или загрузкой в хранилище (например, в ClickHouse), а также может
    использоваться как часть валидации при пайплайне обработки Excel‑файлов.

    Параметры
    ---------
    df : pd.DataFrame
        Исходный DataFrame, по которому требуется сформировать отчёт.

    Возвращает
    ----------
    pd.DataFrame
        Таблица с колонками:
          - ``column_name``: имя колонки исходного DataFrame;
          - ``na_count``: количество NA‑значений в колонке;
          - ``blank_count``: количество «пустых» значений (пустая строка, пробелы, '(blank)').

        Строки результата соответствуют колонкам исходного DataFrame в порядке их следования.

    Примечания
    ----------
    - Логика определения «пустого» значения учитывает несколько распространённых случаев:
        пустая строка ``''``, строка, состоящая только из пробелов, и явный маркер ``'(blank)'``.
    - Для нечисловых колонок проверка на пробелы выполняется через строковое представление.
    

