setup.py: add explicit classifier for GPLv2+

Bump to version 0.6.

Major changes since v0.5:

* Python 3 compatibility
* Soft-calibration support (with help from Éric Piel) with new
  calibration classes: Caldac, CalibrationSetting, and Calibration

b89928: upgrade to Bugs Everywhere Directory v1.5

demo/aout: support also samples with only one channel

scipy.io.wavfile returns a one dimension array if the wav file is only one channel

.update-copyright.conf: update to pipe separators.

This brings the config file up to speed with the following
update-copyright commit:

  commit 3c68a1a48419d8b2bbc2ce0e7f1700b996ec30e9
  Author: W. Trevor King <wking@tremily.us>
  Date:   Fri Oct 19 21:52:48 2012 -0400

    project: for consistency, also separate ignored paths with pipes

Fix broken dependency linearization.

I had tried to break circular dependencies with:

  commit c19dd6ff6ce26beaf1b0ffc57d505b71898f8d0f
  Author: W. Trevor King <wking@tremily.us>
  Date:   Fri Oct 19 08:58:34 2012 -0400

    Break circular dependencies for Python 3 compatibility.

Which was causing errors like:

  Exception AttributeError:
    "'pycomedi.device.Device' object has no attribute 'device'"
    in 'pycomedi.subdevice.Subdevice._device'

because when you treat Device instances as Python objects, you cannot
access their private (C-only) attributes.  This commit avoids that
problem by adding low level classes (DeviceHolder and SubdeviceHolder)
that can be imported by both the high level classes (Device and
Subdevice) and their users (Subdevice and Channel), avoiding circular
dependencies while preserving critical C-only attributes.

Allow exceptions from other cdef functions.

send excpetions from get_softcal_converter and get_hardcal_converter

this allows to catch them from _get_converter()

calibration: support to-physical-only softcal boards.

This is a hack to fix Éric Piel's issue:

On Thu, Oct 18, 2012 at 12:10:49PM +0200, Éric Piel wrote:
> Unfortunately, with my device there seems to still be a problem with
> comedi_get_softcal_converter(), which returns -1 with direction
> from_physical. I get the same problem when using the SWIG wrapper, so
> it's probably not an error in pycomedi. So when I run cmd.py I get this
> error, but it works anyway as the _to_phys converter works:
> ./cmd.py -f /dev/comedi0 -s 0 -c 0 -a diff -N 1 -p
> Exception pycomedi.PyComediError:
> PyComediError('comedi_get_softcal_converter: Resource temporarily
> unavailable (-1)',) in
> 'pycomedi.channel.AnalogChannel.get_softcal_converter' ignored
> 0.220157

I feel like we should make an effort to invert the from_physical
polynomial, but as a stop-gap measure, we can just raise the original
exception and let the user decide what to do about it.

README: update to mention optional python-kmod dependency.

info.py: add optional kmod modinfo section.

The older info.py version only used comedilib to extract board
information, including the comedi version in use.  While the
out-of-kernel comedi module does bump their versions (occasionally ;),
the in-kernel staging drivers still claim version 0.7.76 (despite
being mostly equivalent to the out-of-tree module 0.10.1).  This makes
it useful to differentiate between in-kernel and out-of-kernel modules
by printing some modinfo details, for which I'm using the kmod Python
bindings (python-kmod).

I'm currently using my Cython branch of python-kmod, which is pending
a merge upstream [1].

[1]: https://github.com/agrover/python-kmod/pull/3

Update to `except ... as ...` syntax for Python 3.

Break circular dependencies for Python 3 compatibility.

cmd.py: importing matplotlib without X can raise RuntimeErrors.

For example, with the GTKAgg backend selected in
~/.matplotlib/matplotlibrc, running cmd.py without X raises:

  Traceback (most recent call last):
    File "./cmd.py", line 32, in <module>
      from matplotlib import pyplot as _pyplot
    ...
  RuntimeError: could not create GdkCursor object

calibration: fix parameter type

need to send the pointer to the C struct, not the python object

fix compilation with cython 0.15.1

Need to help cython to find out that a new CalibrationSetting is a CalibrationSetting, otherwise
it thinks that its properties are python objects.

Add `-*- coding: utf-8 -*-` comments where Éric Piel is in authors.

Ran update-copyright.py.

MANIFEST.in: add AUTHORS (generated by update-copyright.py).

setup: use format() for formatting strings.

setup: add explicit Python 2.7 and 3.2 classifiers.

cmd: add --plot option (for use with --callback).

cmd: add poll() calls to try and flush data off card.

In order to bring data off the card faster, we'll try and use the
subdevice.poll() command.  I may be doing this wrong, though, because
all of the poll() calls return zero.

pycomedi_demo_args: comment on what happens with lots of verbose args.

For example, if you call

  cmd.py -vvvvvvv

This will set pycomedi.LOG to DEBUG.

  WARN -> INFO
  INFO -> DEBUG
  no-op
  no-op
  etc.

The new comment makes this clearer, because it took me a minute to
understand the implementation ;).

cmd: flush stream in write_data().

calibration: fix Python-to-caldac cast in CalibrationSetting._caldacs_set.

Pointed out by Éric Piel using Cython 0.15.1:

  Error compiling Cython file:
  ------------------------------------------------------------
  ...
              raise MemoryError()
          self.setting.num_caldacs = length
          for i,x in enumerate(value):
              if i >= length:
                  raise ValueError((i, length))
              self.setting.caldacs[i] = x
                                        ^
  ------------------------------------------------------------

  pycomedi/calibration.pyx:505:39: Cannot convert Python object to
  'comedi_caldac_t'

calibration: set .num_arefs in CalibrationSetting._arefs_set.

calibration: add CalibrationSetting attribute-setting doctests.

calibration: shift settings[0] doctest spacing.

calibration: add Caldac.allocate() for stand-alone caldac instances.

README: warn about channel output during testing.

Merge calibaration branch into master.

This feature branch adds support for loading and applying calibration
files, as well as for loading soft calibration converters.

channel: standardize indentation in AnalogChannel._get_converter().

channel: add AnalogChannel.apply_calibration.

calibration: add Caldac, CalibrationSetting, and Calibration.

Add Python wrappers around comedi_calibration_t and its
sub-structures.  This allows you to load calibration files (soft and
hard) and manipulate their contents in Python.

test.sh: use Python-3-compatible print().

device: remove trailing whitespace from Éric's patch.

add support for soft calibration

Strip trailing whitespace.

Bump to version 0.5.

Add MANIFEST to .gitignore.

Ran update-copyright.py.

AUTHORS should not be version controlled (generated by update-copyright.py).

.update-copyright.conf should not be executable.

Oops, convert period from seconds to nanoseconds in cmd.py demo.

Add --callback option to cmd.py demo to use CallbackReader.

The --verbose argument to the demo scripts doesn't take arguments.

Fix conversion to physical in cmd.py demo ('float32' is not defined).

Add pycomedi.utility.CallbackReader for handling read data as it comes in.

Change my email address from drexel.edu to tremily.us.

Ran update-copyright.py.

Add doc/demo/aout.py example of repeated analog output.

This script contains the condensed wisdom of mailing list
discussions between Richard Höchenberger and myself.

Cc: Richard Höchenberger

Wrap long lines in doc/demo/info.py.

'channels' default should be a list in pycomedi_demo_args.py.

Wrap long help lines in pycomedi_demo_args.py.

Add `block_while_running` option to `_ReadWriteThread`.

This way users don't need to understand the following distinctions:

* written to driver vs. output from card.
* `SDF_BUSY` vs. `SDF_RUNNING`.

The `subdevice.cancel` call in `_ReadWriteThread.block` is because the
`RUNNING` flag is cleared after output completes, but the `BUSY` flag
is not.  This may be a bug in Comedi.  I've asked on the mailing list,
but haven't heard back yet.

Add positional arguments to format strings for Python 2.6 compatibility.

For 2.7 and later, the positional arguments can be omitted, but
Richard Höchenberger (and others?) wants to run pycomedi on 2.6.

Add trailing slash to Gentoo overlay link in README.

Rework demos so that test.sh covers their critical parts.

Add --mmap argument to cmd.py demo and fix some pycomedi_demo_args.py bugs.

Fix subdevice._device -> subdevice.device in _MMapReadWriteThread._fileno().

When I was writing the Cython implementation, I initially tried to
keep more things private, before realizing that that wasn't a good
idea.  This snippit missed the initial transition.

Consolidate demo argument parsing in pycomedi_demo_args.py to reduce duplication.

Add cmd.py demo.

Allow AnalogChannel.__init__ to take integers for `range`.

If you know the index of your desired range, you can now use that
index directly and skip the usual call to `find_range`.

Actually listen to the --subdevice option in the insn.py demo.

Add insn.py demo.

Don't set log levels for pycomedi.LOG handlers.

That's too much granularity for the default situation, where there is
only one handler and we can use the logger's level to control
verbosity.

Fix error condition `ret < 0` -> `ret < len(insnlist)` for Device.do_insnlist.

The previous implemenation would apparently succeed if there was an
error executing an instruction.  It would only raise an exception if a
failure occured before the first instruction could be executed.

Add 'external' unit for RF_EXTERNAL (see previous commit for reasoning).

Revert "Mask range.unit with 0xff when determining the unit."

This reverts commit d721a0c05450c793a5e0e562d286a689565cf81b.

From the National Instruments E Series User Manual [1], page 3-2:

  Reference Selection

  (NI 6020E, NI PXI-6040E, NI 6052E, NI 6062E, NI 6070E/6071E, and
  PCI-MIO-16E-4 Devices Only) You can connect each DAC to the device
  internal reference of 10 V or to the external reference signal
  connected to the external reference (AO EXT REF) pin on the I/O
  connector. This signal applied to EXT REF should be within
  ±11 V. You do not need to configure both channels for the same mode.

So RF_EXTERNAL is a valid unit (i.e. in units of the AO EXT REF
signal).  The next commit will add this unit.

[1]: http://digital.ni.com/manuals.nsf/websearch/06115536722DAA558625728E007E6BA4
  Edition Date: February 2007
  Part Number:    370503K-01
  p

Add info.py demo.

Mask range.unit with 0xff when determining the unit.

This avoids crashes like:

  Traceback (most recent call last):
    ...
    File "range.pyx", line 62, in pycomedi.range.Range.__str__
    File "range.pyx", line 70, in pycomedi.range.Range._unit_get
    File "constant.pyx", line 269, in pycomedi.constant._Enum.index_by_value
  KeyError: 256L

when RF_EXTERNAL is set.

Add attributes to PyComediError to make intelligent error handling easier.

Add .ranges() method to Channel class.

Add .channels() method to Subdevice class.

Allow keywords for Channel.get_range().

Add docstring to Channel.get_range.

Bump to verssion 0.4.

Add __reduce__() method to BitwiseOperator and _NamedInt.

This makes it possible to successfully pickle and deepcopy instances
of these types [1,2].  This gets the

  TRIG_SRC.now == copy.deepcopy(TRIG_SRC.now)

doctest working, which I needed to successfully dump h5config
ChoiceConfig objects that use _Enum choices [3].

For example, the newly fixed pypiezo.config.ChannelConfig [4] uses the
AREF enum values as possible choices for it's `analog-reference`
setting.  h5config makes deepcopies of mutable objects to avoid
confusion if the mutable is changed externally.  It then compares the
deepcopies with uncopied values.  Now that deepcopying works for
_NamedInts, the h5config behavior will work.

[1] http://docs.python.org/library/pickle.html#pickling-and-unpickling-extension-types
[2] http://docs.python.org/library/copy.html
[3] http://pypi.python.org/pypi/h5config/
[4] http://pypi.python.org/pypi/pypiezo/

Use utility.lsample instead of numpy.uint in calibration._convert().

Don't repeat yourself!  Also, numpy.uint is a uint64 on my amd64, and
that does not match with lsampl_t.

Yes, 2 < 3.  (fix constant comparison doctest).

Fix rich comparison doctest prompts and add comparisons to None.

The None comparison logic avoids:

  TypeError: long() argument must be a string or a number, not 'NoneType'

Oops, Cython uses __richcmp__() instead of __eq__(), etc.

http://docs.cython.org/src/userguide/special_methods.html#rich-comparisons

Add rich comparisons to BitwiseOperator (compare by .value).

Fix get_version_code parsing and split it off into a new Device.get_version method.

Fix wrtier -> writer typo in `pycomedi.utility._MMapReadWriteThread` docstring.

Move function_name extraction up in pycomedi/_error.pyx's comedi_get.

This avoids:
  pycomedi/_error.pyx:43:29:
    local variable 'function_name' referenced before assignment

Update URLs from einstein to tremily.

Ran update-copyright.py.

Transition to my external update-copyright package.

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

Change to GPLv2+ licensing.

Previously COPYING and the README had claimed GPLv3+, but the headers
generated by update_copyright had used GPLv2+.  GPLv2+ is more
inclusive and closer to the standard Comedi library's LGPLv2.1+.

Add AUTHORS (generated by update_copyright.py) to version control.

Remove separate copyright dates from README.

They wouldn't get updated by update_copyright.py, so they would
inevitably fall out of date.

Run update_copyright.py.

Add update_copyright.py.

Mostly-complete Cython implementation.

I need some work on Cython upstream to entirely remove the requirement
on the SWIG-wrapped comedi module.

Convert to more generic Pythonic wrapper.  Not everything works yet.

Fix == -> = in __version__ definition.

Rename simAioError -> SimAioError and use ValueError in common._expand_tuple().

Also rename sngAioError -> SngAioError and dioError -> SngDioError.