48 lines
1.2 KiB
Python
48 lines
1.2 KiB
Python
import warnings
|
|
from contextlib import contextmanager
|
|
|
|
__all__ = ["reversed"]
|
|
|
|
|
|
@contextmanager
|
|
def reversed(G):
|
|
"""A context manager for temporarily reversing a directed graph in place.
|
|
|
|
.. deprecated:: 2.6
|
|
|
|
This context manager is deprecated and will be removed in 3.0.
|
|
Use ``G.reverse(copy=False) if G.is_directed() else G`` instead.
|
|
|
|
This is a no-op for undirected graphs.
|
|
|
|
Parameters
|
|
----------
|
|
G : graph
|
|
A NetworkX graph.
|
|
|
|
Warning
|
|
-------
|
|
The reversed context manager is deprecated in favor
|
|
of G.reverse(copy=False). The view allows multiple threads to use the
|
|
same graph without confusion while the context manager does not.
|
|
This context manager is scheduled to be removed in version 3.0.
|
|
"""
|
|
msg = (
|
|
"context manager reversed is deprecated and to be removed in 3.0."
|
|
"Use G.reverse(copy=False) if G.is_directed() else G instead."
|
|
)
|
|
warnings.warn(msg, DeprecationWarning)
|
|
|
|
directed = G.is_directed()
|
|
if directed:
|
|
G._pred, G._succ = G._succ, G._pred
|
|
G._adj = G._succ
|
|
|
|
try:
|
|
yield
|
|
finally:
|
|
if directed:
|
|
# Reverse the reverse.
|
|
G._pred, G._succ = G._succ, G._pred
|
|
G._adj = G._succ
|