Metadata-Version: 2.1
Name: pyskim
Version: 0.1.5
Summary: Quickly create summary statistics for a given dataframe.
Home-page: https://github.com/kpj/pyskim
License: MIT
Author: kpj
Author-email: kim.philipp.jablonski@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: click (>=8.1.7,<9.0.0)
Requires-Dist: ipython (>=8.21.0,<9.0.0)
Requires-Dist: numpy (>=1.26.4,<2.0.0)
Requires-Dist: pandas (>=2.2.0,<3.0.0)
Requires-Dist: scipy (>=1.12.0,<2.0.0)
Requires-Dist: tabulate (>=0.9.0,<0.10.0)
Project-URL: Repository, https://github.com/kpj/pyskim
Description-Content-Type: text/markdown

# pyskim

[![PyPI](https://img.shields.io/pypi/v/pyskim.svg?style=flat)](https://pypi.python.org/pypi/pyskim)
[![Tests](https://github.com/kpj/pyskim/actions/workflows/main.yaml/badge.svg)](https://github.com/kpj/pyskim/actions/workflows/main.yaml)

Quickly create summary statistics for a given dataframe.

This package aspires to be as awesome as [skimr](https://github.com/ropensci/skimr).


## Installation

```bash
$ pip install pyskim
```

## Usage

### Commandline tool


`pyskim` can be used from the commandline:

```bash
$ pyskim iris.csv
── Data Summary ────────────────────────────────────────────────────────────────────────────────────
type                 value
-----------------  -------
Number of rows         150
Number of columns        5
──────────────────────────────────────────────────
Column type frequency:
           Count
-------  -------
Float64        4
string         1

── Variable type: number ───────────────────────────────────────────────────────────────────────────
    name            na_count    mean     sd    p0    p25    p50    p75    p100  hist
--  ------------  ----------  ------  -----  ----  -----  -----  -----  ------  ----------
 0  sepal_length           0    5.84  0.828   4.3    5.1   5.8     6.4     7.9  ▂▆▃▇▄▇▅▁▁▁
 1  sepal_width            0    3.06  0.436   2      2.8   3       3.3     4.4  ▁▁▄▅▇▆▂▂▁▁
 2  petal_length           0    3.76  1.77    1      1.6   4.35    5.1     6.9  ▇▃▁▁▂▅▆▄▃▁
 3  petal_width            0    1.2   0.762   0.1    0.3   1.3     1.8     2.5  ▇▂▁▂▂▆▁▄▂▃

── Variable type: string ───────────────────────────────────────────────────────────────────────────
    name       na_count    n_unique  top_counts
--  -------  ----------  ----------  -----------------------------------------
 0  species           0           3  setosa: 50, versicolor: 50, virginica: 50
```

Full overview:

```bash
$ pyskim --help
Usage: pyskim [OPTIONS] <file>

  Quickly create summary statistics for a given dataframe.

Options:
  -d, --delimiter TEXT   Delimiter of file.
  -i, --interactive      Open prompt with dataframe as `df` after displaying
                         summary.
  --no-dtype-conversion  Skip automatic dtype conversion.
  --groupby TEXT         Group dataframe by this/these variable(s).
  --help                 Show this message and exit.
```

### Python API

Alternatively, it is possible to use it in code:

```python
>>> from pyskim import skim
>>> from seaborn import load_dataset

>>> iris = load_dataset('iris')
>>> skim(iris)
# ── Data Summary ────────────────────────────────────────────────────────────────────────────────────
# type                 value
# -----------------  -------
# Number of rows         150
# Number of columns        5
# ──────────────────────────────────────────────────
# Column type frequency:
#            Count
# -------  -------
# float64        4
# string         1
#
# ── Variable type: number ───────────────────────────────────────────────────────────────────────────
#     name            na_count    mean     sd    p0    p25    p50    p75    p100  hist
# --  ------------  ----------  ------  -----  ----  -----  -----  -----  ------  ----------
#  0  sepal_length           0    5.84  0.828   4.3    5.1   5.8     6.4     7.9  ▂▆▃▇▄▇▅▁▁▁
#  1  sepal_width            0    3.06  0.436   2      2.8   3       3.3     4.4  ▁▁▄▅▇▆▂▂▁▁
#  2  petal_length           0    3.76  1.77    1      1.6   4.35    5.1     6.9  ▇▃▁▁▂▅▆▄▃▁
#  3  petal_width            0    1.2   0.762   0.1    0.3   1.3     1.8     2.5  ▇▂▁▂▂▆▁▄▂▃
#
# ── Variable type: string ───────────────────────────────────────────────────────────────────────────
#     name               na_count    n_unique  top_counts
# --  ---------------  ----------  ----------  -----------------------------------------
#  0          species           0           3  versicolor: 50, setosa: 50, virginica: 50
```

