dsr-files 1.0.0

File handling library for creating, saving, and loading various file types (CSV, JSON, JOBLIB, PDF)

dsr-files

File handling library for creating, saving, and loading various file types.

Version 1.0.0: This release is breaking and not backward-compatible with prior 0.x versions.

Features

• CSV: Read and write CSV files with pandas
• JSON: Save and load JSON data structures
• JOBLIB: Serialize Python objects with joblib
• Excel: Save and load Excel workbooks (single or multi-sheet)
• PDF: Generate PDF documents with text content

Installation

pip install dsr-files

Development Installation

pip install -e ".[dev]"

Usage

CSV Operations

from dsr_files import save_csv, load_csv, create_csv
import pandas as pd
from pathlib import Path

# Create from dictionary
data = {"name": ["Alice", "Bob"], "age": [30, 25]}
df = create_csv(data)

# Save to CSV
save_csv(df, Path("."), "data")

# Load from CSV
df = load_csv(Path("data.csv"))

JSON Operations

from dsr_files import save_json, load_json
from pathlib import Path

data = {"key": "value", "number": 42}

# Save to JSON
save_json(data, Path("."), "data")

# Load from JSON
data = load_json(Path("data.json"))

JOBLIB Operations

from dsr_files import save_joblib, load_joblib
from pathlib import Path

# Save any Python object
model = {"weights": [1, 2, 3], "config": {}}
save_joblib(model, Path("."), "model")

# Load from JOBLIB
model = load_joblib(Path("model.joblib"))

Excel Operations

from dsr_files import save_excel, load_excel, ExcelSheetConfig
from pathlib import Path
import pandas as pd

sales = pd.DataFrame({"region": ["NA", "EU"], "revenue": [120, 95]})
costs = pd.DataFrame({"region": ["NA", "EU"], "cost": [80, 70]})

# Save multi-sheet workbook
save_excel(
	[
		ExcelSheetConfig(data=sales, sheet_name="Sales"),
		ExcelSheetConfig(data=costs, sheet_name="Costs"),
	],
	Path("."),
	"report",
)

# Load first sheet
df = load_excel(Path("report.xlsx"))

PDF Operations

from dsr_files import save_pdf
from pathlib import Path

# Save text to PDF
content = "Hello, World!\nThis is a PDF document."
save_pdf(content, Path("."), "document", title="My Document")

Testing

pytest tests/
pytest tests/ --cov=src/dsr_files

License

MIT