This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
dirshare
========

Description
-----------
**dirshare** is a HTTP WSGI Python application to rapidly share images within
a specific root path, leverages thumbnail caching, instantaneous image
resizing, file meta data extraction and zip file creation.

The motivation to create this application is that occasionally I must browse a
large collection of photos, WITHOUT a dedicated server software, loading of
full sized images or modifying original files.


Requirements
------------
- Setuptools (for installing dirshare and its Python dependencies)
- (optional) Access to a mongo database server

**Note** Pillow library uses system libraries to decode specific type of files.
If you get "IOError: decoder XXX not available" while loading some images,
you're probably missing some libraries (ex. libjpeg).

Installation
------------
From PyPI:
> pip install dirshare

Or:
> python setup.py install



Usage
-----
```bash
Usage: dirshare [options]

Options:
-h, --help show this help message and exit
-r IMAGES_ROOT, --images-root=IMAGES_ROOT
Root directory to share (default: ".")
-s IMAGE_SIZES, --image-sizes=IMAGE_SIZES
Available sizes as a string (default: "128x128 600x600
1000x1000 full")
-f RESIZE_FORMAT, --resize-format=RESIZE_FORMAT
Resize encoder to use (default: "PNG")
-q RESIZE_QUALITY, --resize-quality=RESIZE_QUALITY
Resize quality value to pass to encoder (default: 90)
-d DB_URI, --db-uri=DB_URI
DB uri (default: "mongodb://localhost:27017/dirshare")
-p HTTP_PORT, --http-port=HTTP_PORT
HTTP listen port (default: 6543)
-b HTTP_IP, --http-ip=HTTP_IP
HTTP bind ip (default: "127.0.0.1")
```

Example:
```bash
dirshare -r /home/myuser -s "128x128 500x500 full" -d "sqlite://:memory:"
```


0.8
---
updated: _waitForThumbs timeout set to 50ms
updated: default view set to grid
new: image count badge added to breadcrumb
fixed: $scope.setSize was calling cacheSized instead of setImage
updated: when image is de/selected, page is scrolled to correct position
new: util function to rotate image from string data
updated: all watches removed from controller. Actions are now taken inside setter methods.
updated: added readyImage flag to check if selected image is preloaded
updated: listDir and image requests are now retried when fail
fixed: some buttons now Select are now available even if there are no images in current path
new: loading image for listDir request added
fixed: loading bar was showing wrong values; image cant be changed while previously is being loaded
updated: dont allow path changes when isLoading()
new: images service. image cache is now controlled in specific service. (code updated to use it)
updated: files_paths is now returned from list dir view.
updated: variables renamed to camelCase
updated: .basket is now a list of full_path's
updated: listdir returns 404 when unknown directory
updated: $scope.image is a string again, to obey single-source-of-truth ($scope.images)
updated: refreshImage() now loads cache when needed; fixed: nav_path doesnt add empty entry when / is last character; updated: buttonsare hidden when loading or no image in current path
updated: metadata is no longer created inside stream_image for performance; logging added
updated: metadata is only loaded when image is loaded;
updated: when page section is changed, deferred received images are discarded
updated: images are now structured in an JS object
new: preloading thums with progress bar
new: previous and next buttons for easy navigation
updated: $scope.image is an object now
updated: bool variables to control loading created.
updated: keypress event captured to handle left and right keys.
updated: split app.js into js files
updated: manage panel, nav pills used for directories again
new: polling routine
update: app.js: path variable doesnt allow '//' anymore (should fix Windows problems)


0.7
---
- mongodb is no longer mandatory. sqlite interface is available.
- new cli, without the need of ini files to start dirshare.
- new: data access interface class used for multiple dbs support
- new: sqlite data access implementation complete
- new: cli is now a module. New cli app with waitress http server, without pastedeploy ini
- updated: unit tests cover all data access methods, both mongodb and sqlite
- updated: variables renamed. They make more sense
- updated: added ensure_index to mongo DA setup()
- updated: config now uses db_uri instead of mongo db specific variables (preparation for sqlite integration)
- updated: utils.db removed. data access is centralized in IDirshareDataAccess implementations
- updated: thumbnails click area is corrected
- updated: better image file condition check
- updated: view flow is set in a LIFO stack ($scope.view_stack)
- updated: When there's no exif info for an image, don't resize image viewer ($scope.isEmptyExif())
- updated: selected thumbnails style is only applied in Select Mode.
- fixed: mongo da: save_metadata and save_resize were not updating correctly
- fixed: correct mimetype is returned in content-type http header for resizes
- fixed: correct content-disposition header for resizes
- fixed: javascript local function variables are marked local with 'var'
- fixed: When image is changed ($watch), $scope.refreshing is toggled until data is retrieved.

0.6
---
- Major change: The whole application is now a single page, built with AngularJS and Bootstrap framework.
- New: ETag header is now used. Performance is significantly improved.
- New: Two view modes. Grid: useful for desktops. Scroll: better display for mobile devices.
- New: Select mode: Add any image to the basket. At any time, go to the basket to view or export (zip) the whole selection.
- New: EXIF information is now read and saved, for each image file.
- New: Content-disposition http header is now used for zip and images.
- New: unit tests created.

0.3
---
- First public release
Release History

Release History

0.8

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.6

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
dirshare-0.8.tar.gz (420.6 kB) Copy SHA256 Checksum SHA256 Source Sep 16, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting