Skip to main content

Find what you're looking for in a flash with Huntela.

Project description


Huntela is a savvy search module that's an alternative to the default filter method. It offers a range of powerful search functions, including fuzzy search, binary search, and searches for least/most frequent items in a list.

>>> import huntela
>>> huntela.fuzzy_search(term='app', items=['app', 'paper', 'hello', 'world'])
    {'confidence': 1, 'index': 0, 'value': 'app'},
    {'confidence': 0.6, 'index': 1, 'value': 'paper'}
>>> huntela.binary_search(term='a', items=['a', 'b', 'c'])
{'confidence': 1, 'index': 0, 'value': 'a'}
>>> huntela.search_for_least_frequent_items(size=1, ['a', 'b', 'a', 'e', 'a', 'e'])
    {'confidence': 1, 'index': [1], 'value': 'b'}
>>> huntela.search_for_most_frequent_items(size=2, ['a', 'b', 'a', 'e', 'a', 'e'])
    {'confidence': 1, 'value': 'a', 'index': [0, 2, 4]},
    {'confidence': 1, 'value': 'e', 'index': [3, 5]}

With a variety of algorithms to choose from, finding what you're looking for has never been easier.

From binary search to linear search and more, Huntela has everything you need to quickly and efficiently search through your data. With a simple, intuitive interface and lightning-fast performance, Huntela is the go-to package for anyone who needs to search through data.

Whether you're a data scientist, engineer, or developer, Huntela will help you find what you need.


Huntela officially supports Python 3.9 upwards.

Huntela is available on PyPi and it can be installed using pip

python -m pip install huntela



Each of the search methods take in three (3) parameters.

  1. term: The term being searched for.
  2. items: The items parameter could then be a iterable of the supported term types.
  3. key (Optional): Only to be specified if the term is a dict. In which case, the key will be used to pick the corresponding values from the list of items.

Supported Types


The term being searched for could be one of the following supported types:

  1. int
  2. float
  3. str
  4. dict[str, Any]


The items parameter could then be a iterable of the supported term types. That is,

  1. List[int]
  2. List[float]
  3. List[str]
  4. List[Dict[str, str]]


Each search result is a dict which contains the following item:

  1. confidence: A number from 0.0 to 1.0 that indicates the degree of relevance of the search match.
  2. value: The specific item that matched the search criteria.
  3. index: The position, or a list of positions where the search term was found.


fuzzy_search(term, items, key=None) -> List[Result]: Searches a list of items for a given search term and returns a list of results which exactly or closely match the search term.

>>> huntela.fuzzy_search(term='app', items=['app', 'paper', 'hello', 'world'])
    {'confidence': 1, 'index': 0, 'value': 'app'},
    {'confidence': 0.6, 'index': 1, 'value': 'paper'}

binary_search(term, items, key=None) -> List[Result]: Performs a binary search on a list to find a target value.

>>> huntela.binary_search(
    items=[{'name': 'Alex'}, {'name': 'Mike'}, {'name': 'John'}],
{'confidence': 1, 'index': 0, 'value': 'Ade'}

search_for_least_frequent_items: Finds the k least frequent item(s) in a list.

>>> search_for_least_frequent_items(size, items)
    {'confidence': 1, 'index': [0], 'value': 1},
    {'confidence': 1, 'index': [2, 3], 'value': 3}

search_for_most_frequent_items: Finds the k most frequent item(s) in a list.

>>> search_for_most_frequent_items(2, [1, 2, 2, 3, 3, 3])
    {'confidence': 1, 'index': [3, 4, 5], 'value': 3},
    {'confidence': 1, 'index': [1, 2], 'value': 2}

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

huntela-0.0.18.tar.gz (7.9 kB view hashes)

Uploaded Source

Built Distribution

huntela-0.0.18-py3-none-any.whl (8.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page