未验证 提交 61b2bb57 编写于 作者: 张春乔 提交者: GitHub

[xdoctest] reformat example code with google style in No. 231 (#56213)

上级 8e58fa57
...@@ -54,44 +54,44 @@ def gloo_init_parallel_env(rank_id, rank_num, server_endpoint): ...@@ -54,44 +54,44 @@ def gloo_init_parallel_env(rank_id, rank_num, server_endpoint):
Examples: Examples:
.. code-block:: python .. code-block:: python
import paddle >>> import paddle
import multiprocessing >>> import multiprocessing
from contextlib import closing >>> from contextlib import closing
import socket >>> import socket
port_set = set() >>> port_set = set()
def find_free_port(): >>> def find_free_port():
def _free_port(): ... def _free_port():
with closing(socket.socket(socket.AF_INET, ... with closing(socket.socket(socket.AF_INET,
socket.SOCK_STREAM)) as s: ... socket.SOCK_STREAM)) as s:
s.bind(('', 0)) ... s.bind(('', 0))
return s.getsockname()[1] ... return s.getsockname()[1]
while True: ... while True:
port = _free_port() ... port = _free_port()
if port not in port_set: ... if port not in port_set:
port_set.add(port) ... port_set.add(port)
return port ... return port
def test_gloo_init(id, rank_num, server_endpoint): >>> def test_gloo_init(id, rank_num, server_endpoint):
paddle.distributed.gloo_init_parallel_env( ... paddle.distributed.gloo_init_parallel_env(
id, rank_num, server_endpoint) ... id, rank_num, server_endpoint)
def test_gloo_init_with_multiprocess(num_of_ranks): >>> def test_gloo_init_with_multiprocess(num_of_ranks):
jobs = [] ... jobs = []
server_endpoint = "127.0.0.1:%s" % (find_free_port()) ... server_endpoint = "127.0.0.1:%s" % (find_free_port())
for id in range(num_of_ranks): ... for id in range(num_of_ranks):
p = multiprocessing.Process( ... p = multiprocessing.Process(
target=test_gloo_init, ... target=test_gloo_init,
args=(id, num_of_ranks, server_endpoint)) ... args=(id, num_of_ranks, server_endpoint))
jobs.append(p) ... jobs.append(p)
p.start() ... p.start()
for proc in jobs: ... for proc in jobs:
proc.join() ... proc.join()
if __name__ == '__main__': >>> if __name__ == '__main__':
# Arg: number of ranks (processes) ... # Arg: number of ranks (processes)
test_gloo_init_with_multiprocess(2) ... test_gloo_init_with_multiprocess(2)
""" """
assert ( assert (
...@@ -149,45 +149,45 @@ def gloo_barrier(): ...@@ -149,45 +149,45 @@ def gloo_barrier():
Examples: Examples:
.. code-block:: python .. code-block:: python
import paddle >>> import paddle
import multiprocessing >>> import multiprocessing
from contextlib import closing >>> from contextlib import closing
import socket >>> import socket
port_set = set() >>> port_set = set()
def find_free_port(): >>> def find_free_port():
def _free_port(): ... def _free_port():
with closing(socket.socket(socket.AF_INET, ... with closing(socket.socket(socket.AF_INET,
socket.SOCK_STREAM)) as s: ... socket.SOCK_STREAM)) as s:
s.bind(('', 0)) ... s.bind(('', 0))
return s.getsockname()[1] ... return s.getsockname()[1]
while True: ... while True:
port = _free_port() ... port = _free_port()
if port not in port_set: ... if port not in port_set:
port_set.add(port) ... port_set.add(port)
return port ... return port
def test_gloo_barrier(id, rank_num, server_endpoint): >>> def test_gloo_barrier(id, rank_num, server_endpoint):
paddle.distributed.gloo_init_parallel_env( ... paddle.distributed.gloo_init_parallel_env(
id, rank_num, server_endpoint) ... id, rank_num, server_endpoint)
paddle.distributed.gloo_barrier() ... paddle.distributed.gloo_barrier()
def test_gloo_barrier_with_multiprocess(num_of_ranks): >>> def test_gloo_barrier_with_multiprocess(num_of_ranks):
jobs = [] ... jobs = []
server_endpoint = "127.0.0.1:%s" % (find_free_port()) ... server_endpoint = "127.0.0.1:%s" % (find_free_port())
for id in range(num_of_ranks): ... for id in range(num_of_ranks):
p = multiprocessing.Process( ... p = multiprocessing.Process(
target=test_gloo_barrier, ... target=test_gloo_barrier,
args=(id, num_of_ranks, server_endpoint)) ... args=(id, num_of_ranks, server_endpoint))
jobs.append(p) ... jobs.append(p)
p.start() ... p.start()
for proc in jobs: ... for proc in jobs:
proc.join() ... proc.join()
if __name__ == '__main__': >>> if __name__ == '__main__':
# Arg: number of ranks (processes) ... # Arg: number of ranks (processes)
test_gloo_barrier_with_multiprocess(2) ... test_gloo_barrier_with_multiprocess(2)
""" """
assert _global_gloo_ctx is not None, "gloo context is not initialzed." assert _global_gloo_ctx is not None, "gloo context is not initialzed."
...@@ -207,46 +207,46 @@ def gloo_release(): ...@@ -207,46 +207,46 @@ def gloo_release():
Examples: Examples:
.. code-block:: python .. code-block:: python
import paddle >>> import paddle
import multiprocessing >>> import multiprocessing
from contextlib import closing >>> from contextlib import closing
import socket >>> import socket
port_set = set() >>> port_set = set()
def find_free_port(): >>> def find_free_port():
def _free_port(): ... def _free_port():
with closing(socket.socket(socket.AF_INET, ... with closing(socket.socket(socket.AF_INET,
socket.SOCK_STREAM)) as s: ... socket.SOCK_STREAM)) as s:
s.bind(('', 0)) ... s.bind(('', 0))
return s.getsockname()[1] ... return s.getsockname()[1]
while True: ... while True:
port = _free_port() ... port = _free_port()
if port not in port_set: ... if port not in port_set:
port_set.add(port) ... port_set.add(port)
return port ... return port
def test_gloo_release(id, rank_num, server_endpoint): >>> def test_gloo_release(id, rank_num, server_endpoint):
paddle.distributed.gloo_init_parallel_env( ... paddle.distributed.gloo_init_parallel_env(
id, rank_num, server_endpoint) ... id, rank_num, server_endpoint)
paddle.distributed.gloo_barrier() ... paddle.distributed.gloo_barrier()
paddle.distributed.gloo_release() ... paddle.distributed.gloo_release()
def test_gloo_release_with_multiprocess(num_of_ranks): >>> def test_gloo_release_with_multiprocess(num_of_ranks):
jobs = [] ... jobs = []
server_endpoint = "127.0.0.1:%s" % (find_free_port()) ... server_endpoint = "127.0.0.1:%s" % (find_free_port())
for id in range(num_of_ranks): ... for id in range(num_of_ranks):
p = multiprocessing.Process( ... p = multiprocessing.Process(
target=test_gloo_release, ... target=test_gloo_release,
args=(id, num_of_ranks, server_endpoint)) ... args=(id, num_of_ranks, server_endpoint))
jobs.append(p) ... jobs.append(p)
p.start() ... p.start()
for proc in jobs: ... for proc in jobs:
proc.join() ... proc.join()
if __name__ == '__main__': >>> if __name__ == '__main__':
# Arg: number of ranks (processes) ... # Arg: number of ranks (processes)
test_gloo_release_with_multiprocess(2) ... test_gloo_release_with_multiprocess(2)
""" """
if _global_gloo_ctx is not None: if _global_gloo_ctx is not None:
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册