Update README.rst, remove a deprecation warning

Author: rocky

CHANGES.rst

@@ -6,6 +6,9 @@ CHANGES
 
 Re-Release to use released Mathics 1.1.0
 
+* tests added.
+* README.rst has been updated with examples.
+
 1.0.0
 -----
 

README.rst

@@ -2,6 +2,27 @@
 
 Mathics Natural Language Toolkit module.
 
+
+Example Session
+---------------
+
+::
+
+   $ mathicsscript
+   In[1]:= LoadModule["pymathics.natlang"]
+   Out[1]= pymathics.natlang
+   In[2]= Pluralize["try"]
+   Out[2]= tries
+   In[3]= WordFrequency["Apple Tree and apple", "apple", IgnoreCase -> True]
+   Out[3]= 0.5
+   In[4] = TextCases["I was in London last year.", "Pronoun"]
+   Out[3]= {I}
+
+More examples can be found in the `test file <https://github.com/Mathics3/pymathics-natlang/blob/master/test/test_natlang.py>`_.
+
+Installing and Running
+----------------------
+
 To use build module, you will need to install Python module `nltk
 <https://pypi.org/project/nltk/>`_ and `spacy
 <https://pypi.org/project/spacy/>`_, and then install some data from
@@ -47,3 +68,5 @@ Adjust "python" and "en" (the language you want) above as needed.
 		 :target: https://badge.fury.io/py/pymathics-natlang
 .. |Pypi Installs| image:: https://pepy.tech/badge/pymathics-natlang
 .. |Supported Python Versions| image:: https://img.shields.io/pypi/pyversions/pymathics-natlang.svg
+.. |Packaging status| image:: https://repology.org/badge/vertical-allrepos/pymathics-natlang.svg
+			    :target: https://repology.org/project/pymathics-natlang/versions

pymathics/natlang/__main__.py

@@ -64,7 +64,7 @@
 
 
 def _parse_nltk_lookup_error(e):
-    m = re.search("Resource '([^']+)' not found\.", str(e))
+    m = re.search(r"Resource '([^']+)' not found\.", str(e))
     if m:
         return m.group(1)
     else:

setup.py

@@ -4,13 +4,25 @@
 import sys
 import platform
 import os
+import os.path as osp
 from setuptools import setup, find_namespace_packages
 
 # Ensure user has the correct Python version
 if sys.version_info < (3, 6):
     print("Mathics support Python 3.6 and above; you have %d.%d" % sys.version_info[:2])
     sys.exit(-1)
 
+def get_srcdir():
+    filename = osp.normcase(osp.dirname(osp.abspath(__file__)))
+    return osp.realpath(filename)
+
+
+def read(*rnames):
+    return open(osp.join(get_srcdir(), *rnames)).read()
+
+# Get/set VERSION and long_description from files
+long_description = read("README.rst") + "\n"
+
 # stores __version__ in the current namespace
 exec(compile(open("pymathics/natlang/version.py").read(), "version.py", "exec"))
 
@@ -33,9 +45,9 @@
     version=__version__,
     packages=find_namespace_packages(include=["pymathics.*"]),
     install_requires=["Mathics3>=1.1.0", "nltk", "spacy<3.0", "pattern"],
-    # don't pack Mathics in egg because of media files, etc.
     zip_safe=False,
     maintainer="Mathics Group",
+    long_description=long_description,
     long_description_content_type="text/x-rst",
     # metadata for upload to PyPI
     classifiers=[