Get initial CLI working; update README; update version

README.md

@@ -1,8 +1,23 @@
 # PyLookup
 
-PyLookup is a fuzzy-matching, auto-updating library and command-line tool inspired by the "VLOOKUP" function in Excel.
+PyLookup is a fuzzy-matching, auto-table-updating library and command-line tool inspired by the "VLOOKUP" function in Excel.
 
 
+# Installation
+
+```
+pip install pylookup
+```
+
+# Command Line Interface Usage
+
+ - To add and populate the "COLUMN" column in "excel_to_populate" from the data in "excel_with_column",
+ simple run the following command.  This currently works for .xlsx (Excel) files and .csv files.
+
+```
+pylookup COLUMN excel_to_populate.xlsx excel_with_column.xlsx
+```
+
 
 
 License

pylookup/__init__.py

@@ -1 +1,3 @@
-from .pylookup import pylookup
+from .pylookup import pylookup, file_lookup
+from . import __main__
+# from .__main__ import file_lookup

pylookup/__main__.py

@@ -1,40 +1,7 @@
 '''
 Command Line Interface for PyLookup.
 '''
-from pylookup import pylookup
-import pandas
-import click
-
-
-@click.command()
-@click.argument('column_to_fill')
-@click.argument('main_file')
-@click.argument('reference_file')
-def file_lookup(column_to_fill, main_file, reference_file):
-
-    if '.xl' in main_file:
-        main_df = pandas.read_excel(main_file)
-    elif '.csv' in main_file:
-        main_df = pandas.read_csv(main_file)
-    else:
-        print('Error!  Main file must be .csv or .xlsx!')
-
-    if '.xl' in reference_file:
-        ref_df = pandas.read_excel(reference_file)
-    elif '.csv' in reference_file:
-        ref_df = pandas.read_csv(reference_file)
-    else:
-        print('Error!  Reference file must be .csv or .xlsx!')
-
-
-    pylookup(column_to_fill, main_df, ref_df)
-
-    if '.xl' in main_file:
-        main_df.to_excel(main_file, index=False)
-    elif '.csv' in main_file:
-        main_df.to_csv(main_file, index=False)
-    print(f'Saved updated {main_file}.')
-
+from .pylookup import file_lookup
 
 
 if __name__ == '__main__':

pylookup/pylookup.py

@@ -6,6 +6,7 @@
 from statistics import mean
 from collections import defaultdict
 import random
+import click
 
 
 
@@ -122,3 +123,33 @@ def matchable_columns(main_table, reference_table) -> dict:
     if not main_col_matches:
         print('No reference columns were found suitable for matching!')
     return main_col_matches
+
+
+@click.command()
+@click.argument('column_to_fill')
+@click.argument('main_file')
+@click.argument('reference_file')
+def file_lookup(column_to_fill, main_file, reference_file):
+
+    if '.xl' in main_file:
+        main_df = pandas.read_excel(main_file)
+    elif '.csv' in main_file:
+        main_df = pandas.read_csv(main_file)
+    else:
+        print('Error!  Main file must be .csv or .xlsx!')
+
+    if '.xl' in reference_file:
+        ref_df = pandas.read_excel(reference_file)
+    elif '.csv' in reference_file:
+        ref_df = pandas.read_csv(reference_file)
+    else:
+        print('Error!  Reference file must be .csv or .xlsx!')
+
+
+    pylookup(column_to_fill, main_df, ref_df)
+
+    if '.xl' in main_file:
+        main_df.to_excel(main_file, index=False)
+    elif '.csv' in main_file:
+        main_df.to_csv(main_file, index=False)
+    print(f'Saved updated {main_file}.')

setup.cfg

@@ -0,0 +1,3 @@
+[options.entry_points]
+console_scripts = 
+    pylookup = pylookup:file_lookup

setup.py

@@ -5,17 +5,17 @@
 
 setuptools.setup(
     name='PyLookup',
-    version='0.1.0',
+    version='0.1.1',
     packages=['pylookup'],
     license='MIT',
     author='Zach Bateman',
     description='PyLookup - Fuzzy-matching table autofill tool',
     long_description=long_description,
     long_description_content_type='text/markdown',
     url='https://github.com/zachbateman/pylookup.git',
-    download_url='https://github.com/zachbateman/pylookup/archive/v_0.1.0.tar.gz',
+    download_url='https://github.com/zachbateman/pylookup/archive/v_0.1.1.tar.gz',
     keywords=['LOOKUP', 'VLOOKUP', 'TABLE', 'MATCHING'],
-    install_requires=['rapidfuzz', 'pandas'],
+    install_requires=['rapidfuzz', 'pandas', 'click'],
     classifiers=['Development Status :: 3 - Alpha',
                    'License :: OSI Approved :: MIT License',
                    'Programming Language :: Python :: 3',