automatic import of python-autocrop

3 files changed, 563 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..47d49e1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/autocrop-1.3.0.tar.gz
diff --git a/python-autocrop.spec b/python-autocrop.spec
new file mode 100644
index 0000000..8010a06
--- /dev/null
+++ b/python-autocrop.spec
@@ -0,0 +1,561 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-autocrop
+Version:	1.3.0
+Release:	1
+Summary:	Automatically crops faces from batches of pictures
+License:	BSD 2-Clause
+URL:		https://github.com/leblancfg/autocrop
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/63/26/2398b55ee12628b7b80f25fcf583de528b1ff948e9387119074b4a47476f/autocrop-1.3.0.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-numpy
+Requires:	python3-opencv-python-headless
+Requires:	python3-Pillow
+
+%description
+
+# autocrop
+
+[![CI](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/leblancfg/autocrop/branch/master/graph/badge.svg)](https://codecov.io/gh/leblancfg/autocrop) [![Documentation](https://img.shields.io/badge/docs-passing-success.svg)](https://leblancfg.com/autocrop) [![PyPI version](https://badge.fury.io/py/autocrop.svg)](https://badge.fury.io/py/autocrop) [![Downloads](https://pepy.tech/badge/autocrop)](https://pepy.tech/project/autocrop)
+
+<p align="center"><img title="obama_crop" src="https://cloud.githubusercontent.com/assets/15659410/10975709/3e38de48-83b6-11e5-8885-d95da758ca17.png"></p>
+
+Perfect for profile picture processing for your website or batch work for ID cards, autocrop will output images centered around the biggest face detected.
+
+# Installation
+Simple!
+
+~~~sh
+pip install autocrop
+~~~
+
+# Use
+Autocrop can be used [from the command line](#from-the-command-line) or directly [from Python API](#from-python).
+
+## From Python
+Import the `Cropper` class, set some parameters (optional), and start cropping.
+
+The `crop` method accepts filepaths or `np.ndarray`, and returns Numpy arrays. These are easily handled with [PIL](https://pillow.readthedocs.io/) or [Matplotlib](https://matplotlib.org/).
+
+~~~python
+from PIL import Image
+from autocrop import Cropper
+
+cropper = Cropper()
+
+# Get a Numpy array of the cropped image
+cropped_array = cropper.crop('portrait.png')
+
+# Save the cropped image with PIL if a face was detected:
+if cropped_array:
+    cropped_image = Image.fromarray(cropped_array)
+    cropped_image.save('cropped.png')
+~~~
+
+Further examples and use cases are found in the [accompanying Jupyter Notebook](https://github.com/leblancfg/autocrop/blob/master/examples/visual_tests.ipynb).
+
+## From the command line
+
+	usage: [-h] [-o OUTPUT] [-i INPUT] [-w WIDTH] [-H HEIGHT] [-e EXTENSION] [-v]
+
+	Automatically crops faces from batches of pictures
+
+	optional arguments:
+	  -h, --help
+	  		Show this help message and exit
+	  -o, --output, -p, --path
+			Folder where cropped images will be placed.
+			Default: current working directory
+	  -r, --reject
+			Folder where images without detected faces will be placed.
+			Default: same as output directory
+	  -i, --input
+			Folder where images to crop are located.
+			Default: current working directory
+	  -w, --width
+			Width of cropped files in px. Default=500
+	  -H, --height
+			Height of cropped files in px. Default=500
+	  --facePercent
+	  		Zoom factor. Percentage of face height to image height.
+	  -e, --extension
+	  		Enter the image extension which to save at output.
+	  		Default: Your current image extension
+	  -v, --version
+	  		Show program's version number and exit
+
+### Examples
+
+* Crop every image in the `pics` folder, resize them to 400 px squares, and output them in the `crop` directory:
+	- `autocrop -i pics -o crop -w 400 -H 400`.
+	- Images where a face can't be detected will be left in `crop`.
+* Same as above, but output the images with undetected faces to the `reject` directory:
+	- `autocrop -i pics -o crop -r reject -w 400 -H 400`.
+* Same as above but the image extension will be `png`:
+	- `autocrop -i pics -o crop -w 400 -H 400 -e png`
+	
+If no output folder is added, asks for confirmation and destructively crops images in-place.
+
+### Detecting faces from video files
+You can use autocrop to detect faces in frames extracted from a video. A great way to [perform the frame extraction step is with `ffmpeg`](https://ffmpeg.org/download.html):
+
+```sh
+mkdir frames faces
+
+# Extract one frame per second
+ffmpeg -i input.mp4 -filter:v fps=fps=1/60 frames/ffmpeg_%0d.bmp
+
+# Crop faces as jpg
+autocrop -i frames -o faces -e jpg
+```
+
+
+# Supported file types
+
+The following file types are supported:
+
+- EPS files (`.eps`)
+- GIF files (`.gif`) (only the first frame of an animated GIF is used)
+- JPEG 2000 files (`.j2k`, `.j2p`, `.jp2`, `.jpx`)
+- JPEG files (`.jpeg`, `.jpg`, `.jpe`)
+- LabEye IM files (`.im`)
+- macOS ICNS files (`.icns`)
+- Microsoft Paint bitmap files (`.msp`)
+- PCX files (`.pcx`)
+- Portable Network Graphics (`.png`)
+- Portable Pixmap files (`.pbm`, `.pgm`, `.ppm`)
+- SGI files (`.sgi`)
+- SPIDER files (`.spi`)
+- TGA files (`.tga`)
+- TIFF files (`.tif`, `.tiff`)
+- WebP (`.webp`)
+- Windows bitmap files (`.bmp`, `.dib`)
+- Windows ICO files (`.ico`)
+- X bitmap files (`.xbm`)
+
+# Misc
+### Installing directly
+In some cases, you may wish the package directly, instead of through [PyPI](https://pypi.python.org/pypi):
+
+~~~
+cd ~
+git clone https://github.com/leblancfg/autocrop
+cd autocrop
+pip install .
+~~~
+
+### conda
+Development of a `conda-forge` package for the [Anaconda Python distribution](https://www.anaconda.com/download/) is currently stalled due to the complexity of setting up the workflow with OpenCV. Please leave feedback on [issue #7](https://github.com/leblancfg/autocrop/issues/7) to see past attempts if you are insterested in helping out!
+
+### Requirements
+Best practice for your projects is of course to [use virtual environments](http://docs.python-guide.org/en/latest/dev/virtualenvs/). At the very least, you will need to [have pip installed](https://pip.pypa.io/en/stable/installing/).
+
+Autocrop is [currently being tested on](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml):
+
+* Python 3.7 to 3.10
+* OS:
+    - Linux
+    - macOS
+    - Windows
+
+# More Info
+Check out:
+
+* http://docs.opencv.org/master/d7/d8b/tutorial_py_face_detection.html#gsc.tab=0
+* http://docs.opencv.org/master/d5/daf/tutorial_py_histogram_equalization.html#gsc.tab=0
+
+Adapted from:
+
+* http://photo.stackexchange.com/questions/60411/how-can-i-batch-crop-based-on-face-location
+
+### Contributing
+
+Although autocrop is essentially a CLI wrapper around a single OpenCV function, it is actively developed. It has active users throughout the world.
+
+If you would like to contribute, please consult the [contribution docs](CONTRIBUTING.md).
+
+
+
+
+%package -n python3-autocrop
+Summary:	Automatically crops faces from batches of pictures
+Provides:	python-autocrop
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-autocrop
+
+# autocrop
+
+[![CI](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/leblancfg/autocrop/branch/master/graph/badge.svg)](https://codecov.io/gh/leblancfg/autocrop) [![Documentation](https://img.shields.io/badge/docs-passing-success.svg)](https://leblancfg.com/autocrop) [![PyPI version](https://badge.fury.io/py/autocrop.svg)](https://badge.fury.io/py/autocrop) [![Downloads](https://pepy.tech/badge/autocrop)](https://pepy.tech/project/autocrop)
+
+<p align="center"><img title="obama_crop" src="https://cloud.githubusercontent.com/assets/15659410/10975709/3e38de48-83b6-11e5-8885-d95da758ca17.png"></p>
+
+Perfect for profile picture processing for your website or batch work for ID cards, autocrop will output images centered around the biggest face detected.
+
+# Installation
+Simple!
+
+~~~sh
+pip install autocrop
+~~~
+
+# Use
+Autocrop can be used [from the command line](#from-the-command-line) or directly [from Python API](#from-python).
+
+## From Python
+Import the `Cropper` class, set some parameters (optional), and start cropping.
+
+The `crop` method accepts filepaths or `np.ndarray`, and returns Numpy arrays. These are easily handled with [PIL](https://pillow.readthedocs.io/) or [Matplotlib](https://matplotlib.org/).
+
+~~~python
+from PIL import Image
+from autocrop import Cropper
+
+cropper = Cropper()
+
+# Get a Numpy array of the cropped image
+cropped_array = cropper.crop('portrait.png')
+
+# Save the cropped image with PIL if a face was detected:
+if cropped_array:
+    cropped_image = Image.fromarray(cropped_array)
+    cropped_image.save('cropped.png')
+~~~
+
+Further examples and use cases are found in the [accompanying Jupyter Notebook](https://github.com/leblancfg/autocrop/blob/master/examples/visual_tests.ipynb).
+
+## From the command line
+
+	usage: [-h] [-o OUTPUT] [-i INPUT] [-w WIDTH] [-H HEIGHT] [-e EXTENSION] [-v]
+
+	Automatically crops faces from batches of pictures
+
+	optional arguments:
+	  -h, --help
+	  		Show this help message and exit
+	  -o, --output, -p, --path
+			Folder where cropped images will be placed.
+			Default: current working directory
+	  -r, --reject
+			Folder where images without detected faces will be placed.
+			Default: same as output directory
+	  -i, --input
+			Folder where images to crop are located.
+			Default: current working directory
+	  -w, --width
+			Width of cropped files in px. Default=500
+	  -H, --height
+			Height of cropped files in px. Default=500
+	  --facePercent
+	  		Zoom factor. Percentage of face height to image height.
+	  -e, --extension
+	  		Enter the image extension which to save at output.
+	  		Default: Your current image extension
+	  -v, --version
+	  		Show program's version number and exit
+
+### Examples
+
+* Crop every image in the `pics` folder, resize them to 400 px squares, and output them in the `crop` directory:
+	- `autocrop -i pics -o crop -w 400 -H 400`.
+	- Images where a face can't be detected will be left in `crop`.
+* Same as above, but output the images with undetected faces to the `reject` directory:
+	- `autocrop -i pics -o crop -r reject -w 400 -H 400`.
+* Same as above but the image extension will be `png`:
+	- `autocrop -i pics -o crop -w 400 -H 400 -e png`
+	
+If no output folder is added, asks for confirmation and destructively crops images in-place.
+
+### Detecting faces from video files
+You can use autocrop to detect faces in frames extracted from a video. A great way to [perform the frame extraction step is with `ffmpeg`](https://ffmpeg.org/download.html):
+
+```sh
+mkdir frames faces
+
+# Extract one frame per second
+ffmpeg -i input.mp4 -filter:v fps=fps=1/60 frames/ffmpeg_%0d.bmp
+
+# Crop faces as jpg
+autocrop -i frames -o faces -e jpg
+```
+
+
+# Supported file types
+
+The following file types are supported:
+
+- EPS files (`.eps`)
+- GIF files (`.gif`) (only the first frame of an animated GIF is used)
+- JPEG 2000 files (`.j2k`, `.j2p`, `.jp2`, `.jpx`)
+- JPEG files (`.jpeg`, `.jpg`, `.jpe`)
+- LabEye IM files (`.im`)
+- macOS ICNS files (`.icns`)
+- Microsoft Paint bitmap files (`.msp`)
+- PCX files (`.pcx`)
+- Portable Network Graphics (`.png`)
+- Portable Pixmap files (`.pbm`, `.pgm`, `.ppm`)
+- SGI files (`.sgi`)
+- SPIDER files (`.spi`)
+- TGA files (`.tga`)
+- TIFF files (`.tif`, `.tiff`)
+- WebP (`.webp`)
+- Windows bitmap files (`.bmp`, `.dib`)
+- Windows ICO files (`.ico`)
+- X bitmap files (`.xbm`)
+
+# Misc
+### Installing directly
+In some cases, you may wish the package directly, instead of through [PyPI](https://pypi.python.org/pypi):
+
+~~~
+cd ~
+git clone https://github.com/leblancfg/autocrop
+cd autocrop
+pip install .
+~~~
+
+### conda
+Development of a `conda-forge` package for the [Anaconda Python distribution](https://www.anaconda.com/download/) is currently stalled due to the complexity of setting up the workflow with OpenCV. Please leave feedback on [issue #7](https://github.com/leblancfg/autocrop/issues/7) to see past attempts if you are insterested in helping out!
+
+### Requirements
+Best practice for your projects is of course to [use virtual environments](http://docs.python-guide.org/en/latest/dev/virtualenvs/). At the very least, you will need to [have pip installed](https://pip.pypa.io/en/stable/installing/).
+
+Autocrop is [currently being tested on](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml):
+
+* Python 3.7 to 3.10
+* OS:
+    - Linux
+    - macOS
+    - Windows
+
+# More Info
+Check out:
+
+* http://docs.opencv.org/master/d7/d8b/tutorial_py_face_detection.html#gsc.tab=0
+* http://docs.opencv.org/master/d5/daf/tutorial_py_histogram_equalization.html#gsc.tab=0
+
+Adapted from:
+
+* http://photo.stackexchange.com/questions/60411/how-can-i-batch-crop-based-on-face-location
+
+### Contributing
+
+Although autocrop is essentially a CLI wrapper around a single OpenCV function, it is actively developed. It has active users throughout the world.
+
+If you would like to contribute, please consult the [contribution docs](CONTRIBUTING.md).
+
+
+
+
+%package help
+Summary:	Development documents and examples for autocrop
+Provides:	python3-autocrop-doc
+%description help
+
+# autocrop
+
+[![CI](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/leblancfg/autocrop/branch/master/graph/badge.svg)](https://codecov.io/gh/leblancfg/autocrop) [![Documentation](https://img.shields.io/badge/docs-passing-success.svg)](https://leblancfg.com/autocrop) [![PyPI version](https://badge.fury.io/py/autocrop.svg)](https://badge.fury.io/py/autocrop) [![Downloads](https://pepy.tech/badge/autocrop)](https://pepy.tech/project/autocrop)
+
+<p align="center"><img title="obama_crop" src="https://cloud.githubusercontent.com/assets/15659410/10975709/3e38de48-83b6-11e5-8885-d95da758ca17.png"></p>
+
+Perfect for profile picture processing for your website or batch work for ID cards, autocrop will output images centered around the biggest face detected.
+
+# Installation
+Simple!
+
+~~~sh
+pip install autocrop
+~~~
+
+# Use
+Autocrop can be used [from the command line](#from-the-command-line) or directly [from Python API](#from-python).
+
+## From Python
+Import the `Cropper` class, set some parameters (optional), and start cropping.
+
+The `crop` method accepts filepaths or `np.ndarray`, and returns Numpy arrays. These are easily handled with [PIL](https://pillow.readthedocs.io/) or [Matplotlib](https://matplotlib.org/).
+
+~~~python
+from PIL import Image
+from autocrop import Cropper
+
+cropper = Cropper()
+
+# Get a Numpy array of the cropped image
+cropped_array = cropper.crop('portrait.png')
+
+# Save the cropped image with PIL if a face was detected:
+if cropped_array:
+    cropped_image = Image.fromarray(cropped_array)
+    cropped_image.save('cropped.png')
+~~~
+
+Further examples and use cases are found in the [accompanying Jupyter Notebook](https://github.com/leblancfg/autocrop/blob/master/examples/visual_tests.ipynb).
+
+## From the command line
+
+	usage: [-h] [-o OUTPUT] [-i INPUT] [-w WIDTH] [-H HEIGHT] [-e EXTENSION] [-v]
+
+	Automatically crops faces from batches of pictures
+
+	optional arguments:
+	  -h, --help
+	  		Show this help message and exit
+	  -o, --output, -p, --path
+			Folder where cropped images will be placed.
+			Default: current working directory
+	  -r, --reject
+			Folder where images without detected faces will be placed.
+			Default: same as output directory
+	  -i, --input
+			Folder where images to crop are located.
+			Default: current working directory
+	  -w, --width
+			Width of cropped files in px. Default=500
+	  -H, --height
+			Height of cropped files in px. Default=500
+	  --facePercent
+	  		Zoom factor. Percentage of face height to image height.
+	  -e, --extension
+	  		Enter the image extension which to save at output.
+	  		Default: Your current image extension
+	  -v, --version
+	  		Show program's version number and exit
+
+### Examples
+
+* Crop every image in the `pics` folder, resize them to 400 px squares, and output them in the `crop` directory:
+	- `autocrop -i pics -o crop -w 400 -H 400`.
+	- Images where a face can't be detected will be left in `crop`.
+* Same as above, but output the images with undetected faces to the `reject` directory:
+	- `autocrop -i pics -o crop -r reject -w 400 -H 400`.
+* Same as above but the image extension will be `png`:
+	- `autocrop -i pics -o crop -w 400 -H 400 -e png`
+	
+If no output folder is added, asks for confirmation and destructively crops images in-place.
+
+### Detecting faces from video files
+You can use autocrop to detect faces in frames extracted from a video. A great way to [perform the frame extraction step is with `ffmpeg`](https://ffmpeg.org/download.html):
+
+```sh
+mkdir frames faces
+
+# Extract one frame per second
+ffmpeg -i input.mp4 -filter:v fps=fps=1/60 frames/ffmpeg_%0d.bmp
+
+# Crop faces as jpg
+autocrop -i frames -o faces -e jpg
+```
+
+
+# Supported file types
+
+The following file types are supported:
+
+- EPS files (`.eps`)
+- GIF files (`.gif`) (only the first frame of an animated GIF is used)
+- JPEG 2000 files (`.j2k`, `.j2p`, `.jp2`, `.jpx`)
+- JPEG files (`.jpeg`, `.jpg`, `.jpe`)
+- LabEye IM files (`.im`)
+- macOS ICNS files (`.icns`)
+- Microsoft Paint bitmap files (`.msp`)
+- PCX files (`.pcx`)
+- Portable Network Graphics (`.png`)
+- Portable Pixmap files (`.pbm`, `.pgm`, `.ppm`)
+- SGI files (`.sgi`)
+- SPIDER files (`.spi`)
+- TGA files (`.tga`)
+- TIFF files (`.tif`, `.tiff`)
+- WebP (`.webp`)
+- Windows bitmap files (`.bmp`, `.dib`)
+- Windows ICO files (`.ico`)
+- X bitmap files (`.xbm`)
+
+# Misc
+### Installing directly
+In some cases, you may wish the package directly, instead of through [PyPI](https://pypi.python.org/pypi):
+
+~~~
+cd ~
+git clone https://github.com/leblancfg/autocrop
+cd autocrop
+pip install .
+~~~
+
+### conda
+Development of a `conda-forge` package for the [Anaconda Python distribution](https://www.anaconda.com/download/) is currently stalled due to the complexity of setting up the workflow with OpenCV. Please leave feedback on [issue #7](https://github.com/leblancfg/autocrop/issues/7) to see past attempts if you are insterested in helping out!
+
+### Requirements
+Best practice for your projects is of course to [use virtual environments](http://docs.python-guide.org/en/latest/dev/virtualenvs/). At the very least, you will need to [have pip installed](https://pip.pypa.io/en/stable/installing/).
+
+Autocrop is [currently being tested on](https://github.com/leblancfg/autocrop/actions/workflows/ci.yml):
+
+* Python 3.7 to 3.10
+* OS:
+    - Linux
+    - macOS
+    - Windows
+
+# More Info
+Check out:
+
+* http://docs.opencv.org/master/d7/d8b/tutorial_py_face_detection.html#gsc.tab=0
+* http://docs.opencv.org/master/d5/daf/tutorial_py_histogram_equalization.html#gsc.tab=0
+
+Adapted from:
+
+* http://photo.stackexchange.com/questions/60411/how-can-i-batch-crop-based-on-face-location
+
+### Contributing
+
+Although autocrop is essentially a CLI wrapper around a single OpenCV function, it is actively developed. It has active users throughout the world.
+
+If you would like to contribute, please consult the [contribution docs](CONTRIBUTING.md).
+
+
+
+
+%prep
+%autosetup -n autocrop-1.3.0
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-autocrop -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Mon May 29 2023 Python_Bot <Python_Bot@openeuler.org> - 1.3.0-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..0fbb20a
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+d326b325ee78e5599a25244e4fdf452d  autocrop-1.3.0.tar.gz