📚 dbfread2

🚀 A modern Python library for reading DBF files with elegance and type safety

dbfread2 is a modern, type-safe Python library for reading DBF files (dBase, Visual FoxPro, FoxBase+) with zero external dependencies.

✨ Highlights

• 🐍 Modern Python 3.12+ implementation
• 🔍 Comprehensive type hints
• 🛠️ Simple yet powerful API
• 📁 Native pathlib.Path support
• 🔄 Streaming and memory-loaded modes
• 📝 Support for all major DBF variants
• 📋 18 field types with extensible FieldParser
• 📎 Reads FPT and DBT memo files
• 🔒 Type-safe operations

🚀 Quick Start

from dbfread2 import DBF

# Stream records (memory-efficient)
for record in DBF('people.dbf'):
    print(record)
# {'NAME': 'Alice', 'BIRTHDATE': datetime.date(1987, 3, 1)}
# {'NAME': 'Bob', 'BIRTHDATE': datetime.date(1980, 11, 12)}

# Load all records into memory
table = DBF('people.dbf', load=True)
print(table.records[0]['NAME'])  # Returns: 'Alice'

📦 Installation

pip install dbfread2

🔄 Migration from dbfread

Key Changes

1. Python Version

   • ✅ Python 3.12+ required
   • ❌ No support for older versions

2. Import Updates

   # Before ❌
   from dbfread import DBF
   # After ✅
   from dbfread2 import DBF
   

3. Modern Parameter Names

   # Before ❌
   DBF('file.dbf', recfactory=dict, lowernames=True)
   # After ✅
   DBF('file.dbf', record_factory=dict, lowercase_names=True)
   

4. Path Support

   # ✨ New Feature
   from pathlib import Path
   DBF(Path('data/file.dbf'))
   

🛠️ Development

Setup

1. Install Tools

   • mise-en-place for environment management
   • uv for package management

2. Clone & Setup

   git clone https://github.com/wasdee/dbfread2.git
   cd dbfread2
   mise install
   uv pip install -e ".[docs]"
   

📚 Documentation

mise run docs:build    # Build docs
mise run docs:serve    # Serve locally
mise run docs:watch    # Watch mode
mise run docs:check    # Check for issues

✅ Code Quality

• 🧹 ruff - Linting & formatting
• 🔍 mypy - Static type checking

📄 License

MIT License

🙏 Credits

Fork of dbfread by Ole Martin Bjørndalen

📬 Contact

Nutchanon Ninyawee - me@nutchanon.org

⭐️ If this project helps you, consider giving it a star!