l-vo / photos-picker

Library that allows to select (randomly or not) many photos and copy them to a destination (local filesystem or web services)

Photos Picker

This libary allows to pick photos in a folder according to a given strategy (last photos, random photos...) and copy them to a destination (another system folder, Dropbox or Google drive folder...)

Compatibility

This library currently works with Python 2.7, Python 3.4, Python 3.5, Python 3.6 and Python 3.7.

Install

$ pip install photos-picker

Usage

The main class PhotosPicker accepts a "picker", a tuple of "filters" and an "uploader" as arguments. The picker allows to select photos while the filters modify them. At the end of the process, the uploader copy transformed (or not) photos to a given destination. Below the simplest example which copy the 50 lastest photos to another directory:

# Python 2.7 example
from photospicker.exception.abstract_exception import AbstractException
from photospicker.picker.pickers.last_photos_picker import LastPhotosPicker
from photospicker.uploader.uploaders.filesystem_uploader import FilesystemUploader
from photospicker.photos_picker import PhotosPicker

if __name__ == '__main__':
    try:
        picker = LastPhotosPicker('/pictures', 50)
        uploader = FilesystemUploader('/destination')
    
        photos_picker = PhotosPicker(picker, (), uploader)
        photos_picker.run()
    except AbstractException as err:
        print err.message

Since picking and uloading may take a while, progress events are dispatched. You can see a more complex example which displays work progress here.

Pickers:

• LastPhotosPicker: pick the n lastest photos.
• RandomPicker: pick randomly n photos.
• SmartPicker: pick randomy n photos. Recent photos have more chance to be picked than old ones. It results by a picking of a majority of recent photos and a few old ones.

More details here

Note you can also create your own picker extending the base class AbstractPicker.

Filters:

• ResizeFilter: resize the photos with the given width and height. The final photos size are computed for avoiding distortion.
• RotateFilter: Rotate the photos according to EXIF data.

More details here

Note you can also create your own filter extending the base class AbstractFilter.

Uploaders:

Note that uploaders don't append new photos. Either the directory must be empty or the uploader clear it before copying files.

• FilesystemUploader: copy the photos to a given directory. This directory must exist and be empty.
• DropBoxUploader: upload the photos to Dropbox. Note that you should limit your token access to application. Creating a full access token is not needed and may induce security issues.
• GDriveUploader upload the photos to Google Drive.

More details here

Note you can also create your own uploader extending the base class AbstractUploader.

Contributing

The project is currenlty currently shipped with many pickers, filters or uploaders. But others can be developed, you may post an issue for that. Or better, read how to post a pull request :)

photos-picker's Issues

Add rotate filter

Add CI and coverage badges

Add a requirements-dev.txt file

And a make install target for installing dev dependencies

Improve resize filter tests

Use callee

Allow to add and exclude many directory paths

Allow to customize Dropbox and Google Drive destination folder

Add try/except in usage examples

Test compatibility with 3.x versions

Add filters feature

Picked photos may take a long time to upload since they have a big size. Add the possibility to pass a tuple of filters to PhotosPicker. These filters could reduce image size or for instance change photo orientation according to EXIF data.

Check in AbstractPicker that photos to pick is never greater than total photos

Allow to use "~" in search/excluded paths

• Allow to use "~" in search/excluded paths
• Manage paths like "~user/..." (if os.path.expanduser allows it)
• Fix doc (excluded patterns instead of excluded paths)

Be careful to not call _getexif on png images

Allow to shuffle picked photos once they are retrieved

May be useful for LastPhotosPicker or for SmartPicker when photos count is lower to photos to retrieve

Add Google drive uploader

Normalize docstrings

Check the possibility to add integration tests

FilesystemUploader: check that directory exists and is empty in the constructor

For raising the error before the files scan

Add smart random picker