shapeography 0.1__tar.gz

shapeography-0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Eric J. Drewitz 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

shapeography-0.1/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: shapeography
+Version: 0.1
+Summary: A Python library that both a client that downloads various shapefiles and GEOJSON files from the web and processes these geometry files. Users can also process locally hosted shapefiles and GEOJSON files. Also works for those on VPN/PROXY connections.
+Author: Eric J. Drewitz
+Project-URL: Documentation, https://github.com/edrewitz/shapeography?tab=readme-ov-file#shapeography
+Project-URL: Repository, https://github.com/edrewitz/shapeography/tree/main
+Keywords: cartography,geography
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cartopy>=0.24.0
+Requires-Dist: geopandas>=1.1.0
+Requires-Dist: requests>=2.32.4
+Dynamic: license-file
+
+# shapeography
+
+
+
+<img src="https://github.com/edrewitz/shapeography/blob/main/Thumbnails/86506Livingston-Rev-Base.jpg?raw=true" width="200" alt="Alt text" /> <img src="https://github.com/edrewitz/WxData/blob/1be590e9a16033974a592d8cf99f3cd521f95e0b/icons/python%20logo.png?raw=true" width="200" alt="Alt text" />
+
+**(C) Eric J. Drewitz 2026**
+
+An open-source Python package that manages shapefiles and GEOJSON files. 
+
+***Jupyter Lab Examples***
+
+1) [Downloading and Plotting the National Weather Service Public Forecast Zones](https://github.com/edrewitz/shapeography-Jupyter-Lab-Examples/blob/main/nws_public_zones.ipynb)
+2) [Downloading and Plotting the NOAA/NWS Climate Prediction Center 6-10 Day Probabilistic Precipitation Outlook](https://github.com/edrewitz/shapeography-Jupyter-Lab-Examples/blob/main/cpc_outlook.ipynb)
+
+
+***Client Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/client.md#client-module)
+
+The `client` module hosts the client function `get_shapefiles()` that downloads shapefiles/GEOJSON file from a user-defined URL address into a folder locally on your PC.
+
+The user must specify the path and filename and the file is saved to {path}/{filename}. 
+
+This client is also helpful for those using shapeography in automated scripts. If the user keeps the optional argument `refresh=True` - The directory hosting the shapefiles/GEOJSON file will be refreshed as the old files will be deleted and new files downloaded. This can be helpful in automation due to periodic shapefile updates on the server-side as it ensures that the user will always have the most recent and up to date shapefiles/GEOJSON file. 
+
+This client supports users on a VPN/PROXY connection. 
+
+    **Proxy Example**
+
+    proxies=None ---> proxies={
+                           'http':'address:port',
+                           'https':'address:port'
+                        } 
+
+    shapeography.client.get_shapefiles(url, path, filename, proxies=proxies)
+
+***Unzip Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/unzip.md#unzip-module)
+
+The `unzip` module hosts the function that unzips the shapefiles/GEOJSON file if the file(s) need to be unzipped.
+
+In nearly all cases, shapefile components are within a zipfile server-side so needing to unzip is very common. 
+
+The function `extract_files()` unzips the shapefiles/GEOJSON into a user-specified extraction folder that is automatically generated. 
+
+Supports the following file extentions: .zip, .gz, .tar, .tar.gz
+
+***Geometry Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#geometry-module)
+
+The `geometry` module hosts functions that extract data from these shapefiles/GEOJSON file and make it significantly easier to work with this data in Python.
+
+The current functions are: 
+
+1) [`cartopy_shapefeature()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#1-cartopy_shapefeature) - Returns a cartopy.shapefeature from the data inside the shapefile/GEOJSON.
+2) [`get_geometries()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#2-get_geometries) - Returns a gpd.GeoDataFrame of the geometry data of the shapefile/GEOJSON in the coordinate reference system (CRS) specified by the user. (Default CRS = 'EPSG:4326' --> `ccrs.PlateCarree()`)
+3) [`geodataframe()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#3-geodataframe) - Returns gpd.GeoDataFrame hosting all the data in the shapefile/GEOJSON in the coordinate reference system (CRS) specified by the user. (Default CRS = 'EPSG:4326' --> `ccrs.PlateCarree()`)
+
+# Citations
+
+1) **cartopy**: Phil Elson, Elliott Sales de Andrade, Greg Lucas, Ryan May, Richard Hattersley, Ed Campbell, Andrew Dawson, Bill Little, Stephane Raynaud, scmc72, Alan D. Snow, Ruth Comer, Kevin Donkers, Byron Blay, Peter Killick, Nat Wilson, Patrick Peglar, lgolston, lbdreyer, … Chris Havlin. (2023). SciTools/cartopy: v0.22.0 (v0.22.0). Zenodo. https://doi.org/10.5281/zenodo.8216315
+2) **geopandas**: Kelsey Jordahl, Joris Van den Bossche, Martin Fleischmann, Jacob Wasserman, James McBride, Jeffrey Gerard, … François Leblanc. (2020, July 15). geopandas/geopandas: v0.8.1 (Version v0.8.1). Zenodo. http://doi.org/10.5281/zenodo.3946761
+3) **requests**: K. Reitz, "Requests: HTTP for Humans". Available: https://requests.readthedocs.io/.

shapeography-0.1/README.md

@@ -0,0 +1,66 @@
+# shapeography
+
+
+
+<img src="https://github.com/edrewitz/shapeography/blob/main/Thumbnails/86506Livingston-Rev-Base.jpg?raw=true" width="200" alt="Alt text" /> <img src="https://github.com/edrewitz/WxData/blob/1be590e9a16033974a592d8cf99f3cd521f95e0b/icons/python%20logo.png?raw=true" width="200" alt="Alt text" />
+
+**(C) Eric J. Drewitz 2026**
+
+An open-source Python package that manages shapefiles and GEOJSON files. 
+
+***Jupyter Lab Examples***
+
+1) [Downloading and Plotting the National Weather Service Public Forecast Zones](https://github.com/edrewitz/shapeography-Jupyter-Lab-Examples/blob/main/nws_public_zones.ipynb)
+2) [Downloading and Plotting the NOAA/NWS Climate Prediction Center 6-10 Day Probabilistic Precipitation Outlook](https://github.com/edrewitz/shapeography-Jupyter-Lab-Examples/blob/main/cpc_outlook.ipynb)
+
+
+***Client Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/client.md#client-module)
+
+The `client` module hosts the client function `get_shapefiles()` that downloads shapefiles/GEOJSON file from a user-defined URL address into a folder locally on your PC.
+
+The user must specify the path and filename and the file is saved to {path}/{filename}. 
+
+This client is also helpful for those using shapeography in automated scripts. If the user keeps the optional argument `refresh=True` - The directory hosting the shapefiles/GEOJSON file will be refreshed as the old files will be deleted and new files downloaded. This can be helpful in automation due to periodic shapefile updates on the server-side as it ensures that the user will always have the most recent and up to date shapefiles/GEOJSON file. 
+
+This client supports users on a VPN/PROXY connection. 
+
+    **Proxy Example**
+
+    proxies=None ---> proxies={
+                           'http':'address:port',
+                           'https':'address:port'
+                        } 
+
+    shapeography.client.get_shapefiles(url, path, filename, proxies=proxies)
+
+***Unzip Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/unzip.md#unzip-module)
+
+The `unzip` module hosts the function that unzips the shapefiles/GEOJSON file if the file(s) need to be unzipped.
+
+In nearly all cases, shapefile components are within a zipfile server-side so needing to unzip is very common. 
+
+The function `extract_files()` unzips the shapefiles/GEOJSON into a user-specified extraction folder that is automatically generated. 
+
+Supports the following file extentions: .zip, .gz, .tar, .tar.gz
+
+***Geometry Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#geometry-module)
+
+The `geometry` module hosts functions that extract data from these shapefiles/GEOJSON file and make it significantly easier to work with this data in Python.
+
+The current functions are: 
+
+1) [`cartopy_shapefeature()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#1-cartopy_shapefeature) - Returns a cartopy.shapefeature from the data inside the shapefile/GEOJSON.
+2) [`get_geometries()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#2-get_geometries) - Returns a gpd.GeoDataFrame of the geometry data of the shapefile/GEOJSON in the coordinate reference system (CRS) specified by the user. (Default CRS = 'EPSG:4326' --> `ccrs.PlateCarree()`)
+3) [`geodataframe()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#3-geodataframe) - Returns gpd.GeoDataFrame hosting all the data in the shapefile/GEOJSON in the coordinate reference system (CRS) specified by the user. (Default CRS = 'EPSG:4326' --> `ccrs.PlateCarree()`)
+
+# Citations
+
+1) **cartopy**: Phil Elson, Elliott Sales de Andrade, Greg Lucas, Ryan May, Richard Hattersley, Ed Campbell, Andrew Dawson, Bill Little, Stephane Raynaud, scmc72, Alan D. Snow, Ruth Comer, Kevin Donkers, Byron Blay, Peter Killick, Nat Wilson, Patrick Peglar, lgolston, lbdreyer, … Chris Havlin. (2023). SciTools/cartopy: v0.22.0 (v0.22.0). Zenodo. https://doi.org/10.5281/zenodo.8216315
+2) **geopandas**: Kelsey Jordahl, Joris Van den Bossche, Martin Fleischmann, Jacob Wasserman, James McBride, Jeffrey Gerard, … François Leblanc. (2020, July 15). geopandas/geopandas: v0.8.1 (Version v0.8.1). Zenodo. http://doi.org/10.5281/zenodo.3946761
+3) **requests**: K. Reitz, "Requests: HTTP for Humans". Available: https://requests.readthedocs.io/.

shapeography-0.1/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "shapeography"
+version = "0.1"
+description = "A Python library that both a client that downloads various shapefiles and GEOJSON files from the web and processes these geometry files. Users can also process locally hosted shapefiles and GEOJSON files. Also works for those on VPN/PROXY connections."
+readme = "README.md"
+requires-python = ">=3.10"
+license-files = ["LICENSE*"]
+authors = [
+    { name = "Eric J. Drewitz" },
+]
+keywords = ["cartography", "geography"]
+classifiers = [
+    "Programming Language :: Python",
+    "Topic :: Scientific/Engineering",
+    "Operating System :: OS Independent",
+]
+
+dependencies = [
+	"cartopy>=0.24.0",
+    "geopandas>=1.1.0",
+    "requests>=2.32.4",
+]
+
+[build-system]
+requires = ["setuptools>=64.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]  # Look for packages in the src directory
+
+[project.urls]
+Documentation = "https://github.com/edrewitz/shapeography?tab=readme-ov-file#shapeography"
+Repository = "https://github.com/edrewitz/shapeography/tree/main"

shapeography-0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

shapeography-0.1/src/shapeography/__init__.py

@@ -0,0 +1,12 @@
+"""
+This file hosts all of the functions in the shapeography package that directly interact with the user. 
+
+(C) Eric J. Drewitz 2026
+"""
+
+
+
+import shapeography.utils.geometry as geometry
+import shapeography.utils.unzip as unzip
+import shapeography.client.client as client
+

shapeography-0.1/src/shapeography/client/__init__.py

@@ -0,0 +1 @@
+import shapeography.client.client as client

shapeography-0.1/src/shapeography/client/client.py

@@ -0,0 +1,154 @@
+"""
+This file hosts the client that retrieves the shapefile/geojson from the web and manages these files locally. 
+
+(C) Eric J. Drewitz 2026
+"""
+
+import requests as _requests
+import os as _os 
+import time as _time
+import sys as _sys
+import shutil as _shutil
+
+def get_shapefiles(url,
+             path,
+             filename,
+             proxies=None,
+             chunk_size=8192,
+             notifications='on',
+             refresh=True):
+    
+    """
+    This function is the client that downloads and locally manages shapefiles and GEOJSON files. 
+    This client supports VPN/PROXY connections. 
+    
+    Required Arguments:
+    
+    1) url (String) - The download URL to the file. 
+    
+    2) path (String) - The directory where the file is saved to. 
+    
+    3) filename (String) - The name the user wishes to save the file as. 
+    
+    Optional Arguments:
+    
+    1) proxies (dict or None) - Default=None. If the user is using proxy server(s), the user must change the following:
+
+       proxies=None ---> proxies={
+                           'http':'http://url',
+                           'https':'https://url'
+                        } 
+                        
+        get_shapefiles(url, path, filename, proxies=proxies)
+                        
+    2) chunk_size (Integer) - Default=8192. The size of the chunks when writing the GRIB/NETCDF data to a file.
+    
+    3) notifications (String) - Default='on'. Notification when a file is downloaded and saved to {path}
+    
+    4) refresh (Boolean) - Default=True. When set to True, the branch that hosts the shapefiles/GEOJSON files is completely
+       cleaned out and a new set of shapefiles/GEOJSON is downloaded with each run. This is recommended for those using 
+       shapeography in automated tasks to account for periodic shapefile/GEOJSON updates on the servers that host the shapefiles/GEOJSONs.
+    
+    Returns
+    -------
+    
+    Zipped Shapefile and/or GEOJSON to f:{path}/{filename} 
+    """
+    
+    if refresh == True:
+        try:
+            _shutil.rmtree(f"{path}")
+        except Exception as e:
+            pass
+    else:
+        pass
+    
+    try:
+        _os.makedirs(f"{path}")
+    except Exception as e:
+        pass
+
+    if proxies == None:
+        try:
+            with _requests.get(url, stream=True) as r:
+                r.raise_for_status() 
+                with open(f"{path}/{filename}", 'wb') as f:
+                    for chunk in r.iter_content(chunk_size=chunk_size):
+                        f.write(chunk)
+            if notifications == 'on':
+                print(f"Successfully saved {filename} to f:{path}")
+            else:
+                pass
+        except _requests.exceptions.RequestException as e:
+            for i in range(0, 6, 1):
+                if i < 3:
+                    print(f"Alert: Network connection unstable.\nWaiting 30 seconds then automatically trying again.\nAttempts remaining: {5 - i}")
+                    _time.sleep(30)
+                else:
+                    print(f"Alert: Network connection unstable.\nWaiting 60 seconds then automatically trying again.\nAttempts remaining: {5 - i}")
+                    _time.sleep(60)  
+                    
+                try:
+                    with _requests.get(url, stream=True) as r:
+                        r.raise_for_status() 
+                        with open(f"{path}/{filename}", 'wb') as f:
+                            for chunk in r.iter_content(chunk_size=chunk_size):
+                                f.write(chunk)
+                    if notifications == 'on':
+                        print(f"Successfully saved {filename} to f:{path}")  
+                    break
+                except _requests.exceptions.RequestException as e:
+                    i = i 
+                    if i >= 5:
+                        print(f"Error - File Cannot Be Downloaded.\nError Code: {e}")    
+                        _sys.exit(1)      
+                        
+        finally:
+            if r:
+                r.close() # Ensure the connection is closed.
+            
+    else:
+        try:
+            with _requests.get(url, stream=True, proxies=proxies) as r:
+                r.raise_for_status() 
+                with open(f"{path}/{filename}", 'wb') as f:
+                    for chunk in r.iter_content(chunk_size=chunk_size):
+                        f.write(chunk)
+            if notifications == 'on':
+                print(f"Successfully saved {filename} to f:{path}")
+            else:
+                pass
+        except _requests.exceptions.RequestException as e:
+            for i in range(0, 6, 1):
+                if i < 3:
+                    print(f"Alert: Network connection unstable.\nWaiting 30 seconds then automatically trying again.\nAttempts remaining: {5 - i}")
+                    _time.sleep(30)
+                else:
+                    print(f"Alert: Network connection unstable.\nWaiting 60 seconds then automatically trying again.\nAttempts remaining: {5 - i}")
+                    _time.sleep(60)  
+                    
+                try:
+                    with _requests.get(url, stream=True, proxies=proxies) as r:
+                        r.raise_for_status() 
+                        with open(f"{path}/{filename}", 'wb') as f:
+                            for chunk in r.iter_content(chunk_size=chunk_size):
+                                f.write(chunk)
+                    if notifications == 'on':
+                        print(f"Successfully saved {filename} to f:{path}")  
+                    break
+                except _requests.exceptions.RequestException as e:
+                    i = i 
+                    if i >= 5:
+                        print(f"Error - File Cannot Be Downloaded.\nError Code: {e}")    
+                        _sys.exit(1)    
+                        
+        finally:
+            if r:
+                r.close() # Ensure the connection is closed.
+
+
+    
+    
+    
+
+ 

shapeography-0.1/src/shapeography/utils/__init__.py

@@ -0,0 +1,2 @@
+import shapeography.utils.geometry as geometry
+import shapeography.utils.unzip as unzip

shapeography-0.1/src/shapeography/utils/geometry.py

@@ -0,0 +1,92 @@
+"""
+This file hosts the functions that extract data from the shapefiles/GEOJSON files and return that data.
+This file also has a geopandas wrapper to extract GeoDataFrames
+
+(C) Eric J. Drewitz 2026
+"""
+import geopandas as _gpd
+import cartopy.crs as _ccrs
+import cartopy.io.shapereader as _shapereader
+import cartopy.feature as _cfeature
+
+def cartopy_shapefeature(file_path,
+                           edgecolor='black'):
+    
+    """
+    This function extracts the geometries from the shapefile and returns those geometries to the user.
+    
+    Required Arguments: 
+    
+    1) file_path (String) - The full filepath to the shapefile. 
+    
+    Optional Arguments: 
+    
+    1) edgecolor (String) - Default='black'. The color of the bordr demarcations on the map. 
+    
+    Returns
+    -------
+    
+    A cartopy.shapefeature from the data inside the shapefile/GEOJSON.    
+    """   
+    
+    shape_feature = _cfeature.ShapelyFeature(_shapereader.Reader(file_path).geometries(),
+                                   crs=_ccrs.PlateCarree(), facecolor=(0,0,0,0), edgecolor=edgecolor)
+    
+    return shape_feature
+
+
+def get_geometries(file_path,
+                  crs='EPSG:4326'):
+    
+    """
+    This function converts the shapefile geometries to a CRS specified by the user using geopandas.
+    
+    Required Arguments: 
+    
+    1) file_path (String) - The full filepath to the shapefile. 
+    
+    Optional Arguments:
+    
+    1) crs (String) - Default='EPSG:4326' (ccrs.PlateCarree()) - The coordinate reference system the user wants the geometry coordinates in.  
+    
+    Returns
+    -------
+    
+    A gpd.GeoDataFrame geometry data of the shapefile/GEOJSON in the CRS specified by the user.
+    """
+    
+    gdf = _gpd.read_file(f"{file_path}")
+    
+    gdf = gdf.to_crs(crs)
+    
+    return gdf['geometry']
+
+
+def geodataframe(file_path,
+                crs='EPSG:4326'):
+    
+    """
+    This function extracts a gpd.GeoDataFrame from the shapefile/GEOJSON. 
+    
+    Required Arguments: 
+    
+    1) file_path (String) - The full filepath to the shapefile. 
+    
+    Optional Arguments:
+    
+    1) crs (String) - Default='EPSG:4326' (ccrs.PlateCarree()) - The coordinate reference system the user wants the geometry coordinates in.  
+    
+    Returns
+    -------
+    
+    A gpd.GeoDataFrame hosting all the data in the shapefile/GEOJSON. 
+    """
+    
+    gdf = _gpd.read_file(f"{file_path}")
+    
+    gdf = gdf.to_crs(crs)
+    
+    return gdf
+    
+    
+

shapeography-0.1/src/shapeography/utils/unzip.py

@@ -0,0 +1,127 @@
+"""
+This file hosts the functions responsible for unzipping the shapefiles
+
+(C) Eric J. Drewitz 2026
+"""
+
+import os as _os
+import gzip as _gzip
+import tarfile as _tarfile
+
+from zipfile import ZipFile as _ZipFile
+    
+def extract_files(file_directory,
+                    file_extension='.zip'):
+
+    """
+    This function extracts shapefiles that are zipped in a .zip file
+    
+    Required Arguments:
+    
+    1) file_directory (String) - The path of the directory to the initial .zip file. 
+    
+    Optional Arguments: 
+    
+    1) file_extension (String) - Default='.zip'. - The extension of the zip file. 
+    
+        Supported zip file extentions
+        -----------------------------
+            
+            1) .zip
+            2) .gz
+            3) .tar.gz
+            4) .tar
+    
+    Returns
+    -------
+    
+    A directory of unzipped shapefiles. 
+    """
+    
+    file_extension = file_extension.lower()
+    
+    if file_extension == '.gz':
+        try:
+            for f in _os.listdir(f"{file_directory}"):
+                extraction_folder = f.split('.', 1)[0]
+                with _gzip.open(f"{file_directory}/{f}", 'rb') as f_in:
+                    with open(f"{file_directory}/{extraction_folder}", 'wb') as f_out:
+                        f_out.write(f_in.read()) 
+        except Exception as e:
+            pass  
+        
+        try:
+            for f in _os.listdir(f"{file_directory}/{extraction_folder}"):
+                ex_folder = f.split('.', 1)[0]
+                with _gzip.open(f"{file_directory}/{extraction_folder}/{f}", 'rb') as f_in:
+                    with open(f"{file_directory}/{extraction_folder}/{ex_folder}", 'wb') as f_out:
+                        f_out.write(f_in.read()) 
+        except Exception as e:
+            pass     
+
+    elif file_extension == '.tar.gz':
+        try:
+            for f in _os.listdir(f"{file_directory}"):
+                extraction_folder = f.split('.', 1)[0]
+                with _tarfile.open(f"{file_directory}/{f}", "r:gz") as tar:
+                    tar.extractall(path=f"{file_directory}/{extraction_folder}")
+        except Exception as e:
+            pass
+        
+        try:
+            for f in _os.listdir(f"{file_directory}/{extraction_folder}"):
+                ex_folder = f.split('.', 1)[0]
+                with _tarfile.open(f"{file_directory}/{extraction_folder}/{f}", "r:gz") as tar:
+                    tar.extractall(path=f"{file_directory}/{extraction_folder}/{ex_folder}")
+        except Exception as e:
+            pass
+        
+    elif file_extension == '.tar':
+        try:
+            for f in _os.listdir(f"{file_directory}"):
+                extraction_folder = f.split('.', 1)[0]
+                with _tarfile.open(f"{file_directory}/{f}", 'r') as tar:
+                    tar.extractall(path=f"{file_directory}/{extraction_folder}")
+        except Exception as e:
+            pass
+        
+        try:
+            for f in _os.listdir(f"{file_directory}"):
+                ex_folder = f.split('.', 1)[0]
+                with _tarfile.open(f"{file_directory}/{extraction_folder}/{f}", 'r') as tar:
+                    tar.extractall(path=f"{file_directory}/{extraction_folder}/{ex_folder}")
+        except Exception as e:
+            pass
+        
+    else:
+        try:
+            for f in _os.listdir(f"{file_directory}"):
+                extraction_folder = f.split('.', 1)[0]
+                with _ZipFile(f"{file_directory}/{f}", 'r') as zObject:
+                    zObject.extractall(f"{file_directory}/{extraction_folder}")
+                zObject.close()
+        except Exception as e:
+            pass
+        
+        try:    
+            for f in _os.listdir(f"{file_directory}/{extraction_folder}"):
+                ex_folder = f.split('.', 1)[0]
+                with _ZipFile(f"{file_directory}/{extraction_folder}/{f}", 'r') as zObject:
+                    zObject.extractall(f"{file_directory}/{extraction_folder}/{ex_folder}")
+                zObject.close()   
+        except Exception as e:
+            pass         
+        
+    try:    
+        for f in _os.listdir(f"{file_directory}"):
+            if f.endswith(file_extension):
+                _os.remove(f"{file_directory}/{f}")
+    except Exception as e:
+        pass
+    
+    try:    
+        for f in _os.listdir(f"{file_directory}/{extraction_folder}"):
+            if f.endswith(file_extension):
+                _os.remove(f"{file_directory}/{extraction_folder}/{f}")
+    except Exception as e:
+        pass

shapeography-0.1/src/shapeography.egg-info/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: shapeography
+Version: 0.1
+Summary: A Python library that both a client that downloads various shapefiles and GEOJSON files from the web and processes these geometry files. Users can also process locally hosted shapefiles and GEOJSON files. Also works for those on VPN/PROXY connections.
+Author: Eric J. Drewitz
+Project-URL: Documentation, https://github.com/edrewitz/shapeography?tab=readme-ov-file#shapeography
+Project-URL: Repository, https://github.com/edrewitz/shapeography/tree/main
+Keywords: cartography,geography
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cartopy>=0.24.0
+Requires-Dist: geopandas>=1.1.0
+Requires-Dist: requests>=2.32.4
+Dynamic: license-file
+
+# shapeography
+
+
+
+<img src="https://github.com/edrewitz/shapeography/blob/main/Thumbnails/86506Livingston-Rev-Base.jpg?raw=true" width="200" alt="Alt text" /> <img src="https://github.com/edrewitz/WxData/blob/1be590e9a16033974a592d8cf99f3cd521f95e0b/icons/python%20logo.png?raw=true" width="200" alt="Alt text" />
+
+**(C) Eric J. Drewitz 2026**
+
+An open-source Python package that manages shapefiles and GEOJSON files. 
+
+***Jupyter Lab Examples***
+
+1) [Downloading and Plotting the National Weather Service Public Forecast Zones](https://github.com/edrewitz/shapeography-Jupyter-Lab-Examples/blob/main/nws_public_zones.ipynb)
+2) [Downloading and Plotting the NOAA/NWS Climate Prediction Center 6-10 Day Probabilistic Precipitation Outlook](https://github.com/edrewitz/shapeography-Jupyter-Lab-Examples/blob/main/cpc_outlook.ipynb)
+
+
+***Client Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/client.md#client-module)
+
+The `client` module hosts the client function `get_shapefiles()` that downloads shapefiles/GEOJSON file from a user-defined URL address into a folder locally on your PC.
+
+The user must specify the path and filename and the file is saved to {path}/{filename}. 
+
+This client is also helpful for those using shapeography in automated scripts. If the user keeps the optional argument `refresh=True` - The directory hosting the shapefiles/GEOJSON file will be refreshed as the old files will be deleted and new files downloaded. This can be helpful in automation due to periodic shapefile updates on the server-side as it ensures that the user will always have the most recent and up to date shapefiles/GEOJSON file. 
+
+This client supports users on a VPN/PROXY connection. 
+
+    **Proxy Example**
+
+    proxies=None ---> proxies={
+                           'http':'address:port',
+                           'https':'address:port'
+                        } 
+
+    shapeography.client.get_shapefiles(url, path, filename, proxies=proxies)
+
+***Unzip Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/unzip.md#unzip-module)
+
+The `unzip` module hosts the function that unzips the shapefiles/GEOJSON file if the file(s) need to be unzipped.
+
+In nearly all cases, shapefile components are within a zipfile server-side so needing to unzip is very common. 
+
+The function `extract_files()` unzips the shapefiles/GEOJSON into a user-specified extraction folder that is automatically generated. 
+
+Supports the following file extentions: .zip, .gz, .tar, .tar.gz
+
+***Geometry Module***
+
+[Documentation](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#geometry-module)
+
+The `geometry` module hosts functions that extract data from these shapefiles/GEOJSON file and make it significantly easier to work with this data in Python.
+
+The current functions are: 
+
+1) [`cartopy_shapefeature()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#1-cartopy_shapefeature) - Returns a cartopy.shapefeature from the data inside the shapefile/GEOJSON.
+2) [`get_geometries()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#2-get_geometries) - Returns a gpd.GeoDataFrame of the geometry data of the shapefile/GEOJSON in the coordinate reference system (CRS) specified by the user. (Default CRS = 'EPSG:4326' --> `ccrs.PlateCarree()`)
+3) [`geodataframe()`](https://github.com/edrewitz/shapeography/blob/main/Documentation/geometry.md#3-geodataframe) - Returns gpd.GeoDataFrame hosting all the data in the shapefile/GEOJSON in the coordinate reference system (CRS) specified by the user. (Default CRS = 'EPSG:4326' --> `ccrs.PlateCarree()`)
+
+# Citations
+
+1) **cartopy**: Phil Elson, Elliott Sales de Andrade, Greg Lucas, Ryan May, Richard Hattersley, Ed Campbell, Andrew Dawson, Bill Little, Stephane Raynaud, scmc72, Alan D. Snow, Ruth Comer, Kevin Donkers, Byron Blay, Peter Killick, Nat Wilson, Patrick Peglar, lgolston, lbdreyer, … Chris Havlin. (2023). SciTools/cartopy: v0.22.0 (v0.22.0). Zenodo. https://doi.org/10.5281/zenodo.8216315
+2) **geopandas**: Kelsey Jordahl, Joris Van den Bossche, Martin Fleischmann, Jacob Wasserman, James McBride, Jeffrey Gerard, … François Leblanc. (2020, July 15). geopandas/geopandas: v0.8.1 (Version v0.8.1). Zenodo. http://doi.org/10.5281/zenodo.3946761
+3) **requests**: K. Reitz, "Requests: HTTP for Humans". Available: https://requests.readthedocs.io/.

shapeography-0.1/src/shapeography.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/shapeography/__init__.py
+src/shapeography.egg-info/PKG-INFO
+src/shapeography.egg-info/SOURCES.txt
+src/shapeography.egg-info/dependency_links.txt
+src/shapeography.egg-info/requires.txt
+src/shapeography.egg-info/top_level.txt
+src/shapeography/client/__init__.py
+src/shapeography/client/client.py
+src/shapeography/utils/__init__.py
+src/shapeography/utils/geometry.py
+src/shapeography/utils/unzip.py

shapeography-0.1/src/shapeography.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

shapeography-0.1/src/shapeography.egg-info/requires.txt

@@ -0,0 +1,3 @@
+cartopy>=0.24.0
+geopandas>=1.1.0
+requests>=2.32.4

shapeography-0.1/src/shapeography.egg-info/top_level.txt

@@ -0,0 +1 @@
+shapeography