Metadata-Version: 2.1
Name: chinaski
Version: 1.0.2
Summary: Detect email addresses in files
Author: w0rmr1d3r
License: GPLv3
Project-URL: Homepage, https://github.com/w0rmr1d3r/chinaski
Project-URL: Repository, https://github.com/w0rmr1d3r/chinaski
Project-URL: Bug Tracker, https://github.com/w0rmr1d3r/chinaski/issues
Project-URL: Documentation, https://github.com/w0rmr1d3r/chinaski
Project-URL: Changelog, https://github.com/w0rmr1d3r/chinaski/releases
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
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.9.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1.3
Provides-Extra: dev
Requires-Dist: autoflake>=2.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: coverage>=7.0.0; extra == "dev"
Requires-Dist: docformatter>=1.5.1; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: pip-tools>=6.12.0; extra == "dev"
Requires-Dist: pylint>=2.16.0; extra == "dev"
Requires-Dist: pytest>=7.0.0; extra == "dev"

# chinaski

Detect email addresses in files.
A tribute to the novel [Post Office](https://en.wikipedia.org/wiki/Post_Office_(novel)) from Charles Bukowski.

[![PyPI](https://img.shields.io/pypi/v/chinaski)](https://pypi.org/project/chinaski/)
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/w0rmr1d3r/chinaski)](https://github.com/w0rmr1d3r/chinaski/releases)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/chinaski)
[![PyPi downloads](https://img.shields.io/pypi/dm/chinaski?label=PyPi%20downloads)](https://pypistats.org/packages/chinaski)

## Installation

Use the package manager [pip](https://pip.pypa.io/en/stable/) to install chinaski.

```bash
pip install chinaski
```

## Usage

### As CLI

```text
Usage: python -m chinaski [OPTIONS] PATH_TO_FILE_OR_DIR

  Detect emails addresses in files.

  PATH_TO_FILE_OR_DIR: Path to single file or directory to scan.

Options:
  --help  Show this message and exit.
```

Example:

```bash
# Detect in only 1 file
python -m chinaski ./file.txt

# Detect in a directory
python -m chinaski path/to/dir
```

### Inside your code

```python
from chinaski.henry import core

if __name__ == '__main__':
    core("file.txt")
```

## Contributing

Pull requests are welcome. For major changes, please open an issue first
to discuss what you would like to change.

Please make sure to update tests as appropriate.

## License

[GPLv3](LICENSE)
