greynoise 3.0.2__tar.gz → 3.1.0__tar.gz

{greynoise-3.0.2 → greynoise-3.1.0}/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.0.2
+current_version = 3.1.0
 tag = False
 commit = False
 

{greynoise-3.0.2 → greynoise-3.1.0}/.circleci/config.yml

@@ -68,7 +68,7 @@ jobs:
           command: yamllint .
       - run:
           name: Style check (black)
-          command: black --check src tests docs
+          command: black --check --target-version py310 src tests docs
       - run:
           name: Style check (isort)
           command: isort --check-only src/**/*.py tests/**/*.py docs/**/*.py

{greynoise-3.0.2 → greynoise-3.1.0}/.gitignore

@@ -89,6 +89,7 @@ celerybeat-schedule
 venv/
 venv_py2/
 venv3/
+venv312/
 ENV/
 bin/
 pyvenv.cfg
@@ -111,3 +112,5 @@ pyvenv.cfg
 workspace/
 
 .DS_Store
+.vscode/
+scratch.py

{greynoise-3.0.2 → greynoise-3.1.0}/.pre-commit-config.yaml

@@ -14,6 +14,7 @@ repos:
         language: system
         types:
           - python
+        args: [--target-version, py310]
       - id: isort
         name: Style check (isort)
         entry: isort

{greynoise-3.0.2 → greynoise-3.1.0}/CHANGELOG.rst

@@ -2,6 +2,50 @@
 Changelog
 =========
 
+Version `3.1.0`_
+================
+**Date**: unreleased
+
+* API client:
+
+  * Added `psychic_lookup`, `psychic_lookup_ips`, `psychic_stats` functions to support Psychic API endpoints
+  * Added `psychic_download_mmdb`, `psychic_download_bin`, `psychic_download_csv`, `psychic_generate_bitmap` functions to support Psychic file downloads
+  * Added `cves` function to support bulk CVE lookup API endpoints
+  * Added `callback_ip`, `callback_list`, `callback_export_ips`, `callback_overview` functions to support Callback API endpoints
+  * Added `recall`, `recall_stats`, `recall_timeseries` functions to support Recall API endpoints
+  * Updated the `timeline` and `timelinehourly` function
+  * Updated the `filter` function to correctly handle v3 API response format
+  * The `tags` function is now used instead of `metadata`, but is still available for backwards compatibility.
+  * The `similar` function is deprecated and will be removed in a future version.
+  * The `sensor_activity` and `sensor_activity_ips` functions are deprecated and will be removed in a future version.
+  * The `timelinehourly` function is deprecated and will be removed in a future version.
+
+* CLI:
+  * Added `psychic-download` and `psychic-generate` commands to support Psychic file downloads
+  * Updated `ip` command to support Psychic API endpoints with new `-p/--psychic` option
+  * Added `callback` commands to support Callback API endpoints
+  * Added `recall` commands to support Recall API endpoints
+  * Removed `sensor-activity` command as it is deprecated and will be removed in a future version.
+  * Removed `timelinehourly` command as it is deprecated and will be removed in a future version.
+  * Removed not implemented commands `alerts`, `account`, `feedback`, `signature`, `interesting`.
+
+* Dependencies:
+  * Updated `requests` to version 2.34.2
+  * Updated `more-itertools` to version 11.1.0
+  * Updated `cachetools` to version 7.0.5
+  * Updated `Click` to version 8.3.1
+  * Updated `ansimarkup` to version 2.2.0
+  * Updated `dict2xml` to version 1.7.8
+  * Added `maxminddb` to version 3.1.1
+
+Version `3.0.3`_
+================
+**Date**: May 15, 2026
+
+* API client:
+  * Add `exclude_fields` parameter to `query` command
+  * Update `stats` to use v3 endpoint
+
 Version `3.0.2`_
 ================
 **Date**: March 10, 2026
@@ -483,4 +527,6 @@ Version `0.2.0`_
 .. _`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...v3.0.0
 .. _`3.0.1`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v3.0.0...v3.0.1
-.. _`3.0.2`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v3.0.1...HEAD
+.. _`3.0.2`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v3.0.1...v3.0.2
+.. _`3.0.3`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v3.0.2...v3.0.3
+.. _`3.1.0`: https://github.com/GreyNoise-Intelligence/pygreynoise/compare/v3.0.3...HEAD

{greynoise-3.0.2 → greynoise-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greynoise
-Version: 3.0.2
+Version: 3.1.0
 Summary: Abstraction to interact with GreyNoise API.
 Project-URL: Homepage, https://greynoise.io/
 Project-URL: Repository, https://github.com/GreyNoise-Intelligence/pygreynoise
@@ -22,17 +22,27 @@ 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
+Requires-Dist: ansimarkup==2.2.0
+Requires-Dist: cachetools==5.5.2; python_version == '3.8'
+Requires-Dist: cachetools==6.2.6; python_version == '3.9'
+Requires-Dist: cachetools==7.0.5; python_version >= '3.10'
+Requires-Dist: click-default-group==1.2.4
+Requires-Dist: click-repl==0.3.0
+Requires-Dist: click<=8.1.8; python_version < '3.10'
+Requires-Dist: click==8.4.1; python_version >= '3.10'
+Requires-Dist: colorama==0.4.6
+Requires-Dist: dict2xml==1.7.8
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: maxminddb==2.6.3; python_version == '3.8'
+Requires-Dist: maxminddb==2.8.2; python_version == '3.9'
+Requires-Dist: maxminddb==3.1.1; python_version >= '3.10'
+Requires-Dist: more-itertools==10.5.0; python_version == '3.8'
+Requires-Dist: more-itertools==10.8.0; python_version == '3.9'
+Requires-Dist: more-itertools==11.1.0; python_version >= '3.10'
+Requires-Dist: requests==2.32.4; python_version == '3.8'
+Requires-Dist: requests==2.32.5; python_version == '3.9'
+Requires-Dist: requests==2.34.2; python_version >= '3.10'
+Requires-Dist: six==1.17.0
 Description-Content-Type: text/x-rst
 
 ================

{greynoise-3.0.2 → greynoise-3.1.0}/docs/source/conf.py

@@ -25,7 +25,7 @@ copyright = "2018-2025, GreyNoise Intelligence"
 author = "GreyNoise Intelligence"
 
 # The full version, including alpha/beta/rc tags
-release = "3.0.2"
+release = "3.1.0"
 
 
 # -- General configuration ---------------------------------------------------

{greynoise-3.0.2 → greynoise-3.1.0}/docs/source/sample.py

@@ -2,9 +2,7 @@ from greynoise.api import APIConfig, GreyNoise
 
 api_key = "<enter-api-key-here>"
 ip_addresses = ["108.168.3.151", "8.8.8.8", "318.1.1.1"]
-api_config = APIConfig(
-    api_key=api_key, integration_name="greynoise-sampleapp-v1.0.0-beta"
-)
+api_config = APIConfig(api_key=api_key, integration_name="greynoise-sampleapp-v1.0.0-beta")
 api_client = GreyNoise(api_config)
 
 for ip_address in ip_addresses:

{greynoise-3.0.2 → greynoise-3.1.0}/docs/source/tutorial.rst

@@ -752,36 +752,31 @@ subcommands, use the *--help* option::
     $ greynoise -h
     Usage: greynoise [OPTIONS] COMMAND [ARGS]...
 
-    GreyNoise CLI.
+      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.
-      cve              Retrieve Details of a CVE.
-      feedback         Send feedback directly to the GreyNoise team.
-      filter           Filter the noise from a log file, stdin, etc.
-      help             Show this message and exit.
-      ip               Query GreyNoise for all information on a given IP.
-      ip-multi         Perform Context lookup for multiple IPs at once.
-      persona-details  Retrieve Details of a Sensor Persona.
-      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.
-      sensor-activity  Retrieve Sensor Activity.
-      sensor-list      Retrieve list of current Sensors in Workspace.
-      setup            Configure API client.
-      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 Timeline for events based on a...
-      timelinedaily    Query GreyNoise IP Timeline to get daily event details.
-      timelinehourly   Query GreyNoise IP Timeline to get hourly event details.
-      version          Get version and OS information for your GreyNoise...
+      analyze           Analyze the IP addresses in a log file, stdin, etc.
+      callback          GreyNoise Callback — scanner callback intelligence...
+      cve               Retrieve Details of a CVE.
+      filter            Filter the noise from a log file, stdin, etc.
+      help              Show this message and exit.
+      ip                Query GreyNoise for all information on a given IP.
+      ip-multi          Perform Context lookup for multiple IPs at once.
+      persona-details   Retrieve Details of a Sensor Persona.
+      psychic-download  Download a Psychic bitmap (.bin), MMDB, or CSV file...
+      query             Run a GNQL (GreyNoise Query Language) query.
+      quick             Quickly check whether or not one or many IPs are...
+      recall            GreyNoise Recall — GNQL activity over time.
+      repl              Start an interactive shell.
+      sensor-list       Retrieve list of current Sensors in Workspace.
+      setup             Configure API client.
+      stats             Get aggregate stats from a given GNQL query.
+      timeline          Query GreyNoise IP Timeline for events based on a...
+      timelinedaily     Query GreyNoise IP Timeline to get daily event details.
+      version           Get version and OS information for your GreyNoise...
 
 
 Setup

{greynoise-3.0.2 → greynoise-3.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "greynoise"
-version = "3.0.2"
+version = "3.1.0"
 description = "Abstraction to interact with GreyNoise API."
 readme = {file = "README.rst", content-type = "text/x-rst"}
 requires-python = ">=3.8"
@@ -28,17 +28,27 @@ classifiers = [
 ]
 keywords = ["internet", "scanning", "threat intelligence", "security"]
 dependencies = [
-    "Click<=8.1.8",
-    "ansimarkup",
-    "cachetools",
-    "colorama",
-    "click-default-group",
-    "click-repl",
-    "dict2xml",
-    "jinja2",
-    "more-itertools>=8.14.0",
-    "requests",
-    "six",
+    "Click<=8.1.8; python_version < '3.10'",
+    "Click==8.4.1; python_version >= '3.10'",
+    "ansimarkup==2.2.0",
+    "cachetools==5.5.2; python_version == '3.8'",
+    "cachetools==6.2.6; python_version == '3.9'",
+    "cachetools==7.0.5; python_version >= '3.10'",
+    "colorama==0.4.6",
+    "click-default-group==1.2.4",
+    "click-repl==0.3.0",
+    "dict2xml==1.7.8",
+    "jinja2==3.1.6",
+    "maxminddb==2.6.3; python_version == '3.8'",
+    "maxminddb==2.8.2; python_version == '3.9'",
+    "maxminddb==3.1.1; python_version >= '3.10'",
+    "more-itertools==10.5.0; python_version == '3.8'",
+    "more-itertools==10.8.0; python_version == '3.9'",
+    "more-itertools==11.1.0; python_version >= '3.10'",
+    "requests==2.32.4; python_version == '3.8'",
+    "requests==2.32.5; python_version == '3.9'",
+    "requests==2.34.2; python_version >= '3.10'",
+    "six==1.17.0",
 ]
 
 [project.urls]
@@ -53,4 +63,8 @@ greynoise = "greynoise.cli:main"
 packages = ["src/greynoise"]
 
 [tool.hatch.build.targets.wheel.shared-data]
-"src/greynoise/cli/templates/*.j2" = "greynoise/cli/templates" 
+"src/greynoise/cli/templates/*.j2" = "greynoise/cli/templates"
+
+[tool.black]
+line-length = 120
+target-version = ["py310"]

greynoise-3.1.0/requirements/common.txt

@@ -0,0 +1,22 @@
+Click<=8.1.8;python_version=="3.8"
+Click<=8.1.8;python_version=="3.9"
+Click==8.4.1;python_version>="3.10"
+ansimarkup==2.2.0
+cachetools==5.5.2;python_version=="3.8"
+cachetools==6.2.6;python_version=="3.9"
+cachetools==7.0.5;python_version>="3.10"
+colorama==0.4.6
+click-default-group==1.2.4
+click-repl==0.3.0
+dict2xml==1.7.8;python_version>='3'
+jinja2==3.1.6
+maxminddb==2.6.3;python_version=="3.8"
+maxminddb==2.8.2;python_version=="3.9"
+maxminddb==3.1.1;python_version>="3.10"
+more-itertools==10.5.0;python_version=="3.8"
+more-itertools==10.8.0;python_version=="3.9"
+more-itertools==11.1.0;python_version>="3.10"
+requests==2.32.4;python_version=="3.8"
+requests==2.32.5;python_version=="3.9"
+requests==2.34.2;python_version>="3.10"
+six==1.17.0

greynoise-3.1.0/requirements/dev.txt

@@ -0,0 +1,11 @@
+# Requirements needed to develop the application
+-r test.txt
+advbumpversion==1.2.0
+ipython==8.13.0;python_version=="3.8"
+ipython==8.18.1;python_version=="3.9"
+ipython==8.38.0;python_version=="3.10"
+ipython==9.10.0;python_version=="3.11"
+ipython==9.12.0;python_version>="3.12"
+tox==4.25.0;python_version=="3.8"
+tox==4.30.3;python_version=="3.9"
+tox==4.52.0;python_version>="3.10"

greynoise-3.1.0/requirements/docs.txt

@@ -0,0 +1,11 @@
+# Requirements needed to build the documentation
+-r common.txt
+Sphinx==7.1.2;python_version=="3.8"
+Sphinx==7.4.7;python_version=="3.9"
+Sphinx==8.1.3;python_version=="3.10"
+Sphinx==9.0.4;python_version=="3.11"
+Sphinx==9.1.0;python_version>="3.12"
+sphinx-click==6.0.0;python_version=="3.8"
+sphinx-click==6.0.0;python_version=="3.9"
+sphinx-click==6.2.0;python_version>="3.10"
+sphinx-rtd-theme==3.1.0

greynoise-3.1.0/requirements/test.txt

@@ -0,0 +1,23 @@
+black==24.8.0;python_version=="3.8"
+black==25.11.0;python_version=="3.9"
+black==26.3.1;python_version>="3.10"
+flake8==7.1.2;python_version=="3.8"
+flake8==7.3.0;python_version>="3.9"
+isort==5.13.2;python_version=="3.8"
+isort==6.1.0;python_version=="3.9"
+isort==8.0.1;python_version>="3.10"
+mock==5.2.0
+pylint==3.2.7;python_version=="3.8"
+pylint==3.3.9;python_version=="3.9"
+pylint==4.0.5;python_version>="3.10"
+pytest-cov==5.0.0;python_version=="3.8"
+pytest-cov==7.1.0;python_version>="3.9"
+pytest==8.3.5;python_version=="3.8"
+pytest==8.4.2;python_version=="3.9"
+pytest==9.0.3;python_version>="3.10"
+restructuredtext-lint==2.0.2
+twine==6.1.0;python_version=="3.8"
+twine==6.2.0;python_version>="3.9"
+yamllint==1.35.1;python_version=="3.8"
+yamllint==1.37.1;python_version=="3.9"
+yamllint==1.38.0;python_version>="3.10"

{greynoise-3.0.2 → greynoise-3.1.0}/reset_changelog.py

@@ -43,10 +43,9 @@ if not match:
         )
         f.seek(0)
         f.write(text)
-        LINK_STRING = (
-            ".. _`dev`: https://github.com/GreyNoise-Intelligence/pygreynoise/"
-            "compare/v{}...HEAD"
-        ).format(ver)
+        LINK_STRING = (".. _`dev`: https://github.com/GreyNoise-Intelligence/pygreynoise/" "compare/v{}...HEAD").format(
+            ver
+        )
         f.write(LINK_STRING)
         f.truncate()
 else:

{greynoise-3.0.2 → greynoise-3.1.0}/setup.cfg

@@ -1,13 +1,13 @@
 [flake8]
-max-line-length = 88
+max-line-length = 120
 max-complexity = 10
-ignore = C901,W503
+ignore = C901,W503,E203
 
 [isort]
 multi_line_output = 3
 include_trailing_comma = True
 use_parentheses = True
-line_length = 88
+line_length = 120
 
 [tool:pytest]
 addopts = --pdbcls=IPython.terminal.debugger:TerminalPdb

{greynoise-3.0.2 → greynoise-3.1.0}/src/greynoise/__init__.py

@@ -10,4 +10,10 @@ from greynoise.__version__ import (  # noqa
     __status__,
     __version__,
 )
+
+USER_AGENT = "GreyNoise/{}".format(__version__)
+PSYCHIC_USER_AGENT = "{} (psychic)".format(USER_AGENT)
+
 from greynoise.api import GreyNoise  # noqa
+from greynoise.greynoise_timeline import get_greynoise_timeline  # noqa
+from greynoise.psychic import Psychic  # noqa

{greynoise-3.0.2 → greynoise-3.1.0}/src/greynoise/__version__.py

@@ -5,4 +5,4 @@ __license__ = "MIT"
 __maintainer__ = "GreyNoise Intelligence"
 __email__ = "support@greynoise.io"
 __status__ = "BETA"
-__version__ = "3.0.2"
+__version__ = "3.1.0"