Metadata-Version: 2.1
Name: thesoup
Version: 0.5
Summary: A soup of random python utils
Home-page: https://github.com/amartya00/thesoup
Author: Amartya Datta Gupta
Author-email: amartya00@gmail.com
License: GPLv2
Project-URL: Source, https://github.com/amartya00/thesoup
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: test
Requires-Dist: nose ; extra == 'test'

# **The soup**
A collection of python classes and functions.

## Getting it
#### Github
Download it from github with a `git clone https://github.com/amartya00/thesoup.git`
Navigate to the root, and run all tests to ensure everything is working with `nosetests -w tst/ --nocapture`

Now install with `sudo pip3 install .`

#### PyPi
This is available on [PyPi](https://pypi.org/project/thesoup/) as well. Do a `sudo pip3 install thesoup` to install.

**NOTE**: If you do not have nose tests, install it with `sudo pip3 install nose`

**NOTE**: This is python3 only

## Components
### Classes
It has the following utility classes:
  - Graphs
    - Abstract class for directed graph `DiGraph`
    - Abstract class for directed mutable graph `MutableDiGraph`
    - A mutable digraph implementation with adjacensy list `AdjListGraph`

  - Heap
    - Min heap `Minheap`
    - Max heap `MaxHeap`

   - Binary trees
     - BST `BinarySearchTree`

  - Trie (ASCII only)

## Functions
It has the following utility functions
  - Collection related
    - Flatten a nested collection `flatten`
    - Flatten a nested collection except the tuples `flatten_to_tuple`
    - Find all subsequences of a list `subsequence`

  - Graph traversals
    - Bread first search `bfs`
    - Depth first search `dfs`
    - Dijkstra `dijkstra`
    - Specialized SP for DAGs `shortest_path_dag`

  - Other
    - K-way merge `merge`



