Skip to content
This repository was archived by the owner on Feb 26, 2026. It is now read-only.

docs: update usage guide for v3.0.0 #456

Merged
daniel-sanche merged 28 commits into from
Jan 26, 2022
Merged

docs: update usage guide for v3.0.0 #456

Changes from 1 commit
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
a5c36d7
added empty v3.0.0 section to UPGRADING.md
daniel-sanche Dec 7, 2021
0ff7048
reorganized table of contents
daniel-sanche Dec 7, 2021
68e7f9d
marked old handlers as deprecated
daniel-sanche Dec 7, 2021
ff046f5
removed duplicated stdlib doc
daniel-sanche Dec 8, 2021
2e5fd18
made some progress on standard library integration doc
daniel-sanche Dec 8, 2021
51d2a9a
added more stdlib documentation
daniel-sanche Dec 8, 2021
fcc239b
finished up stdlib docs
daniel-sanche Dec 9, 2021
5826ce3
added page for direct API usage
daniel-sanche Dec 9, 2021
205d915
copied old usage guide info
daniel-sanche Dec 9, 2021
98a0a8c
working on setup section
daniel-sanche Dec 10, 2021
117e619
added log writing docs
daniel-sanche Dec 10, 2021
913a08c
removed references to POST requests
daniel-sanche Dec 10, 2021
29ea7d4
added batching info
daniel-sanche Dec 10, 2021
e822bd0
added transport docs
daniel-sanche Dec 10, 2021
8bce609
added grpc vs http docs
daniel-sanche Dec 10, 2021
eac5e2d
added upgrading notes
daniel-sanche Dec 14, 2021
01a0e33
improved manual handler section
daniel-sanche Jan 14, 2022
0526955
fixed lint issues
daniel-sanche Jan 15, 2022
a91b5f4
fixed snippet issue
daniel-sanche Jan 24, 2022
0ad37c8
addressed Drew's comments
daniel-sanche Jan 24, 2022
fd314b9
incorporated Pamela's feedback to migration guide
daniel-sanche Jan 25, 2022
95e5890
updated formatting
daniel-sanche Jan 26, 2022
51a7cd5
updated wording
daniel-sanche Jan 26, 2022
69209b1
changed wording
daniel-sanche Jan 26, 2022
741dfac
addressed Pamela's comments on the direct library usage document
daniel-sanche Jan 26, 2022
49dc3c3
incorporated Pamela's feedback in std lib integration doc
daniel-sanche Jan 26, 2022
ef947d3
removed unneeded delete lines
daniel-sanche Jan 26, 2022
1ff01aa
switched client for tests
daniel-sanche Jan 26, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
removed references to POST requests
  • Loading branch information
@daniel-sanche
daniel-sanche committed Dec 10, 2021
commit 913a08cc40cd2c4087c3666a5907a6473937b951
11 changes: 5 additions & 6 deletions google/cloud/logging_v2/logger.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -158,7 +158,7 @@ def _do_log(self, client, _entry_class, payload=None, **kw):
client.logging_api.write_entries([api_repr])

def log_empty(self, *, client=None, **kw):
"""Log an empty message via a POST request
"""Log an empty message

See
https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write
Expand All @@ -173,7 +173,7 @@ def log_empty(self, *, client=None, **kw):
self._do_log(client, LogEntry, **kw)

def log_text(self, text, *, client=None, **kw):
"""Log a text message via a POST request
"""Log a text message

See
https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write
Expand All @@ -189,7 +189,7 @@ def log_text(self, text, *, client=None, **kw):
self._do_log(client, TextEntry, text, **kw)

def log_struct(self, info, *, client=None, **kw):
"""Log a structured message via a POST request
"""Log a dictionary message

See
https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write
Expand All @@ -209,7 +209,7 @@ def log_struct(self, info, *, client=None, **kw):
self._do_log(client, StructEntry, info, **kw)

def log_proto(self, message, *, client=None, **kw):
"""Log a protobuf message via a POST request
"""Log a protobuf message

See
https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list
Expand All @@ -226,8 +226,7 @@ def log_proto(self, message, *, client=None, **kw):
self._do_log(client, ProtobufEntry, message, **kw)

def log(self, message=None, *, client=None, **kw):
"""Log an arbitrary message via a POST request.
Type will be inferred based on the input message.
"""Log an arbitrary message. Type will be inferred based on the input.

See
https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list
Expand Down