greynoise 2.3.0__tar.gz → 3.0.0__tar.gz

greynoise-3.0.0/.bumpversion.cfg

@@ -0,0 +1,29 @@
+[bumpversion]
+current_version = 3.0.0
+tag = False
+commit = False
+
+[bumpversion:file:setup.py]
+search = version="{current_version}"
+replace = version="{new_version}"
+
+[bumpversion:file:src/greynoise/__version__.py]
+search = __version__ = "{current_version}"
+replace = __version__ = "{new_version}"
+
+[bumpversion:file:docs/source/conf.py]
+search = release = "{current_version}"
+replace = release = "{new_version}"
+
+[bumpversion:file:CHANGELOG.rst:date]
+search = **Date**: unreleased
+replace = **Date**: {now:%B %d, %Y}
+
+[bumpversion:file:CHANGELOG.rst:version]
+search = `dev`
+replace = `{new_version}`
+
+[bumpversion:file:CHANGELOG.rst:version_range]
+search = {current_version}...HEAD
+replace = {current_version}...{new_version}
+

greynoise-3.0.0/.circleci/config.yml

@@ -0,0 +1,188 @@
+---
+version: 2.1
+
+TAGS_FILTER: &TAGS_FILTER
+  tags:
+    only: /v.*/
+
+workflows:
+  version: 2
+  build:
+    jobs:
+      - py38:
+          filters:
+            <<: *TAGS_FILTER
+      - py39:
+          filters:
+            <<: *TAGS_FILTER
+      - py310:
+          filters:
+            <<: *TAGS_FILTER
+      - py311:
+          filters:
+            <<: *TAGS_FILTER
+      - py312:
+          filters:
+            <<: *TAGS_FILTER
+      - sonarcloud:
+          requires:
+            # generate static analysis and coverage reports in py37 job
+            # and upload them to sonarcloud.io in sonarcloud job
+            - py39
+      - pypi:
+          requires:
+            # release to pypi only when test cases pass in all python versions
+            - py38
+            - py39
+            - py310
+            - py311
+            - py312
+          filters:
+            <<: *TAGS_FILTER
+            branches:
+              ignore: /.*/
+
+DEFAULT_STEPS: &DEFAULT_STEPS
+  - checkout
+  - run: &CREATE_VIRTUALENV_STEP
+      name: Create virtualenv
+      command: |
+        virtualenv venv
+        echo ". venv/bin/activate" >> $BASH_ENV
+  - run: &INSTALL_DEPENDENCIES_STEP
+      name: Install dependencies
+      command: |
+        pip install --upgrade pip
+        pip install -r requirements/test.txt -e .
+  - run:
+      name: Test cases
+      command: pytest --junitxml=workspace/test_results/pytest.xml tests
+  - store_test_results:
+      path: workspace/test_results
+
+jobs:
+  py310:
+    docker:
+      - image: cimg/python:3.10
+    steps:
+      - checkout
+      - run: *CREATE_VIRTUALENV_STEP
+      - run: *INSTALL_DEPENDENCIES_STEP
+      - run:
+          name: Style check (yamllint)
+          command: yamllint .
+      - run:
+          name: Style check (black)
+          command: black --check src tests docs
+      - run:
+          name: Style check (isort)
+          command: isort --check-only src/**/*.py tests/**/*.py docs/**/*.py
+      - run:
+          name: Style check (rst)
+          command: rst-lint *.rst
+      - run:
+          name: Static analysis (flake8)
+          command: flake8 src tests docs
+      - run:
+          name: Static analysis (pylint)
+          command: |
+            mkdir workspace
+            pylint \
+              --exit-zero \
+              --reports no \
+              --msg-template='{path}:{line}: [{msg_id}({symbol}), {obj}] {msg}' \
+              src > workspace/pylint.txt
+      - run:
+          name: Test cases
+          command: |
+            . venv/bin/activate
+            pytest \
+              --cov=greynoise \
+              --cov-report=xml:workspace/coverage/report.xml \
+              --junitxml=workspace/test_results/pytest.xml \
+              tests
+      - persist_to_workspace:
+          root: workspace
+          paths:
+            - pylint.txt
+            - coverage/report.xml
+            - test_results/pytest.xml
+      - store_test_results:
+          path: workspace/test_results
+
+  py38:
+    docker:
+      - image: cimg/python:3.8
+    steps: *DEFAULT_STEPS
+
+  py39:
+    docker:
+      - image: cimg/python:3.9
+    steps: *DEFAULT_STEPS
+
+  py311:
+    docker:
+      - image: cimg/python:3.11
+    steps: *DEFAULT_STEPS
+
+  py312:
+    docker:
+      - image: cimg/python:3.12
+    steps: *DEFAULT_STEPS
+
+  sonarcloud:
+    docker:
+      - image: cimg/openjdk:21.0
+    steps:
+      - checkout
+      - attach_workspace:
+          at: workspace
+      - run:
+          name: Setup environment variables
+          command: |
+            echo "SONAR_SCANNER_VERSION=4.5.0.2216" >> $BASH_ENV
+            echo \
+              'SONAR_SCANNER_HOME=$HOME/.sonar/sonar-scanner-$SONAR_SCANNER_VERSION' \
+              >> $BASH_ENV
+      - run:
+          name: Install sonar scanner
+          command: |
+            rm -rf $SONAR_SCANNER_HOME
+            mkdir -p $SONAR_SCANNER_HOME
+            curl \
+              -sSLo \
+              $HOME/.sonar/sonar-scanner.zip \
+              https://repo1.maven.org/maven2/org/sonarsource/scanner/cli/sonar-scanner-cli/$SONAR_SCANNER_VERSION/sonar-scanner-cli-$SONAR_SCANNER_VERSION.zip
+            unzip $HOME/.sonar/sonar-scanner.zip -d $HOME/.sonar/
+            rm $HOME/.sonar/sonar-scanner.zip
+      - run:
+          name: Run sonar scanner
+          command: |
+            export PATH=$SONAR_SCANNER_HOME/bin:$PATH
+            export SONAR_SCANNER_OPTS="-server"
+            sonar-scanner \
+              -Dsonar.login=$SONAR_AUTH_TOKEN \
+              -Dsonar.branch.name=$CIRCLE_BRANCH
+
+  pypi:
+    docker:
+      - image: cimg/python:3.10
+    steps:
+      - checkout
+      - run: *CREATE_VIRTUALENV_STEP
+      - run: *INSTALL_DEPENDENCIES_STEP
+      - run:
+          name: Install build dependencies
+          command: |
+            . venv/bin/activate
+            pip install build twine
+      - run:
+          name: Build packages
+          command: |
+            . venv/bin/activate
+            python -m build
+      - run:
+          name: Upload package to pypi
+          command: |
+            . venv/bin/activate
+            twine upload --username __token__ --disable-progress-bar dist/*

greynoise-3.0.0/.dockerignore

@@ -0,0 +1,10 @@
+# Version control
+.git
+
+# Documentation
+docs
+
+# Unit test / coverage reports
+.pytest_cache
+.tox
+htmlcov

greynoise-3.0.0/.editorconfig

@@ -0,0 +1,19 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+max_line_length = 100
+
+[{*.py,*.rst,tox.ini}]
+indent_style = space
+indent_size = 4
+
+[{*.yml,*.yaml,.yamllint}]
+indent_style = space
+indent_size = 2
+
+[Makefile]
+indent_style = tab

greynoise-3.0.0/.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# Github codeowners file to improve our lives when selecting users for PR's
+
+* @bradchiappetta @elliottminns @Obsecurus @superducktoes @nathanqthai @ianling
+
+/requirements/ @bradchiappetta

greynoise-3.0.0/.github/dependabot.yml

@@ -0,0 +1,13 @@
+---
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "pip"  # See documentation for possible values
+    directory: "/requirements/"  # Location of package manifests
+    target-branch: next-release
+    schedule:
+      interval: "weekly"

greynoise-3.0.0/.github/workflows/slack_release_notice.yml

@@ -0,0 +1,59 @@
+name: ReleaseNotice
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      # To check the github context
+      - name: Dump Github context
+        env:
+          GITHUB_CONTEXT: ${{ toJSON(github) }}
+        run: echo "$GITHUB_CONTEXT"
+      - name: Slack Notification on SUCCESS
+        if: success()
+        uses: tokorom/action-slack-incoming-webhook@main
+        env:
+          INCOMING_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
+        with:
+          text: A release is published.
+          blocks: |
+            [
+              {
+                "type": "header",
+                "text": {
+                  "type": "plain_text",
+                  "text": "GreyNoise SDK ${{ github.event.release.tag_name}} is published!"
+                }
+              },
+              {
+                "type": "section",
+                "text": {
+                  "type": "mrkdwn",
+                  "text": "*Author:*\n${{ github.actor }}"
+                }
+              },
+               {
+                "type": "section",
+                "text": {
+                  "type": "mrkdwn",
+                  "text": "*Information:*"
+                }
+              },
+              {
+                "type": "section",
+                "text": {
+                  "type": "mrkdwn",
+                  "text": ${{ toJSON(github.event.release.body) }}
+                }
+              },
+              {
+                "type": "section",
+                "text": {
+                  "type": "mrkdwn",
+                  "text": "${{ github.event.release.html_url }}"
+                }
+              }
+            ]

greynoise-3.0.0/.gitignore

@@ -0,0 +1,113 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+*.swp
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+venv_py2/
+venv3/
+ENV/
+bin/
+pyvenv.cfg
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# idea
+.idea/
+workspace/
+
+.DS_Store

greynoise-3.0.0/.pre-commit-config.yaml

@@ -0,0 +1,34 @@
+---
+repos:
+  - repo: local
+    hooks:
+      - id: yamllint
+        name: Style check (yamllint)
+        entry: yamllint
+        language: system
+        types:
+          - yaml
+      - id: black
+        name: Style check (black)
+        entry: black
+        language: system
+        types:
+          - python
+      - id: isort
+        name: Style check (isort)
+        entry: isort
+        language: system
+        types:
+          - python
+      - id: flake8
+        name: Static analysis (flake8)
+        entry: flake8
+        language: system
+        types:
+          - python
+  - repo: https://github.com/adrienverge/yamllint.git
+    rev: v1.17.0
+    hooks:
+      - id: yamllint
+        language: system
+        args: [-c=.yamllint]

greynoise-3.0.0/.readthedocs.yml

@@ -0,0 +1,12 @@
+---
+version: 2
+sphinx:
+  builder: html
+  configuration: docs/source/conf.py
+
+python:
+  version: 3.7
+  install:
+    - requirements: requirements/docs.txt
+    - method: pip
+      path: .

greynoise-3.0.0/.yamllint

@@ -0,0 +1,9 @@
+---
+
+extends: default
+
+rules:
+  line-length:
+    max: 100
+
+ignore-from-file: .gitignore

{greynoise-2.3.0 → greynoise-3.0.0}/CHANGELOG.rst

@@ -2,6 +2,43 @@
 Changelog
 =========
 
+Version `3.0.0`_
+================
+**Date**: June 02, 2025
+
+* BREAKING CHANGES:
+
+  * The `riot` command is deprecated and will be removed in a future version.
+    Please use `ip` command instead.
+  * Removed support for Python 3.6 and 3.7
+  * Many schema changes to the API responses for the `ip`, `ip-multi`, and
+    `query` commands
+  * Updated API endpoints to v3 for `ip`, `ip-multi`, `quick`, and `query` commands
+  * Updated Python version requirements to support Python 3.8 through 3.12
+  * SDK now uses `api_config` object to initialize the API client
+  * Use modern packaging metadata with pyproject.toml instead of setup.cfg
+
+* API client:
+
+  * Update `ip`, `ip-multi`, `quick`, and `query` commands to use new v3 endpoints
+  * Update `ip`, `ip-multi`, `quick`, and `query` commands to return `business_service_intelligence` and
+    `internet_scanner_intelligence` attributes
+  * Added thread support for multi-lookup requests
+  * Added `api_config` object to initialize the API client
+
+* CLI:
+
+  * Update `ip`, `ip-multi`, `quick`, and `query` commands to support new attributes
+
+* Dependencies:
+
+  * Updated `Click` to version 8.1.8
+  * Updated `cachetools` to version 5.5.2
+  * Updated `dict2xml` to version 1.7.6
+  * Updated `jinja2` to version 3.1.6
+  * Updated `more-itertools` to version 10.7.0
+  * Updated `six` to version 1.17.0
+
 Version `2.3.0`_
 ================
 **Date**: July 30, 2024
@@ -429,4 +466,5 @@ Version `0.2.0`_
 .. _`2.0.1`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v2.0.0...2.0.1
 .. _`2.1.0`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v2.0.1...2.1.0
 .. _`2.2.0`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v2.1.0...2.2.0
-.. _`2.3.0`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v2.2.0...HEAD
+.. _`2.3.0`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v2.2.0...2.3.0
+.. _`3.0.0`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v2.3.0...HEAD

greynoise-3.0.0/Dockerfile

@@ -0,0 +1,9 @@
+FROM python:3.7-alpine as builder
+COPY . /app
+WORKDIR /app
+RUN pip install -r requirements/common.txt && python3 setup.py bdist_wheel
+
+FROM python:3.7-alpine
+COPY --from=builder /app/dist/*.whl /app/
+WORKDIR /app
+RUN pip install /app/*.whl

greynoise-3.0.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: greynoise
+Version: 3.0.0
+Summary: Abstraction to interact with GreyNoise API.
+Project-URL: Homepage, https://greynoise.io/
+Project-URL: Repository, https://github.com/GreyNoise-Intelligence/pygreynoise
+Project-URL: Documentation, https://greynoise.io/
+Author-email: GreyNoise Intelligence <support@greynoise.io>
+License: MIT
+License-File: LICENSE
+Keywords: internet,scanning,security,threat intelligence
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Requires-Dist: ansimarkup
+Requires-Dist: cachetools
+Requires-Dist: click-default-group
+Requires-Dist: click-repl
+Requires-Dist: click<=8.1.8
+Requires-Dist: colorama
+Requires-Dist: dict2xml
+Requires-Dist: jinja2
+Requires-Dist: more-itertools>=8.14.0
+Requires-Dist: requests
+Requires-Dist: six
+Description-Content-Type: text/x-rst
+
+================
+Python GreyNoise
+================
+
+.. image:: https://circleci.com/gh/GreyNoise-Intelligence/pygreynoise.svg?style=shield
+    :target: https://circleci.com/gh/GreyNoise-Intelligence/pygreynoise
+
+.. image:: https://sonarcloud.io/api/project_badges/measure?project=GreyNoise-Intelligence_pygreynoise&metric=coverage
+    :target: https://sonarcloud.io/dashboard?id=GreyNoise-Intelligence_pygreynoise
+
+.. image:: https://readthedocs.org/projects/greynoise/badge/?version=latest
+    :target: http://greynoise.readthedocs.io/en/latest/?badge=latest
+
+.. image:: https://badge.fury.io/py/greynoise.svg
+    :target: https://badge.fury.io/py/greynoise
+
+.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
+    :target: https://opensource.org/licenses/MIT
+
+.. image:: https://quay.io/repository/greynoiseintel/pygreynoise/status
+    :target: https://quay.io/repository/greynoiseintel/pygreynoise
+
+This is an abstract python library built on top of the `GreyNoise`_ service. It is preferred that users use this library when implementing integrations or plan to use GreyNoise within their code. The library includes a small client to interact with the API.
+
+.. _GreyNoise: https://greynoise.io/
+
+Documentation
+=============
+Documentation is available here: `Documentation`_
+
+.. _Documentation: https://developer.greynoise.io/docs/libraries-sample-code
+
+Quick Start
+===========
+**Install the library**:
+
+``pip install greynoise`` or ``python setup.py install``
+
+**Save your configuration**:
+
+``greynoise setup --api-key <your-API-key>``
+
+Versioning
+==========
+This python package follows semantic versioning. According to this:
+
+* We will NEVER push a breaking change without a major version release.
+* We will only add new features and/or bug fixes with minor version releases.
+* We will only do bug fixes for patch version release.
+
+As such, we recommend you pin the dependency on this SDK to only allow minor version changes at most:
+
+::
+
+    # allow patch version increments
+    greynoise~=1.4.0
+
+    # allow minor version increments
+    greynoise~=1.4
+
+
+Usage
+=====
+::
+
+    Usage: greynoise [OPTIONS] COMMAND [ARGS]...
+
+      GreyNoise CLI.
+
+    Options:
+      -h, --help  Show this message and exit.
+
+    Commands:
+      account         View information about your GreyNoise account.
+      alerts          List, create, delete, and manage your GreyNoise alerts.
+      analyze         Analyze the IP addresses in a log file, stdin, etc.
+      feedback        Send feedback directly to the GreyNoise team.
+      filter          Filter the noise from a log file, stdin, etc.
+      help            Show this message and exit.
+      interesting     Report one or more IP addresses as "interesting".
+      ip              Query GreyNoise for all information on a given IP.
+      ip-multi        Perform Context lookup for multiple IPs at once.
+      query           Run a GNQL (GreyNoise Query Language) query.
+      quick           Quickly check whether or not one or many IPs are "noise".
+      repl            Start an interactive shell.
+      riot            Query GreyNoise IP to see if it is in the RIOT dataset.
+      setup           Configure API key.
+      signature       Submit an IDS signature to GreyNoise to be deployed to...
+      similar         Query GreyNoise IP to identify Similar IPs.
+      stats           Get aggregate stats from a given GNQL query.
+      timeline        Query GreyNoise IP to identify Similar IPs.
+      timelinehourly  Query GreyNoise IP to identify Similar IPs.
+      version         Get version and OS information for your GreyNoise...
+
+