Metadata-Version: 2.1
Name: pysimilar
Version: 0.3
Summary: A very light python libary for comparing similarity between text/strings
Home-page: https://github.com/Kalebu/pysimilar
Author: Jordan Kalebu
Author-email: isaackeinstein@gmail.com
License: MIT
Download-URL: https://github.com/Kalebu/pysimilar/archive/0.2.tar.gz
Description: # [pysimilar](https://kalebu.github.io/pysimilar/)
        
        A python library for computing the similarity between two string(text) based on cosine similarity made by [kalebu](https://github.com/Kalebu)
        
        ## How does it work ?
        
        It uses Tfidf Vectorizer to transform the text into vectors and then obtained vectors are converted into arrays of numbers and then finally cosine similary computation is employed resulting to output indicating how similar they are.
        
        ## Example of usage
        
        Pysimilar allows you to either specify the string you want to compare directly or specify path to files containing string you want to compare.
        
        ### compare() strings
        
        Here an example on how to compare strings directly;
        
        ```python
        >>> from pysimilar import compare
        >>> compare('very light indeed', 'how fast is light')
        0.17077611319011649
        ```
        
        ### compare () files
        
        Here how to compare files with textual documents;
        
        ```python
        >>> compare('README.md', 'LICENSE', isfile=True)
        0.25545580376557886
        ```
        
        You can also compare documents with particular **extension** in a given directory, for instance let's say I want to compare all the documents with **.txt** in a **documents** directory here is what I will do;
        
        Directory for documents used by the example below look like this
        
        ```bash
        documents/
        ├── anomalie.zeta
        ├── hello.txt
        ├── hi.txt
        └── welcome.txt
        ```
        
        ### compare_documents ()
        
        Here how to compare files of a particular extension
        
        ```python
        >>> import pysimilar
        >>> from pprint import pprint
        >>> pysimilar.extensions = '.txt'
        >>> comparison_result = pysimilar.compare_documents('documents')
        >>> [['welcome.txt vs hi.txt', 0.6053485081062917],
            ['welcome.txt vs hello.txt', 0.0],
            ['hi.txt vs hello.txt', 0.0]]
        ```
        
        ### sorting the outputs
        
        You can also sort the comparison score based on their score by changing the **ascending** parameter, just as shown below;
        
        ```python
        >>> comparison_result = pysimilar.compare_documents('documents', ascending=True)
        >>> pprint(comparison_result)
        [['welcome.txt vs hello.txt', 0.0],
         ['hi.txt vs hello.txt', 0.0],
         ['welcome.txt vs hi.txt', 0.6053485081062917]]
        ```
        
        ## multiple extensions
        
        You can also set pysimilar to include files with multiple extensions
        
        ```python
        >>> import pysimilar
        >>> from pprint import pprint
        >>> pysimilar.extensions = ['.txt', '.zeta']
        >>> comparison_result = pysimilar.compare_documents('documents', ascending=True)
        >>> pprint(comparison_result)
        [['welcome.txt vs hello.txt', 0.0],
         ['hi.txt vs hello.txt', 0.0],
         ['anomalie.zeta vs hi.txt', 0.4968161174826459],
         ['welcome.txt vs hi.txt', 0.6292275146695526],
         ['welcome.txt vs anomalie.zeta', 0.7895651507603823]]
        
        ```
        
        ## Contributions
        
        If you have anything valuable to add to the *lib*, whether its a documentation, typo error, source code, please don't hesitate to contribute just fork it and submit your pull request and I will try to be as friendly as I can to assist you making the contributions.
        
        
        ## All the Credits
        
        All the Credits to [kalebu](https://github.com/Kalebu) and other future contributors
Keywords: pysimilar,python-plagiarism-library,natural language processing,NLP libary,python-tanzania
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.6
Description-Content-Type: text/markdown
