dbfread2

📚 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

• Python Version

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

• Import Updates

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

• Modern Parameter Names

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

• Path Support

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

🛠️ Development

Setup

• Install Tools

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

• 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 - [e-mail]

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