ms-file-toolkit

Microsoft, OpenDocument va PDF fayllarni o'qish va yozish uchun Python toolkit — AI function calling (Claude, GPT va h.k.) uchun tayyor tool schemalari, xavfsizlik nazorati, avtomatik format aniqlash, format konvertatsiya va CLI bilan.

O'rnatish

pip install -r requirements.txt

Yoki paket sifatida:

pip install -e ".[ai,dev]"

Qo'llab-quvvatlanadigan formatlar

Eski formatlar va konvertatsiya uchun tizimda LibreOffice (soffice) kerak: apt-get install libreoffice OCR (read_image_text) uchun Tesseract kerak: apt-get install tesseract-ocr

Format konvertatsiya

from ms_toolkit import dispatch

dispatch("convert_docx_to_pdf", {"file_path": "hujjat.docx", "output_path": "hujjat.pdf"})
dispatch("convert_pptx_to_images", {"file_path": "taqdimot.pptx", "output_dir": "slaydlar/"})
dispatch("convert_pdf_to_images", {"file_path": "hujjat.pdf", "output_dir": "sahifalar/"})
dispatch("convert_xlsx_to_csv", {"file_path": "hisobot.xlsx", "output_dir": "csv_export/"})

convert_pptx_to_images va convert_pdf_to_images tashqi system-binary talab qilmaydi (PyMuPDF orqali); convert_*_to_pdf funksiyalari LibreOffice orqali ishlaydi.

Xavfsizlik

Fayl yo'llari AI tomonidan tanlanadi, shuning uchun path traversal himoyasi bor (ms_toolkit/security.py) — bu himoya yangi qo'shilgan barcha tool'larga (CSV, OpenDocument, rasm, arxiv, konvertatsiya) avtomatik qo'llaniladi:

export MS_TOOLKIT_BASE_DIR=/home/bot/user_files

dispatch("read_docx_text", {"file_path": "../../etc/passwd"})
# -> {"error": "Xavfsizlik xatosi: ..."}

ZIP arxivlarni chiqarishda (extract_archive) qo'shimcha zip-slip himoyasi bor — arxiv ichidagi hech qanday yozuv output_dir tashqarisiga chiqib keta olmaydi.

CLI

ms-toolkit list
ms-toolkit run create_docx '{"file_path": "a.docx", "title": "Salom", "overwrite": true}'
ms-toolkit run read_any_file '{"file_path": "hujjat.xlsx"}'

Testlar

pip install -e ".[dev]"
pytest tests/ -v          # 40 ta test (23 asosiy + 17 kengaytirilgan)

Function calling bilan (Claude API)

from ms_toolkit import TOOLS, dispatch
import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    tools=TOOLS,
    messages=[{"role": "user", "content": "test.xlsx faylida nechta qator bor?"}],
)

for block in response.content:
    if block.type == "tool_use":
        print(dispatch(block.name, block.input))

Barcha tool'lar ro'yxati (62 ta)

• DOCX (9): read_docx_text, read_docx_tables, get_docx_metadata, create_docx, append_docx_text, replace_docx_text, add_docx_heading, add_docx_image, add_docx_page_break
• XLSX (10): get_xlsx_sheet_names, read_xlsx_data, get_xlsx_summary, create_xlsx, add_xlsx_sheet, append_xlsx_rows, set_xlsx_formula, format_xlsx_cells, freeze_xlsx_panes, add_xlsx_chart
• PPTX (8): read_pptx_text, get_pptx_slide_count, extract_pptx_notes, create_pptx, add_pptx_slide, add_pptx_image, set_pptx_background_color, add_pptx_chart
• PDF (6): read_pdf_text, read_pdf_tables, get_pdf_metadata, create_pdf, merge_pdfs, split_pdf
• CSV (4): read_csv_data, get_csv_summary, create_csv, append_csv_rows
• OpenDocument (8): read_odt_text, get_ods_sheet_names, read_ods_data, read_odp_text, get_odp_slide_count, create_odt, create_ods, create_odp
• Rasm (4): get_image_info, read_image_text, convert_image, create_thumbnail
• Arxiv (4): list_archive_contents, read_archive_file, create_archive, extract_archive
• Konvertatsiya (6): convert_docx_to_pdf, convert_pptx_to_pdf, convert_xlsx_to_pdf, convert_pdf_to_images, convert_pptx_to_images, convert_xlsx_to_csv
• Eski formatlar (1): read_legacy_file
• Auto-detect (2): read_any_file, get_file_info

Struktura

ms_toolkit/
  __init__.py
  docx_tool.py / docx_writer.py
  xlsx_tool.py / xlsx_writer.py
  pptx_tool.py / pptx_writer.py
  pdf_tool.py / pdf_writer.py
  csv_tool.py / csv_writer.py
  opendoc_tool.py / opendoc_writer.py   # .odt/.ods/.odp
  image_tool.py / image_writer.py       # rasm + OCR
  archive_tool.py / archive_writer.py   # ZIP
  convert_tool.py                       # format konvertatsiya
  legacy_tool.py
  auto_tool.py
  security.py
  cli.py
  schemas.py
  registry.py
tests/
pyproject.toml
requirements.txt

Litsenziya

MIT