Metadata-Version: 2.1
Name: hashtable_nicolerg
Version: 1.0.2
Summary: An exercise to learn about hash tables, unit tests, TDD, and Python packages
Project-URL: Docker Image, https://hub.docker.com/repository/docker/nicolerg/python-hashtable
Project-URL: Source Code, https://github.com/nicolerg/python-hashtable/hashtable-nicolerg
Project-URL: Guiding Tutorial, https://realpython.com/python-hash-table
Author-email: Nicole Gay <nicole.r.gay@gmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# HashTable 

This simple package provides a custom implementation of a hash table in Python,
created by following [this tutorial](https://realpython.com/python-hash-table/) written by Bartosz Zaczyński. 
The `HashTable` class replicates many methods from Python dictionaries, including
`HashTable.clear()` and `HashTable.update()`.  

## Installation 

This package is available in [PyPI](https://pypi.org/project/hashtable-nicolerg/). 
Use the package manager [pip](https://pip.pypa.io/en/stable/) to install `HashTable`.

```bash
python3 -m pip install hashtable-nicolerg
```

Alternatively, experiment with `HashTable` in a [Docker container](https://github.com/nicolerg/python-hashtable/docker/).

## Usage 

```python
from hashtable_nicolerg.hashtable import HashTable

# Create an instance of HashTable with initial size 10
# and loading factor threshold 0.5, meaning the HashTable
# will be resized to have 2x capacity whenever the number of 
# key-value pairs is at least half the current capacity
hash_table = HashTable(capacity=10, load_factor_threshold=0.5)

hash_table["blue"] = "sea"              # Add key-value pair "blue":"sea"
hash_table["list"] = [1,2,3]            # Add key-value pair with a mutable value 
len(hash_table)                         # Return number of key-value pairs
hash_table.capacity                     # Return current capacity
hash_table.load_factor                  # Return current load factor
hash_table.keys                         # Return set of keys
hash_table.values                       # Return list of values 
hash_table.pairs                        # Return list of key-value pairs
del hash_table["list"]                  # Delete key-value pair for specified key
hash_table.update({"blue":"0000FF"})    # Update value for key "blue" using a dictionary
hash_table["blue"]                      # Return value for key "blue"
hash_table.clear()                      # Remove all key-value pairs 
```

## Motivation 

Developing this package reinforced knowledge in the following areas:  
* Python classes, including dunder methods  
* Hash table implementation, including handling hash collisions  
* Testing, including TDD, unit tests, and `pytest`  
* Developing [Python packages](https://packaging.python.org/en/latest/tutorials/packaging-projects/)  

## Dev notes

1. Create the [recommended directory structure](https://packaging.python.org/en/latest/tutorials/packaging-projects/#creating-the-package-files) and populate files 
2. Build the package in the same directory as `pyproject.toml`, which should create a `dist/` directory    
    ```bash
    python3 -m build
    ```
3. Use [Twine](https://twine.readthedocs.io/en/stable/) to upload the package to [PyPI](https://pypi.org/)  
    ```bash
    python3 -m pip install --upgrade twine
    python3 -m twine upload dist/*
    ```
4. Install your newly uploaded package 
    ```bash
    python3 -m pip install hashtable-nicolerg
    ```
5. To update the package, increment the version in `pyproject.toml``, build, and upload  
    ```bash
    python3 -m build
    python3 -m twine upload --skip-existing dist/*
    ```
6. Install and test your new version  
    ```bash
    python3 -m pip install hashtable-nicolerg --upgrade
    ```
