added "run on repl.it" badge

.gitignore

@@ -1,58 +1,7 @@
-#####=== Python ===#####
+# Byte-compiled / optimized / DLL files	
+__pycache__/	
+*.py[cod]	
 
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-env/
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-*.egg-info/
-.installed.cfg
-*.egg
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.coverage
-.cache
-nosetests.xml
-coverage.xml
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-target/
-
-.idea/
+sample_decompressed.txt	
+sample.bin
+tests/*.bin

.replit

@@ -0,0 +1,3 @@
+language = "python3"
+#run = "python3 useHuffman.py"
+run = "pip3 install -r requirements.txt; cd tests; python3 -m pytest -rP test_huffman.py"

README.md

@@ -1,6 +1,13 @@
-### Python Implementaion of Huffman Coding
+[![Run on Repl.it](https://repl.it/badge/github/kgashok/huffman-coding)](https://repl.it/github/kgashok/huffman-coding)  
+_(for additional configuration instructions, see [below](https://github.com/kgashok/huffman-coding#repo-to-repl))_
 
-Explanation at http://bhrigu.me/blog/2017/01/17/huffman-coding-python-implementation/
+#### The Visual that _really_ works! 
+
+A Glitch Project - https://shining-baroness.glitch.me/
+
+### Python Implementation of Huffman Coding
+
+Explanation at http://bhrigu.me/blog/2017/01/17/huffman-coding-python-implementation/ or http://j.mp/huffmanPy
 
 Consists **compress** and **decompress** function.
 
@@ -16,3 +23,37 @@ To run the code for compression of any other text file, edit the `path` variable
 
 
 For now, the *decompress()* function is to be called from the same object from which the *compress()* function was called, for compressing-decompressing a file (as the encoding information is stored in the data members of the object only) 
+
+## Repo to Repl 
+1. Click on the gray **repl.it badge** above. 
+2. Wait for the repo to get loaded into repl.it
+3. Look for the green "Run" button at the top of the screen. Click on it and existing tests cases should run
+
+![run](/img/runButton.png)
+
+4. If you get an error **"No module named pytest"**, then run the following command in repl.it prompt (on the right hand side in the bash shell):
+    ```bash
+    . install.sh  # period and space and 'install.sh'
+    # wait for 'pytest' and 'autopep8' install to complete
+    ```
+
+5. Now, try clicking the green "Run" button again. IT should work.
+
+
+### The Genius of David Huffman
+
+- Read https://www.maa.org/press/periodicals/convergence/discovery-of-huffman-codes
+- Analysis as greedy algorithm https://www.codesdope.com/course/algorithms-huffman-codes/
+- Read http://www.skypape.com/huffman.htm 
+
+![huffman](/img/huffmanDr.jpg)
+
+### From Huffman Visualizer (http://j.mp/huffVisual) 
+
+- The **padding** (red), 
+- The bidirectional **hashtable** (aka map), and 
+- the actual compressed **code** (3 bytes in blue) for "abracadabra" (11 bytes), 
+
+achieving a compression of **59**%
+
+![outputForAbracadabra](/img/outputForAbracadabra.png)

bashprofile

@@ -0,0 +1,3 @@
+if [ -f "$HOME/.bashrc" ] ; then	
+  source $HOME/.bashrc	
+fi

bashrc

@@ -0,0 +1,2 @@
+alias pytest="/home/runner/.local/bin/pytest"
+alias autopep8="/home/runner/.local/bin/autopep8  --in-place --aggressive --aggressive --max-line-length=119 --indent-size 2"

files/README.md

@@ -0,0 +1 @@
+

gitignore

@@ -0,0 +1,7 @@
+# Byte-compiled / optimized / DLL files	
+__pycache__/	
+*.py[cod]	
+
+sample_decompressed.txt	
+sample.bin
+tests/*.bin