Do not depend on pkg_resources module (#42)

Generate code for `wcwidth/unicode_versions.py`, delete `wcwidth/version.json`, and all references to it.

Author: jquast

.pylintrc

@@ -9,7 +9,7 @@ load-plugins=
 persistent = no
 jobs = 0
 unsafe-load-any-extension = yes
-good-names = wc
+good-names = wc,fp
 
 [MESSAGES CONTROL]
 disable=

bin/new-wide-by-version.py

@@ -15,8 +15,8 @@
 previous version (4.1.0).
 """
 # std imports
-import json
 import sys
+import json
 
 
 # List new WIDE characters at each unicode version.

bin/run_codecov.py

@@ -1,23 +1,18 @@
-"""
-Workaround for https://github.com/codecov/codecov-python/issues/158
-"""
+"""Workaround for https://github.com/codecov/codecov-python/issues/158."""
 
 # std imports
 import sys
 import time
 
-# local
+# 3rd party
 import codecov
 
 RETRIES = 5
 TIMEOUT = 2
 
 
 def main():
-    """
-    Run codecov up to RETRIES times
-    On the final attempt, let it exit normally
-    """
+    """Run codecov up to RETRIES times On the final attempt, let it exit normally."""
 
     # Make a copy of argv and make sure --required is in it
     args = sys.argv[1:]

bin/update-tables.py

@@ -62,7 +62,7 @@ def main():
     do_east_asian(versions)
     do_zero_width(versions)
     do_rst_file_update()
-    do_version_json(versions)
+    do_unicode_versions(versions)
 
 
 def get_unicode_versions():
@@ -297,18 +297,37 @@ def do_write_table(fname, variable, table):
     print("complete.")
 
 
-def do_version_json(versions):
-    fname = os.path.join(PATH_CODE, 'version.json')
+def do_unicode_versions(versions):
+    """Write unicode_versions.py function list_versions()."""
+    fname = os.path.join(PATH_CODE, 'unicode_versions.py')
     print(f"writing {fname} ... ", end='')
 
-    with open(fname, 'r') as fp:
-        version_data = json.load(fp)
+    utc_now = datetime.datetime.utcnow()
+    version_tuples_str = '\n        '.join(
+        f'"{ver}",' for ver in versions)
+    with open(fname, 'w') as fp:
+        fp.write(f"""\"\"\"
+Exports function list_versions() for unicode version level support.
 
-    version_data['tables'] = versions
+This code generated by {__file__} on {utc_now}.
+\"\"\"
 
-    with open(fname, 'w') as fp:
-        json.dump(version_data, fp)
-    print()
+
+def list_versions():
+    \"\"\"
+    Return Unicode version levels supported by this module release.
+
+    Any of the version strings returned may be used as keyword argument
+    ``unicode_version`` to the ``wcwidth()`` family of functions.
+
+    :returns: Supported Unicode version numbers in ascending sorted order.
+    :rtype: list[str]
+    \"\"\"
+    return (
+        {version_tuples_str}
+    )
+""")
+        print('done.')
 
 
 if __name__ == '__main__':

bin/wcwidth-browser.py

@@ -489,7 +489,7 @@ def _process_keystroke_movement(self, inp, idx, offset):
             # scroll backward 1 line
             offset -= self.screen.num_columns
         elif inp in ('e', 'j') or inp.code in (term.KEY_ENTER,
-                                                 term.KEY_DOWN,):
+                                               term.KEY_DOWN,):
             # scroll forward 1 line
             offset = offset + self.screen.num_columns
         elif inp in ('f', ' ') or inp.code in (term.KEY_PGDOWN,):

setup.py

@@ -16,11 +16,6 @@ def _get_here(fname):
     return os.path.join(os.path.dirname(__file__), fname)
 
 
-def _get_version(fname, key='package'):
-    import json
-    return json.load(open(fname, 'r'))[key]
-
-
 class _SetupUpdate(setuptools.Command):
     # This is a compatibility, some downstream distributions might
     # still call "setup.py update".
@@ -49,8 +44,7 @@ def main():
     setuptools.setup(
         name='wcwidth',
         # NOTE: manually manage __version__ in wcwidth/__init__.py !
-        version=_get_version(
-            _get_here(os.path.join('wcwidth', 'version.json'))),
+        version='0.2.5',
         description=(
             "Measures the displayed width of unicode strings in a terminal"),
         long_description=codecs.open(

tests/test_ucslevel.py

@@ -12,20 +12,6 @@
 import wcwidth
 
 
-def test_list_versions():
-    """wcwidth.list_versions() returns expected value."""
-    # given,
-    expected = json.loads(
-        pkg_resources.resource_string('wcwidth', 'version.json').decode('utf8')
-    )['tables']
-
-    # exercise,
-    result = wcwidth.list_versions()
-
-    # verify,
-    assert result == expected
-
-
 def test_latest():
     """wcwidth._wcmatch_version('latest') returns tail item."""
     # given,

wcwidth/__init__.py

@@ -30,4 +30,8 @@
 # these always bit me, too, so I can sympathize -- this version is now manually
 # kept in sync with version.json to help them out. Shucks, this variable is just
 # for legacy, from the days before 'pip freeze' was a thing.
-__version__ = '0.2.4'
+#
+# We also used pkg_resources to load unicode version tables from version.json,
+# generated by bin/update-tables.py, but some environments are unable to
+# import pkg_resources for one reason or another, yikes!
+__version__ = '0.2.5'

wcwidth/table_wide.py

@@ -1,5 +1,5 @@
 """Wide_Eastasian table, created by bin/update-tables.py."""
-# Generated: 2020-06-01T15:38:29.249643
+# Generated: 2020-06-23T15:58:41.860748
 WIDE_EASTASIAN = {
     '4.1.0': (
         # Source: EastAsianWidth-4.1.0.txt

wcwidth/table_zero.py

@@ -1,5 +1,5 @@
 """Zero_Width table, created by bin/update-tables.py."""
-# Generated: 2020-06-01T15:38:31.292746
+# Generated: 2020-06-23T15:58:43.900697
 ZERO_WIDTH = {
     '4.1.0': (
         # Source: DerivedGeneralCategory-4.1.0.txt