Metadata-Version: 2.4
Name: emailstore
Version: 1.5.8
Summary: Select and store emails from mailbox.
Author-email: Roger Marsh <roger.marsh@solentware.co.uk>
License-Expression: BSD-3-Clause
Project-URL: Homepage, http://www.solentware.co.uk
Project-URL: Repository, https://github.com/RogerMarsh/emailstore.git
Project-URL: Bug Tracker, https://github.com/RogerMarsh/emailstore/issues
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Other/Nonlisted Topic
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 3 - Alpha
License-File: LICENCE
Requires-Dist: solentware-misc==1.7.2
Dynamic: license-file

====================================
Select and store emails from mailbox
====================================

.. contents::


Description
===========

This package provides a select and store email interface given mailboxes populated by an email client.

Specify selection rules for emails by sender and date.

Extract emails from a set of mailboxes.

Allow specific emails to be excluded from the selection.


Installation Instructions
=========================

This package is not available on PyPI, or any other package index, but can be installed by typing

   python -m pip install --user --trusted-host solentware.co.uk --find-links http://solentware.co.uk/wheels.html emailstore

at the command prompt.

See `Python`_ and `pip`_ documentation for alternatives and platform-specific points.

Then run 'python -m pip check' to identify other packages which need to be installed.


Run
===

The command to run this package is:

   python -m emailstore.emailstore

You may need to give the path and version of Python depending on your system's configuration:

   <path to python>/python<version> -m emailstore.emailstore

   For example

      C:\\Python33\\python -m emailstore.emailstore

         on Microsoft Windows or

      python3.3 -m emailstore.emailstore

         on Unix-like systems.

Or use the facilities of your desktop (Microsoft Windows, GNOME, KDE, ...) to set up a convenient way of starting emailstore. 


Restrictions
============

The supported mailbox formats are:

* mbox
* `Opera`_'s directory structure for emails

At most one email per sender per second, looking at the date sent, is allowed.


Notes
=====

The current implementation does just enough to support the `ChessResults`_ package.

The configuration file editor interface is almost unusable.


.. _Python: https://python.org
.. _pip: https://packaging.python.org/installing
.. _Opera: http://opera.com
.. _ChessResults: http://solentware.co.uk/grading.html
