Story #11770

[Python SDK] Implement support for universal newline mode in Collections API

Added by Tom Morris over 1 year ago. Updated 5 months ago.

Status:
New
Priority:
Normal
Assigned To:
-
Category:
API
Target version:
Start date:
05/26/2017
Due date:
% Done:

0%

Estimated time:
Story points:
-

Description

Implementation should match that of the Python 3 file open method as described at: https://docs.python.org/release/3.2/library/functions.html#open

??newline controls how universal newlines works (it only applies to text mode). It can be None, '', '\n', '\r', and '\r\n'. It works as follows:

On input, if newline is None, universal newlines mode is enabled. Lines in the input can end in '\n', '\r', or '\r\n', and these are translated into '\n' before being returned to the caller. If it is '', universal newline mode is enabled, but line endings are returned to the caller untranslated. If it has any of the other legal values, input lines are only terminated by the given string, and the line ending is returned to the caller untranslated.
On output, if newline is None, any '\n' characters written are translated to the system default line separator, os.linesep. If newline is '', no translation takes place. If newline is any of the other legal values, any '\n' characters written are translated to the given string.
??

Note that the Python 2 method of specifying a mode of 'rU' is now deprecated.


Related issues

Related to Arvados - Story #11419: [SDKs] support text-mode open() in Python 3Resolved2017-03-21

History

#1 Updated by Tom Morris over 1 year ago

  • Description updated (diff)

#2 Updated by Tom Morris over 1 year ago

  • Subject changed from [Python SDK] Implement support for universal newline mode (rU) in Collections API to [Python SDK] Implement support for universal newline mode in Collections API
  • Description updated (diff)

#3 Updated by Tom Morris over 1 year ago

  • Target version changed from 2017-06-21 sprint to Arvados Future Sprints

#4 Updated by Tom Morris 5 months ago

  • Target version changed from Arvados Future Sprints to To Be Groomed

Also available in: Atom PDF