@@ -81,9 +81,8 @@ an iterator for controlling the COPY operation.
8181 be used until ``__exit__`` is ran.
8282
8383 ``CopyManager.__exit__(typ, val, tb)``
84- Finish, abort, or fail the COPY operation. Aborts in the case of an incomplete
85- COPY or an unidentified exception, and fails in the case of an untrapped
86- fault.
84+ Finish the COPY operation. Fails in the case of an incomplete
85+ COPY, or an untrapped exception.
8786
8887 ``CopyManager.__iter__()``
8988 Returns the CopyManager instance.
@@ -106,7 +105,7 @@ The CopyManager generalizes some exceptions that occur during transfer. While
106105inside the context manager, `postgresql.copyman.Fault` may be raised if a
107106Receiver raises an exception. The Manager assumes the Fault is fatal to a
108107Receiver, and immediately removes it from the set of target receivers.
109- Additionally, if the Fault goes untrapped, the copy will be aborted .
108+ Additionally, if the Fault goes untrapped, the copy will fail .
110109
111110The Fault exception references the Manager that raised the exception, and the
112111actual exceptions that occurred, associated with the Receiver that caused them::
@@ -210,14 +209,11 @@ processes of the `postgresql.copyman` module:
210209
211210 Realignment
212211 The process of providing compensating data to the receivers so that the
213- connection will be on a message boundary. Occurs when the COPY operation is
214- aborted.
215-
216- Aborted Copy
217- An aborted copy is a COPY operation that terminated prematurely. This happens
218- if a CopyManager's for-loop is terminated early by breaking or by an
219- unidentified exception being raised.
212+ connection will be on a message boundary. Occurs when the COPY operation
213+ fails.
220214
221215 Failed Copy
222- A failed copy is an aborted COPY operation that was
223- *terminated due to a fault*, or a producer failure.
216+ A failed copy is an aborted COPY operation. This occurs in situations of
217+ untrapped exceptions or an incomplete COPY. Specifically, the COPY will be
218+ noted as failed in cases where the Manager's iterator is *not* ran until
219+ exhaustion.
0 commit comments