B
    Nô`Í'  ã               @   s”   d Z ddlZddlmZ ddlmZmZ ddlm	Z	m
Z
 dddd	gZd
d„ Zdd„ Zddd„Zeddd�dd„ ƒZedƒeddd�ddd	„ƒƒZdS )aO  Functions for reading and writing graphs in the *sparse6* format.

The *sparse6* file format is a space-efficient format for large sparse
graphs. For small graphs or large dense graphs, use the *graph6* file
format.

For more information, see the `sparse6`_ homepage.

.. _sparse6: http://users.cecs.anu.edu.au/~bdm/data/formats.html

é    N)ÚNetworkXError)Ú	open_fileÚnot_implemented_for)Ú	data_to_nÚ	n_to_dataÚfrom_sparse6_bytesÚread_sparse6Úto_sparse6_bytesÚwrite_sparse6c             #   sò  t | ƒ}|dkrtdƒ‚|r"dV  dV  x$t|ƒD ]}t t|d ƒ¡V  q2W d‰xdˆ> |k rjˆd7 ‰qTW ‡fdd„}td	d
„ |  ¡ D ƒƒ}g ‰ d}x”|D ]Œ\}}	||krÆˆ  d¡ ˆ  	||	ƒ¡ qœ||d krô|d7 }ˆ  d¡ ˆ  	||	ƒ¡ qœ|}ˆ  d¡ ˆ  	||ƒ¡ ˆ  d¡ ˆ  	||	ƒ¡ qœW ˆdk �rŒ|dˆ> k�rŒt ˆ ƒ d ˆk�rŒ||d k �rŒˆ  d¡ ˆ  	dgt ˆ ƒ d  ¡ nˆ  	dgt ˆ ƒ d  ¡ ‡ fdd„t
dt ˆ ƒdƒD ƒ}
x"|
D ]}t t|d ƒ¡V  �qÊW dV  dS )a%  Yield bytes in the sparse6 encoding of a graph.

    `G` is an undirected simple graph. `nodes` is the list of nodes for
    which the node-induced subgraph will be encoded; if `nodes` is the
    list of all nodes in the graph, the entire graph will be
    encoded. `header` is a Boolean that specifies whether to generate
    the header ``b'>>sparse6<<'`` before the remaining data.

    This function generates `bytes` objects in the following order:

    1. the header (if requested),
    2. the encoding of the number of nodes,
    3. each character, one-at-a-time, in the encoding of the requested
       node-induced subgraph,
    4. a newline character.

    This function raises :exc:`ValueError` if the graph is too large for
    the graph6 format (that is, greater than ``2 ** 36`` nodes).

    l       @ z?sparse6 is only defined if number of nodes is less than 2 ** 36s   >>sparse6<<ó   :é?   é   c                s   ‡‡ fdd„t ˆƒD ƒS )zBig endian k-bit encoding of xc                s(   g | ] }ˆd ˆ d  | > @ r d nd‘qS )r   r   © )Ú.0Úi)ÚkÚxr   ú>/tmp/pip-unpacked-wheel-fc63gmtm/networkx/readwrite/sparse6.pyú
<listcomp><   s    z8_generate_sparse6_bytes.<locals>.enc.<locals>.<listcomp>)Úrange)r   )r   )r   r   Úenc:   s    z$_generate_sparse6_bytes.<locals>.encc             s   s&   | ]\}}t ||ƒt||ƒfV  qd S )N)ÚmaxÚmin)r   ÚuÚvr   r   r   ú	<genexpr>>   s    z*_generate_sparse6_bytes.<locals>.<genexpr>r   é   c                sl   g | ]d}ˆ |d   d> ˆ |d  d>  ˆ |d  d>  ˆ |d  d>  ˆ |d  d>  ˆ |d  d >  ‘qS )r   é   r   é   é   é   r   )r   r   )Úbitsr   r   r   Z   s   z+_generate_sparse6_bytes.<locals>.<listcomp>ó   
N)ÚlenÚ
ValueErrorr   ÚstrÚencodeÚchrÚsortedÚedgesÚappendÚextendr   )ÚGÚnodesÚheaderÚnÚdr   r)   Zcurvr   r   Údatar   )r!   r   r   Ú_generate_sparse6_bytes   sL    



:


r2   c       	         s
  |   d¡r| dd… } |   d¡s(tdƒ‚dd„ | dd… D ƒ}t|ƒ\}‰ d‰xdˆ> |k rfˆd7 ‰qPW ‡ ‡fd	d
„}d}t ¡ }| t|ƒ¡ d}x`|ƒ D ]V\}}|dkr´|d7 }||ksÄ||krÈP qœ||krÖ|}qœ| ||¡ræd}| ||¡ qœW |�st 	|¡}|S )aU  Read an undirected graph in sparse6 format from string.

    Parameters
    ----------
    string : string
       Data in sparse6 format

    Returns
    -------
    G : Graph

    Raises
    ------
    NetworkXError
        If the string is unable to be parsed in sparse6 format

    Examples
    --------
    >>> G = nx.from_sparse6_bytes(b":A_")
    >>> sorted(G.edges())
    [(0, 1), (0, 1), (0, 1)]

    See Also
    --------
    read_sparse6, write_sparse6

    References
    ----------
    .. [1] Sparse6 specification
           <http://users.cecs.anu.edu.au/~bdm/data/formats.html>

    s   >>sparse6<<é   Nr   z!Expected leading colon in sparse6c             S   s   g | ]}|d  ‘qS )r   r   )r   Úcr   r   r   r   Ž   s    z&from_sparse6_bytes.<locals>.<listcomp>r   c              3   sÖ   t ˆ ƒ} d}d}xÀ|dk r@yt| ƒ}W n tk
r:   dS X d}|d8 }||? d@ }|d|> d @ }|}xF|ˆk r®yt| ƒ}W n tk
r’   dS X d}|d> | }|d7 }qjW ||ˆ ? }|ˆ }||fV  qW dS )z6Returns stream of pairs b[i], x[i] for sparse6 format.Nr   r   r   )ÚiterÚnextÚStopIteration)Úchunksr0   ZdLenÚbr   ZxLen)r1   r   r   r   Ú	parseData”   s2    
z%from_sparse6_bytes.<locals>.parseDatar   FT)
Ú
startswithr   r   ÚnxZ
MultiGraphZadd_nodes_fromr   Zhas_edgeZadd_edgeZGraph)	ÚstringÚcharsr/   r:   r   r,   Z
multigraphr9   r   r   )r1   r   r   r   h   s6    !


Tc             C   s2   |dk	r|   |¡} tj| dd�} d t| ||ƒ¡S )aö  Convert an undirected graph to bytes in sparse6 format.

    Parameters
    ----------
    G : Graph (undirected)

    nodes: list or iterable
       Nodes are labeled 0...n-1 in the order provided.  If None the ordering
       given by ``G.nodes()`` is used.

    header: bool
       If True add '>>sparse6<<' bytes to head of data.

    Raises
    ------
    NetworkXNotImplemented
        If the graph is directed.

    ValueError
        If the graph has at least ``2 ** 36`` nodes; the sparse6 format
        is only defined for graphs of order less than ``2 ** 36``.

    Examples
    --------
    >>> nx.to_sparse6_bytes(nx.path_graph(2))
    b'>>sparse6<<:An\n'

    See Also
    --------
    to_sparse6_bytes, read_sparse6, write_sparse6_bytes

    Notes
    -----
    The returned bytes end with a newline character.

    The format does not support edge or node labels.

    References
    ----------
    .. [1] Graph6 specification
           <http://users.cecs.anu.edu.au/~bdm/data/formats.html>

    Nr(   )Úorderingó    )Úsubgraphr<   Úconvert_node_labels_to_integersÚjoinr2   )r,   r-   r.   r   r   r   r	   É   s    ,
Úrb)Úmodec             C   sN   g }x,| D ]$}|  ¡ }t|ƒs q
| t|ƒ¡ q
W t|ƒdkrF|d S |S dS )aò  Read an undirected graph in sparse6 format from path.

    Parameters
    ----------
    path : file or string
       File or filename to write.

    Returns
    -------
    G : Graph/Multigraph or list of Graphs/MultiGraphs
       If the file contains multiple lines then a list of graphs is returned

    Raises
    ------
    NetworkXError
        If the string is unable to be parsed in sparse6 format

    Examples
    --------
    You can read a sparse6 file by giving the path to the file::

        >>> import tempfile
        >>> with tempfile.NamedTemporaryFile() as f:
        ...     _ = f.write(b">>sparse6<<:An\n")
        ...     _ = f.seek(0)
        ...     G = nx.read_sparse6(f.name)
        >>> list(G.edges())
        [(0, 1)]

    You can also read a sparse6 file by giving an open file-like object::

        >>> import tempfile
        >>> with tempfile.NamedTemporaryFile() as f:
        ...     _ = f.write(b">>sparse6<<:An\n")
        ...     _ = f.seek(0)
        ...     G = nx.read_sparse6(f)
        >>> list(G.edges())
        [(0, 1)]

    See Also
    --------
    read_sparse6, from_sparse6_bytes

    References
    ----------
    .. [1] Sparse6 specification
           <http://users.cecs.anu.edu.au/~bdm/data/formats.html>

    r   r   N)Ústripr#   r*   r   )ÚpathZglistÚliner   r   r   r   û   s    3
Zdirectedr   Úwbc             C   sD   |dk	r|   |¡} tj| dd�} xt| ||ƒD ]}| |¡ q.W dS )a  Write graph G to given path in sparse6 format.

    Parameters
    ----------
    G : Graph (undirected)

    path : file or string
       File or filename to write

    nodes: list or iterable
       Nodes are labeled 0...n-1 in the order provided.  If None the ordering
       given by G.nodes() is used.

    header: bool
       If True add '>>sparse6<<' string to head of data

    Raises
    ------
    NetworkXError
        If the graph is directed

    Examples
    --------
    You can write a sparse6 file by giving the path to the file::

        >>> import tempfile
        >>> with tempfile.NamedTemporaryFile() as f:
        ...     nx.write_sparse6(nx.path_graph(2), f.name)
        ...     print(f.read())
        b'>>sparse6<<:An\n'

    You can also write a sparse6 file by giving an open file-like object::

        >>> with tempfile.NamedTemporaryFile() as f:
        ...     nx.write_sparse6(nx.path_graph(2), f)
        ...     _ = f.seek(0)
        ...     print(f.read())
        b'>>sparse6<<:An\n'

    See Also
    --------
    read_sparse6, from_sparse6_bytes

    Notes
    -----
    The format does not support edge or node labels.

    References
    ----------
    .. [1] Sparse6 specification
           <http://users.cecs.anu.edu.au/~bdm/data/formats.html>

    Nr(   )r?   )rA   r<   rB   r2   Úwrite)r,   rG   r-   r.   r9   r   r   r   r
   :  s
    8
)NT)NT)Ú__doc__Znetworkxr<   Znetworkx.exceptionr   Znetworkx.utilsr   r   Znetworkx.readwrite.graph6r   r   Ú__all__r2   r   r	   r   r
   r   r   r   r   Ú<module>   s   Ra
2?
