feat: Finish implementation of feature/lists-api-support

- feat: add custom error classes for handling HTTP errors
- added `_check_response` for standardized error handling.
- Refactored client List methods to use correct file upload logic
- restructured test cases for list-related features.
- added dependencies for dev to pyproject.toml

Author: funkatron

README.md

@@ -41,6 +41,8 @@ Development Installation
 Usage
 -----
 
+### Geocoding
+
 ```python
 from geocodio import GeocodioClient
 
@@ -71,6 +73,72 @@ data = client.geocode(
 print(data)
 ```
 
+### List API
+
+The List API allows you to manage lists of addresses or coordinates for batch processing.
+
+```python
+from geocodio import GeocodioClient
+
+# Initialize the client with your API key
+client = GeocodioClient("YOUR_API_KEY")
+
+# Create a new list
+new_list = client.create_list(
+    name="My Addresses",
+    description="A list of addresses to geocode",
+    items=[
+        "1600 Pennsylvania Ave, Washington, DC",
+        "1 Infinite Loop, Cupertino, CA"
+    ]
+)
+print(new_list)
+
+# Get all lists
+lists = client.get_lists()
+print(lists)
+
+# Get a specific list
+list_id = new_list.list.id
+list_details = client.get_list(list_id)
+print(list_details)
+
+# Update a list
+updated_list = client.update_list(
+    list_id=list_id,
+    name="Updated List Name",
+    description="Updated description"
+)
+print(updated_list)
+
+# Add items to a list
+added_items = client.add_items_to_list(
+    list_id=list_id,
+    items=[
+        "123 Anywhere St, Chicago, IL",
+        "456 Oak St, Los Angeles, CA"
+    ]
+)
+print(added_items)
+
+# Geocode all items in a list
+geocoded_list = client.geocode_list(
+    list_id=list_id,
+    fields=["timezone", "cd"]
+)
+print(geocoded_list)
+
+# Remove items from a list
+item_ids = [item.id for item in added_items.items]
+client.remove_items_from_list(
+    list_id=list_id,
+    item_ids=item_ids
+)
+
+# Delete a list
+client.delete_list(list_id)
+```
+
 Error Handling
 --------------
 
@@ -93,4 +161,4 @@ Issues: <https://github.com/geocodio/geocodio-library-python/issues>
 License
 -------
 
-This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

pyproject.toml

@@ -24,12 +24,24 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
     "Topic :: Scientific/Engineering :: GIS",
-    "Framework :: HTTP Client",
 ]
 dependencies = [
     "httpx>=0.24.0",
 ]
 
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-mock>=3.10.0",
+    "pytest-httpx>=0.27.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "flake8>=6.0.0",
+    "mypy>=1.0.0",
+    "python-dotenv>=1.0.0",
+]
+
 [project.urls]
 Homepage = "https://geocod.io"
 Documentation = "https://geocodio.readthedocs.io"
@@ -44,4 +56,4 @@ testpaths = ["tests"]
 python_files = "test_*.py"
 python_functions = "test_*"
 python_classes = "Test*"
-addopts = "-v --cov=geocodio --cov-report=term-missing"
+addopts = "-v --cov=geocodio --cov-report=term-missing"