csv-member-reader 0.1.0

A Python library for reading member records from CSV files

csv-member-reader

A Python library for reading member records from CSV files. Supports both iteration (memory-efficient for large files) and loading all records at once.

Installation

pip install csv-member-reader

Requirements

• Python 3.9+
• No external dependencies

Quick Start

As a library

from csv_member_reader import CSVMemberReader

# Iterate over members (memory-efficient)
for member in CSVMemberReader("members.csv"):
    print(member.full_name)

# Load all members into a list
members = CSVMemberReader("members.csv").read()
print(members[0].first_name)  # "John"
print(members[0].full_name)   # "John Smith"

As a CLI tool

csv-member-reader path/to/members.csv

CSV Format

The CSV file must include these columns (order does not matter):

Column	Description
id	Unique identifier
first_name	First name
last_name	Last name
email	Email address
gender	Gender
ip_address	IP address

API Reference

CSVMemberReader(path)

Parameter	Type	Description
path	str or Path	Path to the CSV file

Methods:

• .read() → list[Member] — loads all records into memory
• __iter__ — yields Member objects one at a time

Raises: FileNotFoundError if the file does not exist.

---

Member

A dataclass with the following fields:

Field	Type
id	str
first_name	str
last_name	str
email	str
gender	str
ip_address	str

Property:

• .full_name → str — returns "{first_name} {last_name}"

License

MIT