Fixes help, graphics in 17+, completions, misc version issues (#443)

* Manually bumped to 1.12.3

* Bump version: 1.12.3 → 1.13.0

* Fix various Stata 17+ incompatibility issues

- Closes #426: Pass user-agent via header to fetch %help
- Closes #428: Display graphs with Stata 17+
- Closes #420: Use 'importlib.resources' insteadof 'pkg_resources'
- Autocompletions work in notebooks (empty 'metadata' field passed internally)
- Tentative: Various dependency updates.

* Minor linter 'fixes'

* Updated changelog, bumpver to pyproject.toml

* bump version 1.13.0 → 1.14.0

* Updated ubuntu version for tests

* Debugging ubuntu version

* Debugging python 3.10 read as 3.1

* Updated poetry version

* Updated poetry version

Author: mcaceresb

.github/workflows/test.yml

@@ -11,10 +11,10 @@ on:
 
 jobs:
   tests:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
-        python-version: [3.6, 3.7, 3.8, 3.9]
+        python-version: ['3.9', '3.10', '3.11']
 
     steps:
       - uses: actions/checkout@v2
@@ -27,7 +27,7 @@ jobs:
       - name: Set up Poetry
         uses: snok/install-poetry@v1
         with:
-          version: 1.1.10
+          version: 1.8.1
 
       - name: Install dependencies
         run: |

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.14.0] - 2025-08-27
+
+- %help works by passing user-agent via headers (#426).
+- Graphics work for Stata 17+ (#428).
+- Use `importlib.resources` insteadof `pkg_resources` (#420).
+- Autocompletions work on notebooks (pass empty 'metadata' field internally).
+
 ## [1.12.3] - 2021-02-25
 
 - Simplify kernel installation for conda environments

poetry.lock

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "stata_kernel"
-version = "1.13.0"
+version = "1.14.0"
 description = "A Jupyter kernel for Stata. Works with Windows, macOS, and Linux."
 authors = [
     "Kyle Barron <[email protected]>",
@@ -19,38 +19,55 @@ classifiers = [
     'Operating System :: Microsoft :: Windows',
     'Operating System :: POSIX :: Linux',
     'Operating System :: Unix',
-    'Programming Language :: Python :: 3.6',
-    'Programming Language :: Python :: 3.7',
-    'Programming Language :: Python :: 3.8',
     'Programming Language :: Python :: 3.9',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
 ]
 keywords = ["stata"]
 repository = "https://github.com/kylebarron/stata_kernel"
 documentation = "https://kylebarron.dev/stata_kernel/"
 
 [tool.poetry.dependencies]
-python = "^3.6.1"
+python = "^3.9.0"
 beautifulsoup4 = "^4.6.3"
-pandas = "^1.0"
+pandas = ">=1.0"
+numpy = ">=1.22.0"
 pygments = "^2.2"
 pexpect = "^4.6.0"
-requests = "^2.19.1"
-jupyter-client = "^5.2.3"
-IPython = "^7.16.3"
-ipykernel = "^4.8.2"
 packaging = "^17.1"
 pillow = ">=5.2.0"
 pywin32 = { version = ">=223", platform = "Windows" }
+fake-useragent = "^2.0.0"
+IPython = "^7.34"
+ipykernel = "^4.8.2"
+jupyter-client = "^6.1.12"
+jupyter-core = "^5.8.1"
+notebook = "^6.5.7"
+nbclient = "^0.8"
+setuptools = "<81"
 
 [tool.poetry.dev-dependencies]
 bumpversion = "^0.6"
 mkdocs-material = ">=3.0.3"
 mkdocs = ">=1.0"
 yapf = ">=0.20.2"
 pytest = ">=3.7.1"
-# importlib-metadata==0.23
-# jupyter_kernel_test==0.3.0
+jupyter_kernel_test = "0.3.0"
 
 [build-system]
-requires = ["poetry-core>=1.1.10"]
+requires = ["poetry-core>=1.8.1"]
 build-backend = "poetry.core.masonry.api"
+
+[tool.bumpver]
+current_version = "1.14.0"
+version_pattern = "MAJOR.MINOR.PATCH"
+commit = true
+tag = true
+commit_message = "bump version {old_version} → {new_version}"
+tag_message = "{new_version}"
+
+[tool.bumpver.file_patterns]
+"setup.cfg" = ['current_version = {version}']
+"stata_kernel/kernel.py" = ["implementation_version = '{version}'"]
+"stata_kernel/__init__.py" = ["__version__ = '{version}'"]
+"pyproject.toml" = ['version = "{version}"']

pyproject.toml

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.13.0
+current_version = 1.14.0
 commit = True
 tag = True
 

setup.cfg

@@ -1,3 +1,3 @@
 """An example Jupyter kernel"""
 
-__version__ = '1.13.0'
+__version__ = '1.14.0'

stata_kernel/__init__.py

@@ -3,6 +3,7 @@
 
 from bs4 import BeautifulSoup as bs
 import urllib
+import urllib.request
 import re
 import os
 

stata_kernel/docs/make_href

@@ -7,7 +7,7 @@
 from shutil import copyfile
 from pathlib import Path
 from textwrap import dedent
-from pkg_resources import resource_filename
+from importlib.resources import files
 from IPython.utils.tempdir import TemporaryDirectory
 from jupyter_client.kernelspec import KernelSpecManager
 
@@ -31,7 +31,7 @@ def install_my_kernel_spec(user=True, prefix=None):
             json.dump(kernel_json, f, sort_keys=True)
 
         # Copy logo to tempdir to be installed with kernelspec
-        logo_path = resource_filename('stata_kernel', 'docs/logo-64x64.png')
+        logo_path = files('stata_kernel').joinpath('docs/logo-64x64.png')
         copyfile(logo_path, os.path.join(td, 'logo-64x64.png'))
 
         print('Installing Jupyter kernel spec')

stata_kernel/install.py

@@ -10,7 +10,7 @@
 from textwrap import dedent
 from datetime import datetime
 from xml.etree import ElementTree as ET
-from pkg_resources import resource_filename
+from importlib.resources import files
 from ipykernel.kernelbase import Kernel
 
 from .config import config
@@ -22,7 +22,7 @@
 
 class StataKernel(Kernel):
     implementation = 'stata_kernel'
-    implementation_version = '1.13.0'
+    implementation_version = '1.14.0'
     language = 'stata'
     language_info = {
         'name': 'stata',
@@ -38,13 +38,12 @@ class StataKernel(Kernel):
     def __init__(self, *args, **kwargs):
         # Copy syntax highlighting files
         from_paths = [
-            Path(resource_filename('stata_kernel', 'pygments/stata.py')),
-            Path(resource_filename('stata_kernel', 'codemirror/stata.js'))]
+            Path(files('stata_kernel').joinpath('pygments/stata.py')),
+            Path(files('stata_kernel').joinpath('codemirror/stata.js'))]
         to_paths = [
-            Path(resource_filename('pygments', 'lexers/stata.py')),
+            Path(files('pygments').joinpath('lexers/stata.py')),
             Path(
-                resource_filename(
-                    'notebook',
+                files('notebook').joinpath(
                     'static/components/codemirror/mode/stata/stata.js'))]
 
         for from_path, to_path in zip(from_paths, to_paths):
@@ -355,6 +354,7 @@ def do_complete(self, code, cursor_pos):
             self.sc_delimit_mode, self.stata.mata_mode)
 
         return {
+            'metadata': {},
             'status': 'ok',
             'cursor_start': pos,
             'cursor_end': cursor_pos,
@@ -400,7 +400,7 @@ def cleanTail(self, tail, rprompt):
                     fh.seek(pos + 1, os.SEEK_SET)
                     fh.truncate()
 
-    def do_inspect(self, code, cursor_pos, detail_level=0):
+    def do_inspect(self, code, cursor_pos, detail_level=0, metadata={}):
         inspect_keyword = re.compile(
             r'\b(?P<keyword>\w+)\(?\s*$', flags=re.MULTILINE).search
 
@@ -445,6 +445,6 @@ def do_inspect(self, code, cursor_pos, detail_level=0):
             'found': found,
             # data can be empty if nothing is found
             'data': data,
-            'metadata': {}}
+            'metadata': metadata}
 
         return content

stata_kernel/kernel.py

@@ -143,9 +143,9 @@ class StataLexer(RegexLexer):
         ],
         # Built in functions and statements
         'keywords': [
-            (words(builtins_functions, prefix = r'\b', suffix = r'(?=\()'),
+            (words(builtins_functions, prefix=r'\b', suffix=r'(?=\()'),
              Name.Function),
-            (words(builtins_base, prefix = r'(^\s*|\s)', suffix = r'\b'),
+            (words(builtins_base, prefix=r'(^\s*|\s)', suffix=r'\b'),
              Keyword),
         ],
         # http://www.stata.com/help.cgi?operators