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.

Rename pycomediError to PEP-8-compliant PycomediError.

Move pycomedi.common.VERSION to pycomedi.__version__ and cleanup setup.py.

Bumped version to 0.2

Added bugtracking with Bugs Everywhere.

The bug I added it for turned out to be due to the calling software,
not PyComedi itself.  I also removed an old debugging printout from
simult_aio.py.

Allow two passes through test_cmd in simult_aio.

Fixed failing commands when the exact ns sample period was not available.

e.g:

Testing command:
Command on <pycomedi.common.PyComediIO object at 0x8e9184c> (output):
subdevice:      1
flags:          0x40
start:          ext|    18
scan_begin:     timer|  324675
convert:        now|    0
scan_end:       count|  1
stop:           count|  16010
test pass 0, argument conflict
Failing command (4):
Command on <pycomedi.common.PyComediIO object at 0x8e9184c> (output):
subdevice:      1
flags:          0x40
start:          ext|    18
scan_begin:     timer|  324700
convert:        now|    0
scan_end:       count|  1
stop:           count|  16010

Explicit cast to int to avoid lsampl type problem.

See commit 5b69b33d46529be30bbdf15b392f0b96986bdcdd for another example.

Added labels to verbose plot in single_aio.py.

Cast data to int in PyComediSingleIO.write_chan_index.

Without the cast, I got this traceback when data was a numpy.uint16:

Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "/home/wking/.python/unfold.py", line 101, in __init__
    self.zp.jumpToPos(self.zp.pos_nm2out(0))
  File "/home/wking/.python/z_piezo.py", line 161, in jumpToPos
    self.curIn = self._jump.jumpToPos(self.curOut)
  File "/home/wking/.python/z_piezo.py", line 248, in jumpToPos
    self.AO.write(out)
  File
"/home/wking/lib/python2.5/site-packages/pycomedi-0.1-py2.5.egg/pycomedi/single_aio.py",
line 90, in write
    self.write_chan_index(i, data[i])
  File
"/home/wking/lib/python2.5/site-packages/pycomedi-0.1-py2.5.egg/pycomedi/common.py",
line 411, in write_chan_index
    rc = c.comedi_data_write(self.dev, self.subdev,
self.chan[chan_index], self._range[chan_index], self._aref[chan_index],
data);
TypeError: in method 'comedi_data_write', argument 6 of type 'lsampl_t'

Fixed license reference in setup.py and added license headers to source.

Added a .gitignore file.

Added ez_setup installation framework.