Merge remote-tracking branch 's-o-b/contributing-github'

CONTRIBUTING.md: point to external docs on GitHub

This translates CONTRIBUTING (from the `contributing` branch) into
Markdown using a GitHub URL for the link.  Merging this into your
project will set it up to use GitHub's CONTRIBUTING infrastructure,
and will be used to notify users creating issues and pull requests
[1].

GitHub's blob URL syntax is [2]:

  https://github.com/<user>/<project>/blob/<commit-SHA-1>/Path/To/File

Like CONTRIBUTING, CONTRIBUTING.md is also released under the CC0
Universal license (see the `license` branch for full text).

[1]: https://github.com/blog/1184-contributing-guidelines
[2]: https://help.github.com/articles/how-do-i-get-a-permanent-link-from-file-view-to-permanent-blob-url

Signed-off-by: W. Trevor King <wking@tremily.us>

CONTRIBUTING: point to external docs (for non GPLv2= projects)

If a project wants to use the DCO/s-o-b workflow, but can't because of
license incompatibility, they can include this blurb pointing towards
the external documentation.  To avoid licensing issues with this
CONTRIBUTING file itself, I'm releasing it under the Creative Commons
CC0 1.0 Universal license (see the `license` branch for full text).

If you use this in your project, you'll probably want to adjust the
URL to point to somewhere more dependable.  It's annoyingly long, but
you should include the blob hash (or a higher level hash like the
commit hash) in your URL to make it absolutely clear which version of
the documentation you were using in your project at a particular time.

Signed-off-by: W. Trevor King <wking@tremily.us>

rss2email: raise error on import with Python < 3.2.

rss2email won't work with older Pythons.  Avoid user confusion due to
API-breakage error messages [1] by bailing explicitly up front.

[1]; http://forums.macrumors.com/showthread.php?t=1216694

CHANGELOG: summarize changes since v2.71

test: record sender as SENT BY (not SENT TO) in *.expected

test:gmane: add Gmane feed for RSS testing

The weird indentation is because Gmane wraps the descriptions in <pre>
tags (to preserve formatting in the initial email).  html2text is
converting the description to Markdown, so it inserts a leading 4
spaces for preformatted blocks.  The unindented initial line and
following blank are due to a bug in html2text, for which I've
submitted

  https://github.com/aaronsw/html2text/pull/63

CHANGELOG: strip trailing whitespace

setup.py: list dependencies in setup(requires=...)

setup.py: use mailing list address for maintenance

REAMDE: point to rss2email/config.py, not a line number in rss2email.py

README: use GitHub URL for git clone

README: use Gmane for example feed

README: add mailing list information (and link to Gmane)

main: fix logging imports

This should have happened in:

  commit 066602efa088b4a89d67e23011613b4459db3c92
  Author: W. Trevor King <wking@tremily.us>
  Date:   Tue Nov 13 09:09:00 2012 -0500

    rss2email: split massive package into modules

Run update-copyright.py

.update-copyright.conf: add copyright configuration.

Use my external update-copyright package to maintain copyright blurbs.

http://pypi.python.org/pypi/update-copyright/

.mailmap: map Lindsey's usernames to a canonical form

COPYING: add GPLv2 text

setup.py: add a comma to the end of the url kwarg

This should have happened in:

  commit cd5b8f30942c72a0fd1b82f4763f21cfaad3864b
  Author: W. Trevor King <wking@tremily.us>
  Date:   Mon Nov 12 15:59:09 2012 -0500

    Convert homepage/downloads from allthingsrss.com to GitHub

rss2email: split massive package into modules

test: fix tests to handle Message-IDs

This should have happened in:

  commit 29f8b8813e1f464b7171ea1830b6ed40ec24dac2
  Author: W. Trevor King <wking@tremily.us>
  Date:   Sat Oct 27 11:09:45 2012 -0400

    rss2email: add Message-IDs so I can link messages in Mutt

rss2email: convert infogami URL to GitHub URL

README: GitHub's markup renderer chokes on Unicode ellipses in code blocks

README.rst: add symlink for GitHub rendering

Convert homepage/downloads from allthingsrss.com to GitHub

rss2email: reorder NoValidEncodingError superclasses

This avoids:

  TypeError: NoValidEncodingError does not take keyword arguments

Merge Lindsey's recent advances with my master

Conflicts:
.gitignore    (use my master, dumping Lindsey's changes)
readme.html   (remove in favor of my README)
rss2email.py  (use my master, bringing in the following changes from
               Lindsey's branch)

  commit 42fa878f929c6ee39c8068d186de1ae7f4630638
  Author: Lindsey Smith <lindsey.smith@gmail.com>
  Date:   Mon Mar 14 09:18:42 2011 -0700

    Improved basic email validation

Incorperated into Feed._validate_email.

  commit 38b33a71e049f29743ce1805b82d4f048e466ce6
  Author: Lindsey Smith <lindsey.smith@gmail.com>
  Date:   Mon Mar 14 09:19:12 2011 -0700

    Initial revision

Incorperated into the Feed._validate_email doctest.

  commit a55809611f9706e7004791c060bd7e5a90a2dcb9
  Author: U-SEVEN\lindsey <lindsey.smith@gmail.com>
  Date:   Fri Jun 24 11:07:22 2011 -0700

    Better attribute handling. Factored out tag handling into getTags()

This wasn't an atomic commit.  I dropped the BeautifulSoup HTML
cleanup to avoid an additional dependency.  I skipped the r → fullfeed
change in getName because I'd already rewritten that function as
Feed._get_entry_name.  I tweaked Feed._get_entry_tags to also handle
termless-tags.

  commit db2ac2f7a76cf93022363ac103f17d7ec71927f9
  Author: U-SEVEN\lindsey <lindsey.smith@gmail.com>
  Date:   Fri Jun 24 11:08:19 2011 -0700

    Added tests for getTags()

Merged getName tests into the Feed._get_entry_name doctest and merged
tag tests into the Feed._get_entry_tags doctest.

The other commits in Lindsey's branch didn't have anything that is
still useful after my refactoring.

Merge Lindsey's tip (development since v2.71)

Merge Lindsey's v2.71 into my v2.71

I would just use Lindsey's repository directly, except my repository
contains more old releases (back to v2.65).

The conflicts were due to a few new lines in Lindsey's CHANGELOG, and
a number of whitespace differences due to line endings.

Conflicts:
CHANGELOG
config.py.example
r2e
r2e.bat
readme.html
rss2email.py

Change maintainer from Lindsey to Trevor.

I emailed Lindset on October 4th with some changes, and then again on
October 18th with a PyPI push suggestion.  I haven't heard back on
either count, so I'm assuming maintainership and pushing this to PyPI
myself.

Lindsey, I'm not attempting a hostile takeover ;).  If you get back
from a month-long vacation and want to resume maintainership, let me
know.

rss2email: allow config feed ordering to override datafile ordering

rss2email: add Message-IDs so I can link messages in Mutt

rss2email: fix Feed._validate_email signature to include self.

rss2email: fix e.__cause__ -> self.__cause__ typos in exception logging.

rss2email.py: don't create config-only feeds if they were in the datafile.

rss2email: add ability to load feeds from the config file only.

If a feed exists in the config file, but not in the data file, the
previous implementation would not load it.  This patch initializes
such feeds using only the information from the config file
(i.e. without dynamic data from the data file).  The patch also
creates missing data files on demand.  As an example use case, if you
keep a backup of your config file, but lose the data file, you can
restore the config file and an `r2e run` will create and repopulate
your data file.

rss2email: fix index->send argument typo in feed.run() call.

rss2email: add debug logging for smtp_send() and sendmail_send().

.gitignore: add `build`, a setup.py byproduct.

rss2email: work around pickle.load() messing with LOG.

I'm not sure why this is happening yet, but _pickle.load() is
duplicating the StreamHandlers in LOG and resetting the log level to
ERROR.  Work around that by saving the original level/handlers and
restoring them after the load() call.
I haven't figured out why this happens yet.

rss2email: add specific SAXParseException error message.

rss2email: add description to the general bozo warning.

r2e: use python in the sh-bang.

This is better than using Bash to call Python, because distutils can
make sh-bang adjustments on installation.

It drops the local --config/--data options, but that brings us into
compliance with the current README and man page.

Package with distutils.

README: move readme.html -> README and convert to reStructuredText.

This is in preparation for posting on PyPI.  It is also easier to read
rst source than it is to read HTML.  You can generate an html version
of the source with

  $ rst2html README > readme.html

I also restructured the README to avoid separate Windows/UNIX
sections, because almost all the advice applies to all systems.

r2e: use PYTHONPATH to find and run rss2email.

This should make it easier for r2e to work where several Python
version are installed on the same machine.

rss2email: add run() function for main program execution.

rss2email: fix pausing -> unpausing typo in unpause help string.

rss2email: change -c/--config option from nargs to append.

Now you should use

  $ rss2email.py -c path1 -c path2 ... comand

Instead of

  $ rss2email.py -c path1 path2 ... comand

The latter made

  $ rss2email.py -c path1 comand

look like a command-less call (`command' being interpreted as another
config path).

rss2email: don't create directories for files in the current directory.

This avoids:

  $ ./rss2email.py -d feeds.dat new
  ...
  OSError: [Errno 2] No such file or directory: ''

readme: add feed name in `r2e add` example.

r2e.1: update man page for configparser-based rss2email.

r2e.1: add man page from Debian package.

This man page was extracted from rss2email_2.65-1.diff.gz.

test: add a test suite and simple testing script.

It would probably be a good idea to use the unittest framework, but
this works as a first pass.

Convert message string to bytes for sendmail.

If we don't have a feed-specific section, use DEFAULT in Feed._send().

Fix configSMTP_SEND -> config.getboolean(section, 'use-smtp') typo.

Set default status to 200 (e.g. when loaded from a local file).

Fix CONFIG -> config typo in Feed.load_from_config().

Change default logging level back to ERROR.

Use kwargs consistently in s for diamond inheritance.

readme: convert configuration examples to the new format.

Update the r2e scripts to use -c/-d for locating config files.

Add myself to __contributors__.

Fix ___contributors__ -> __contributors__.

Spread cmd_run() logic out into Feed methods (under Feed.run()).

Rework commands to use argparse subparsers (cmd_run still needs work).

Cleanups to Feed and Feeds.

Fix ConfigParser option <-> Python conversion for Feed attributes.

Only load configfiles if we have filenames to work with.

Move parse() to Feed.fetch().

Add Feeds class for managing lists of feeds.

Flesh out Feed class with saving/loading methods.

Get rid of some tiny helper functions.

Convert timelimit() to a class TimeLimitedFunction.

More global constant and configuration cleanups.

Add .gitignore ignoring __pycache__.

Break send() into guess_encoding(), get_message(), and *_send().

Add rss2email.LOG for standardized logging.

QP has been deprecated for years.  Remove it entirely.

Setup html2text in Config._setup().

Cleanup global module configuration.

Convert configuration to a ConfigParser instance.

Import as _* to avoid namespace pollution.

Also update import locations for Python 3.2.

Collect imports at the beginning of rss2email.py.

Cleanup metadata formatting.

Convert tabs to spaces and strip trailing whitespace.

Nominally convert to Python >=3.2.

readme: cleanup formatting.

readme: strip trailing whitespace.

I'm going to rework the configuration to use ConfigParser.

Don't bundle feedparser or html2text.py.

Bump rss2email.__version__ to 2.71.

Bump to version 2.71.

Bump to version 2.70.

Bump to version 2.69a.

Bump to version 2.69.

Bump to version 2.68.

Bump to version 2.67.