Metadata-Version: 2.1
Name: oricat
Version: 0.10.0
Summary: Categorise images by orientation
Home-page: https://github.com/cliffano/oricat
License: MIT
Keywords: oricat,images,categorise,orientation
Author: Cliffano Subagio
Author-email: cliffano@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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-Dist: PyYAML (>=6.0.1,<7.0.0)
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: conflog (>=1.5.1,<2.0.0)
Requires-Dist: pillow (>=10.3.0,<11.0.0)
Requires-Dist: pyyaml-include (>=1.3.1,<2.0.0)
Project-URL: Documentation, https://github.com/cliffano/oricat
Project-URL: Repository, https://github.com/cliffano/oricat
Description-Content-Type: text/markdown

<img align="right" src="https://raw.github.com/cliffano/oricat/main/avatar.jpg" alt="Avatar"/>

[![Build Status](https://github.com/cliffano/oricat/workflows/CI/badge.svg)](https://github.com/cliffano/oricat/actions?query=workflow%3ACI)
[![Security Status](https://snyk.io/test/github/cliffano/oricat/badge.svg)](https://snyk.io/test/github/cliffano/oricat)
[![Published Version](https://img.shields.io/pypi/v/oricat.svg)](https://pypi.python.org/pypi/oricat)
<br/>

Oricat
------

Oricat is a Python CLI for categorising image files by orientation.

Given a folder of images, Oricat will organise those files by orientation into subfolders `landscape`, `portrait`, and `square`.

Installation
------------

    pip3 install oricat

Usage
-----

Categorise images in a folder:

    oricat --input-dir some/input/folder/ --output-dir some/output/folder/

The categorised images will then be moved to:

* `some/output/folder/landscape` for images having landscape orientation
* `some/output/folder/portrait` for images having portrait orientation
* `some/output/folder/square` for images having square orientation

Colophon
--------

[Developer's Guide](https://cliffano.github.io/developers_guide.html#python)

Build reports:

* [Lint report](https://cliffano.github.io/oricat/lint/pylint/index.html)
* [Code complexity report](https://cliffano.github.io/oricat/complexity/wily/index.html)
* [Unit tests report](https://cliffano.github.io/oricat/test/pytest/index.html)
* [Test coverage report](https://cliffano.github.io/oricat/coverage/coverage/index.html)
* [Integration tests report](https://cliffano.github.io/oricat/test-integration/pytest/index.html)
* [API Documentation](https://cliffano.github.io/oricat/doc/sphinx/index.html)

