"""
Pandass - A Python package with graph algorithms and pandas utilities
"""

__version__ = "0.1.0"
__author__ = "Your Name"
__email__ = "your.email@example.com"

import os
from pathlib import Path

# Get the package directory
PACKAGE_DIR = Path(__file__).parent
DATA_DIR = PACKAGE_DIR / "data"

def get_data_file(filename):
    """
    Get the path to a data file included with the package.
    
    Args:
        filename (str): Name of the data file (e.g., 'python1.txt', 'algorithms.txt')
    
    Returns:
        Path: Full path to the data file
    """
    file_path = DATA_DIR / filename
    if not file_path.exists():
        raise FileNotFoundError(f"Data file '{filename}' not found in package")
    return file_path

def read_data_file(filename):
    """
    Read and return the contents of a data file.
    
    Args:
        filename (str): Name of the data file
    
    Returns:
        str: Contents of the file
    """
    file_path = get_data_file(filename)
    with open(file_path, 'r', encoding='utf-8') as f:
        return f.read()

# List available data files
def list_data_files():
    """
    List all available data files in the package.
    
    Returns:
        list: List of available data filenames
    """
    if DATA_DIR.exists():
        return [f.name for f in DATA_DIR.iterdir() if f.is_file()]
    return []

__all__ = ['get_data_file', 'read_data_file', 'list_data_files', '__version__']
