FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

[3.7] bpo-37331: Clarify format of socket handler messages in the documentation. (GH-14234) by miss-islington · Pull Request #14236 · python/cpython · GitHub

/ cpython Public

[3.7] bpo-37331: Clarify format of socket handler messages in the documentation. (GH-14234) #14236

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vsajip merged 1 commit into from
Jun 19, 2019
Conversation 1 Commits 1 Checks 0 Files changed
Merged

[3.7] bpo-37331: Clarify format of socket handler messages in the documentation. (GH-14234) #14236

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension .rst  (1) All 1 file type selected
Viewed files
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Unified
Split
Hide whitespace
Diff view
Unified
Split
Hide whitespace
18 changes: 14 additions & 4 deletions Doc/library/logging.handlers.rst
Show comments
View file
Open in desktop
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Show hidden characters
Original file line number Diff line number Diff line change
Expand Up @@ -470,7 +470,12 @@ sends logging output to a network socket. The base class uses a TCP socket.
.. method:: makePickle(record)

Pickles the record's attribute dictionary in binary format with a length
prefix, and returns it ready for transmission across the socket.
prefix, and returns it ready for transmission across the socket. The
details of this operation are equivalent to::

data = pickle.dumps(record_attr_dict, 1)
datalen = struct.pack('>L', len(data))
return datalen + data

Note that pickles aren't completely secure. If you are concerned about
security, you may want to override this method to implement a more secure
Expand All @@ -481,8 +486,12 @@ sends logging output to a network socket. The base class uses a TCP socket.

.. method:: send(packet)

Send a pickled string *packet* to the socket. This function allows for
partial sends which can happen when the network is busy.
Send a pickled byte-string *packet* to the socket. The format of the sent
byte-string is as described in the documentation for
:meth:`~SocketHandler.makePickle`.

This function allows for partial sends, which can happen when the network
is busy.


.. method:: createSocket()
Expand Down Expand Up @@ -543,7 +552,8 @@ over UDP sockets.

.. method:: send(s)

Send a pickled string to a socket.
Send a pickled byte-string to a socket. The format of the sent byte-string
is as described in the documentation for :meth:`SocketHandler.makePickle`.


.. _syslog-handler:
Expand Down
Back | FazBrowse Home | New Git URL