Metadata-Version: 2.1
Name: scapy
Version: git-archive.dev304758016
Summary: Scapy: interactive packet manipulation tool
Home-page: https://scapy.net
Author: Philippe BIONDI
Author-email: phil(at)secdev.org
Maintainer: Pierre LALET, Gabriel POTTER, Guillaume VALADON
License: GPLv2
Download-URL: https://github.com/secdev/scapy/tarball/master
Project-URL: Documentation, https://scapy.readthedocs.io
Project-URL: Source Code, https://github.com/secdev/scapy/
Description: # Scapy
        
        [![Travis Build Status](https://travis-ci.com/secdev/scapy.svg?branch=master)](https://travis-ci.com/secdev/scapy)
        [![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/secdev/scapy?svg=true)](https://ci.appveyor.com/project/secdev/scapy)
        [![Codecov Status](https://codecov.io/gh/secdev/scapy/branch/master/graph/badge.svg)](https://codecov.io/gh/secdev/scapy)
        [![Codacy Badge](https://api.codacy.com/project/badge/Grade/30ee6772bb264a689a2604f5cdb0437b)](https://www.codacy.com/app/secdev/scapy)
        [![PyPI Version](https://img.shields.io/pypi/v/scapy.svg)](https://pypi.python.org/pypi/scapy/)
        [![Python Versions](https://img.shields.io/pypi/pyversions/scapy.svg)](https://pypi.python.org/pypi/scapy/)
        [![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](LICENSE)
        [![Join the chat at https://gitter.im/secdev/scapy](https://badges.gitter.im/secdev/scapy.svg)](https://gitter.im/secdev/scapy)
        
        Scapy is a powerful Python-based interactive packet manipulation program and
        library.
        
        It is able to forge or decode packets of a wide number of protocols, send them
        on the wire, capture them, store or read them using pcap files, match requests
        and replies, and much more. It is designed to allow fast packet prototyping by
        using default values that work.
        
        It can easily handle most classical tasks like scanning, tracerouting, probing,
        unit tests, attacks or network discovery (it can replace `hping`, 85% of `nmap`,
        `arpspoof`, `arp-sk`, `arping`, `tcpdump`, `wireshark`, `p0f`, etc.). It also
        performs very well at a lot of other specific tasks that most other tools can't
        handle, like sending invalid frames, injecting your own 802.11 frames, combining
        techniques (VLAN hopping+ARP cache poisoning, VoIP decoding on WEP protected
        channel, ...), etc.
        
        Scapy supports Python 2.7 and Python 3 (3.4 to 3.7). It's intended to
        be cross platform, and runs on many different platforms (Linux, OSX,
        \*BSD, and Windows).
        
        ## Getting started
        
        Scapy is usable either as a **shell** or as a **library**.
        For further details, please head over to [Getting started with Scapy](https://scapy.readthedocs.io/en/latest/introduction.html), which is part of the documentation.
        
        ### Shell demo
        
        ![Scapy install demo](https://secdev.github.io/img/animation-scapy-install.svg)
        
        Scapy can easily be used as an interactive shell to interact with the network.
        The following example shows how to send an ICMP Echo Request message to
        `github.com`, then display the reply source IP address:
        
        ```python
        sudo ./run_scapy
        Welcome to Scapy
        >>> p = IP(dst="github.com")/ICMP()
        >>> r = sr1(p)
        Begin emission:
        .Finished to send 1 packets.
        *
        Received 2 packets, got 1 answers, remaining 0 packets
        >>> r[IP].src
        '192.30.253.113'
        ```
        
        ### Resources
        
        The [documentation](https://scapy.readthedocs.io/en/latest/) contains more
        advanced use cases, and examples.
        
        Other useful resources:
        
        -   [Scapy in 20 minutes](https://github.com/secdev/scapy/blob/master/doc/notebooks/Scapy%20in%2015%20minutes.ipynb)
        -   [Interactive tutorial](https://scapy.readthedocs.io/en/latest/usage.html#interactive-tutorial) (part of the documentation)
        -   [The quick demo: an interactive session](https://scapy.readthedocs.io/en/latest/introduction.html#quick-demo)
        (some examples may be outdated)
        -   [HTTP/2 notebook](https://github.com/secdev/scapy/blob/master/doc/notebooks/HTTP_2_Tuto.ipynb)
        -   [TLS notebooks](https://github.com/secdev/scapy/blob/master/doc/notebooks/tls)
        
        ## [Installation](https://scapy.readthedocs.io/en/latest/installation.html)
        
        Scapy works without any external Python modules on Linux and BSD like operating
        systems. On Windows, you need to install some mandatory dependencies as
        described in [the
        documentation](http://scapy.readthedocs.io/en/latest/installation.html#windows).
        
        On most systems, using Scapy is as simple as running the following commands:
        
        ```bash
        git clone https://github.com/secdev/scapy
        cd scapy
        ./run_scapy
        ```
        
        To benefit from all Scapy features, such as plotting, you might want to install
        Python modules, such as `matplotlib` or `cryptography`. See the
        [documentation](http://scapy.readthedocs.io/en/latest/installation.html) and
        follow the instructions to install them.
Keywords: network
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Telecommunications Industry
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Networking :: Monitoring
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4
Description-Content-Type: text/markdown
Provides-Extra: complete
Provides-Extra: basic
