{
    "info": {
        "author": "Yaokai Yang",
        "author_email": "",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 4 - Beta",
            "Intended Audience :: Developers",
            "Intended Audience :: System Administrators",
            "License :: OSI Approved :: Apache Software License",
            "Operating System :: Microsoft :: Windows",
            "Operating System :: POSIX",
            "Programming Language :: Python",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.4",
            "Programming Language :: Python :: 3.5",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7",
            "Topic :: Software Development :: Libraries :: Python Modules",
            "Topic :: System :: Networking :: Monitoring"
        ],
        "description": "# Python Port Scanner v0.3\n\n[![Build Status](https://travis-ci.com/YaokaiYang-assaultmaster/py3PortScanner.svg?branch=master)](https://travis-ci.com/YaokaiYang-assaultmaster/py3PortScanner)\n\nAn easy to use Python3 package that could perform port scanning conveniently.\n\nAn output example is showed as following:  \n![Output Example](https://github.com/YaokaiYang-assaultmaster/py3PortScanner/blob/master/ExampleGraph/portscanner_output_new.png)\n\n## Installation  \n### Install with pip  \n```\npip install pyportscanner\n```\n\n### Install with setup scripts  \n1. Clone or download this repository.\n2. Install the package using `python setup.py install`.   \n3. Voil\u00e0! You are ready to go!\n\n## QuickStart\n1. Add `from pyportscanner import pyscanner` to the beginning of your code.\n2. Initialize a new PortScanner object using `scanner = pyscanner.PortScanner(target_ports=100, timeout=10, verbose=True)`.\n3. Then call `scanner.scan(objective)` to perform a port scan to a specific target.\nThe target could either be an IPv4 address or a host name.\n4. __Note that the total scan time for a target website is highly related to the timeout value set for the Scanner object. Thus for the seek of efficiency, the timeout should not be too long.__\n\n## Documentation \n### _class pyportscanner.pyscanner.PortScanner(target_ports=None, thread_limit=100, timeout=10, verbose=False)_\nPortScanner is the class provides methods to execute the port scan request. A PortScanner object is needed for performing\nthe port scan request.  \n\n- _target_ports_ can be a list or int. If this args is a list, then the list of ports specified by it is going to be scanned, \ndefault to all ports we have in file. If this args is an int, then it specifies the top X number of ports to be scanned based on usage\nfrequency rank.\n- _thread_limit_ is the number of thread being used for scan.  \n- _timeout_ is the timeout for the socket to wait for a response.\n- _verbose_ specifies whether the results would be print out or not. If `True`, results will be print out. \n\n### _Functions_  \n__PortScanner.scan(objective, message = '')__ \n\nScan an objective with the given message included in the packets sent out.  \n\n- _objective_ is the target that is going to be scanned. It could be an IPv4 address or a hostname.  \n- _message_ is the message that is going to be included in the scanning packets sent out. If not provided, no message will be included in the packets.    \n\nAn example usage case is showed in [_examples/PortScanExample.py_](https://github.com/YaokaiYang-assaultmaster/py3PortScanner/blob/master/examples/PortScanExample.py).  \n\n### Unit Test\n\nIn order to run unit test, execute the following command under the root directory.\n\n```Python\npytest --cov pyportscanner/ tests/\n``` \n\n## [Change logs](https://github.com/YaokaiYang-assaultmaster/py3PortScanner/blob/master/CHANGELOG.md)\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/YaokaiYang-assaultmaster/py3PortScanner",
        "keywords": "",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "pyportscanner",
        "package_url": "https://pypi.org/project/pyportscanner/",
        "platform": "",
        "project_url": "https://pypi.org/project/pyportscanner/",
        "project_urls": {
            "Homepage": "https://github.com/YaokaiYang-assaultmaster/py3PortScanner"
        },
        "release_url": "https://pypi.org/project/pyportscanner/0.3.2/",
        "requires_dist": [
            "pytest ; extra == 'dev'",
            "pytest-cov ; extra == 'dev'"
        ],
        "requires_python": "",
        "summary": "Port Scanner for Python3+",
        "version": "0.3.2"
    },
    "last_serial": 4650220,
    "releases": {
        "0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "60ddfac5bbc0611b0b21f2a5d231829c",
                    "sha256": "14f598af9dba2ca152e407cc8daca3ad8430cd646f21fd1fbcabae4d2d8fe405"
                },
                "downloads": -1,
                "filename": "pyportscanner-0.3-py3.5.egg",
                "has_sig": false,
                "md5_digest": "60ddfac5bbc0611b0b21f2a5d231829c",
                "packagetype": "bdist_egg",
                "python_version": "3.5",
                "requires_python": null,
                "size": 235336,
                "upload_time": "2018-12-31T11:53:57",
                "url": "https://files.pythonhosted.org/packages/8d/ee/c839bee472d9d6fbe6954030d4098c5cc128a2bb24e0c951d850c8159336/pyportscanner-0.3-py3.5.egg"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "e4be07754b88182735fb21b568df1444",
                    "sha256": "c2580efaade390f55340f19df73aded3753db0c67fbe3e30f11da8d5d4d8f3a8"
                },
                "downloads": -1,
                "filename": "pyportscanner-0.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "e4be07754b88182735fb21b568df1444",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 224260,
                "upload_time": "2018-12-31T11:53:53",
                "url": "https://files.pythonhosted.org/packages/40/8d/2f719749e0dbb04acc51fb2cef5010e0f873564685d7d04f6c9d894603d2/pyportscanner-0.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "5d152e4adec9a80675b4735a7030dbf1",
                    "sha256": "d7efadddda7f1aaa8fdf2594b4ad0f9b5b9040924a4eb2caa864b8dbfe48a30c"
                },
                "downloads": -1,
                "filename": "pyportscanner-0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "5d152e4adec9a80675b4735a7030dbf1",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 214140,
                "upload_time": "2018-12-31T11:54:01",
                "url": "https://files.pythonhosted.org/packages/d0/2c/9236ceaf29107e94f2863eb47d208de2b9264af849a19e268cb61268b714/pyportscanner-0.3.tar.gz"
            }
        ],
        "0.3.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "623df54566c22b84ab32b5f73ce41db6",
                    "sha256": "8b632a882c01bcf117f4ae3b77d4b2cda0f3464359e8eb91a7812e5062f7dbef"
                },
                "downloads": -1,
                "filename": "pyportscanner-0.3.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "623df54566c22b84ab32b5f73ce41db6",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 223988,
                "upload_time": "2018-12-31T14:52:10",
                "url": "https://files.pythonhosted.org/packages/bd/b1/b8d41d6297aaa5e778146fc433e41cc7fddc5f91f96e0efccf66c8e2682b/pyportscanner-0.3.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "5a907af6d089d4e918dc3ab5afe95045",
                    "sha256": "460e4b3c3b4377d500ae15a19940aa36d0ba7a80bf35d29e48b08b0f3d7eff2c"
                },
                "downloads": -1,
                "filename": "pyportscanner-0.3.1.tar.gz",
                "has_sig": false,
                "md5_digest": "5a907af6d089d4e918dc3ab5afe95045",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 213533,
                "upload_time": "2018-12-31T14:52:15",
                "url": "https://files.pythonhosted.org/packages/1a/40/191c5261ab0bce6063099222baac6dbcf7456353f7b6def1a02372aa0206/pyportscanner-0.3.1.tar.gz"
            }
        ],
        "0.3.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "fdd97e4e58982900200adcf66c60e4fe",
                    "sha256": "d69dd4aa8fbe0b13ec0de370268871562db261acfb9a82ea66cd48d57b1c7aab"
                },
                "downloads": -1,
                "filename": "pyportscanner-0.3.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "fdd97e4e58982900200adcf66c60e4fe",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 224214,
                "upload_time": "2019-01-01T14:20:30",
                "url": "https://files.pythonhosted.org/packages/35/d7/b0c4c7a26265fdd9f7b7ceaf20500fe05f87935ab7e602f8384a52bd5bc1/pyportscanner-0.3.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "00207b1fe4d876affb275343a7b1e3f0",
                    "sha256": "1cc115fb00b4ad7856884ca414035e6bae56bf316aa1325e78600606bcd1c074"
                },
                "downloads": -1,
                "filename": "pyportscanner-0.3.2.tar.gz",
                "has_sig": false,
                "md5_digest": "00207b1fe4d876affb275343a7b1e3f0",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 214061,
                "upload_time": "2019-01-01T14:20:37",
                "url": "https://files.pythonhosted.org/packages/29/47/978a2e9028af2a6686a21e284d93a5790f6910e3c0df5a611333d43476df/pyportscanner-0.3.2.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "fdd97e4e58982900200adcf66c60e4fe",
                "sha256": "d69dd4aa8fbe0b13ec0de370268871562db261acfb9a82ea66cd48d57b1c7aab"
            },
            "downloads": -1,
            "filename": "pyportscanner-0.3.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "fdd97e4e58982900200adcf66c60e4fe",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 224214,
            "upload_time": "2019-01-01T14:20:30",
            "url": "https://files.pythonhosted.org/packages/35/d7/b0c4c7a26265fdd9f7b7ceaf20500fe05f87935ab7e602f8384a52bd5bc1/pyportscanner-0.3.2-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "00207b1fe4d876affb275343a7b1e3f0",
                "sha256": "1cc115fb00b4ad7856884ca414035e6bae56bf316aa1325e78600606bcd1c074"
            },
            "downloads": -1,
            "filename": "pyportscanner-0.3.2.tar.gz",
            "has_sig": false,
            "md5_digest": "00207b1fe4d876affb275343a7b1e3f0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 214061,
            "upload_time": "2019-01-01T14:20:37",
            "url": "https://files.pythonhosted.org/packages/29/47/978a2e9028af2a6686a21e284d93a5790f6910e3c0df5a611333d43476df/pyportscanner-0.3.2.tar.gz"
        }
    ]
}