=========================

📄 OFFLINE DOCX + EXCEL CHEAT SHEET

=========================

🛠 LIBRARIES:
-------------
1. python-docx → Create and modify Word files
2. pandas → Load, filter, and manipulate Excel data
3. openpyxl → Used by pandas to read/write Excel files

=========================
📦 INSTALLATION
=========================
pip install python-docx pandas openpyxl

=========================
📚 WORD DOCX (python-docx)
=========================
from docx import Document

📌 Load a Word file:

doc = Document("template.docx")

📌 Save a Word file:

doc.save("output.docx")

📌 Access paragraphs:
for para in doc.paragraphs:
print(para.text)

📌 Replace text:
para.text = para.text.replace("old", "new")

📌 Add paragraph:
doc.add_paragraph("Hello world")

📌 Add heading:
doc.add_heading("Title", level=1)

📌 Add page break:

doc.add_page_break()

📌 Add a table:
table = doc.add_table(rows=1, cols=3)
table.style = 'Table Grid'

📌 Add row to table:

row_cells = table.add_row().cells
row_cells[0].text = "Name"
row_cells[1].text = "Role"
row_cells[2].text = "Date"

📌 Access table cells:

for row in table.rows:
for cell in row.cells:
print(cell.text)

📌 Set font size or bold:

 from docx.shared import Pt
run = doc.paragraphs[0].runs[0]
run.font.size = Pt(12)
run.bold = True

=========================
📚 EXCEL (pandas + openpyxl)
=========================
import pandas as pd

📌 Read Excel:
df = pd.read_excel("data.xlsx")

📌 Save Excel:
df.to_excel("new_file.xlsx", index=False)

📌 Show columns:
print(df.columns)

📌 Filter rows:
df[df["‫]"فني شبكات" == ]"الوظيفة‬

📌 Select columns:
df[["‫ "التاريخ‬,"‫]]"االسم‬

📌 Loop through rows:

for index, row in df.iterrows():
print(row["‫]"االسم‬, row["‫)]"التاريخ‬

📌 Slice rows:
df.iloc[0:4]

📌 Add new column:

df["new_col"] = "default_value"

📌 Modify values:
df["‫ = ]"التاريخ‬df["‫]"التاريخ‬.astype(str)

📌 Append new row:

df.loc[len(df)] = ["12-05-2025" ,"‫ "مهندسة بيانات‬,"‫]"رنا‬

📌 Sort rows:
df.sort_values("‫)"التاريخ‬

📌 Remove rows:
df = df.drop([0, 1]) # by index

📌 Remove duplicates:
df = df.drop_duplicates()

📌 Fill missing values:

df.fillna("N/A")

=========================
🧩 COMPLETE WORD + EXCEL EXAMPLE
=========================
from docx import Document
import pandas as pd
df = pd.read_excel("data.xlsx")
doc = Document("template.docx")
group = df.iloc[0:4]["‫]"االسم‬.tolist()

for i in range(4):
for p in doc.paragraphs:
p.text = p.text.replace(f"(‫{االسم‬i+1})", group[i] if i < len(group) else "")

doc.save("output.docx")

=========================
📄 python-docx (Word) Examples
=========================

✅ Load and Save Document

--------------------------
from docx import Document

doc = Document("template.docx")
doc.save("output.docx")

✍️ Add Paragraphs and Headings

-------------------------------
doc.add_heading("Report Title", level=1)
doc.add_paragraph("This is a simple paragraph.")

🔁 Replace Text in Paragraphs

-------------------------------
for para in doc.paragraphs:
if "(1‫ ")االسم‬in para.text:
para.text = para.text.replace("(1‫")االسم‬, "‫)"عمر‬

📄 Add Page Break

-------------------------------
doc.add_page_break()

📋 Add Table and Fill It

-------------------------------
table = doc.add_table(rows=1, cols=3)
table.style = "Table Grid"
table.cell(0, 0).text = "‫"االسم‬
table.cell(0, 1).text = "‫"الوظيفة‬
table.cell(0, 2).text = "‫"التاريخ‬

data = [("06-05-2025" ,"‫ "مهندس نظم‬,"‫)"عمر‬,

("07-05-2025" ,"‫ "فني شبكات‬,"‫])"أحمد‬

for name, job, date in data:

cells = table.add_row().cells
cells[0].text = name
cells[1].text = job
cells[2].text = str(date)
🎨 Format Text (Font, Size, Bold)
-------------------------------
from docx.shared import Pt

p = doc.add_paragraph()
run = p.add_run("Formatted Text")
run.bold = True
run.font.size = Pt(14)

📑 Read Tables from Document

-------------------------------
for table in doc.tables:
for row in table.rows:
for cell in row.cells:
print(cell.text)

=========================
🔁 SPLIT DOCUMENTS IN CHUNKS and replace names
=========================

from docx import Document

import pandas as pd

# Load Excel file

df = pd.read_excel("data.xlsx")

# Load Word template

doc = Document("template.docx")

# Replace (1‫ )االسم‬to (4‫ )االسم‬in paragraphs

names = df["‫]"االسم‬.tolist()[:4]
for i in range(4):
for p in doc.paragraphs:
p.text = p.text.replace(f"(‫{االسم‬i+1})", names[i] if i < len(names) else "")

# Save result
doc.save("output.docx")

=========================
🔁 SPLIT DOCUMENTS IN CHUNKS
=========================
for i in range(0, len(df), 4):
doc = Document("template.docx")
group = df.iloc[i:i+4]["‫]"االسم‬.tolist()
for j in range(4):
for p in doc.paragraphs:
p.text = p.text.replace(f"(‫{االسم‬j+1})", group[j] if j < len(group) else
"")
doc.save(f"output_{i//4 + 1}.docx")

=========================
📊 pandas + openpyxl (Excel) Examples
=========================

✅ Read and Write Excel

-------------------------------
import pandas as pd

df = pd.read_excel("data.xlsx")
df.to_excel("new_data.xlsx", index=False)

🔍 Filter and Select Data

-------------------------------
df_filtered = df[df["‫]"فني شبكات" == ]"الوظيفة‬
df_subset = df[["‫ "التاريخ‬,"‫]]"االسم‬

➕ Add/Update Columns and Rows

-------------------------------
df["status"] = "Active"
df.loc[len(df)] = ["12-05-2025" ,"‫ "محللة بيانات‬,"‫"رنا‬, "Active"]

🔄 Modify Column Values

-------------------------------
df["‫ = ]"التاريخ‬df["‫]"التاريخ‬.astype(str)
df.at[0, "‫"مبرمج" = ]"الوظيفة‬

📑 Sort, Drop, Fill

-------------------------------
df = df.sort_values("‫)"التاريخ‬
df = df.drop(columns=["status"])
df = df.fillna("N/A")

🔁 Loop Through Rows

-------------------------------
for index, row in df.iterrows():
print(f"{row['‫ }]'االسم‬works as {row['‫ }]'الوظيفة‬on {row['‫)"}]'التاريخ‬

📂 Group and Aggregate

-------------------------------
job_counts = df.groupby("‫)"الوظيفة‬.size()
print(job_counts)

earliest_date = df.groupby("‫]"التاريخ"[)"الوظيفة‬.min()
print(earliest_date)

🧾 Read Excel with Multiple Sheets

-------------------------------
xls = pd.ExcelFile("multi_sheet.xlsx")
df1 = pd.read_excel(xls, "Sheet1")
df2 = pd.read_excel(xls, "Sheet2")
=========================
📘 Project 1: Certificate Generator (Simple)
=========================
Goal: Read a list of student names from Excel and generate personalized Word
certificates.

Excel (students.xlsx):
------------------------
| ‫االسم‬ |
|----------|
| ‫أحمد‬ |
| ‫منى‬ |
| ‫يوسف‬ |

Word Template (certificate_template.docx):

------------------------------------------
This is to certify that (‫ )االسم‬has completed the course.

Python Code:
------------------------------------------
import pandas as pd
from docx import Document

df = pd.read_excel("students.xlsx")

for index, row in df.iterrows():

doc = Document("certificate_template.docx")
name = row["‫]"االسم‬

for p in doc.paragraphs:
if "(‫ ")االسم‬in p.text:
p.text = p.text.replace("(‫")االسم‬, name)

doc.save(f"Certificate_{name}.docx")

=========================
📘 Project 2: Staff Report Generator (Moderate)
=========================
Goal: Read employee data from Excel and generate a report table in a Word document.

Excel (employees.xlsx):
------------------------
| ‫| التاريخ‬ ‫| الوظيفة‬ ‫االسم‬ |
|----------|------------|----------------|
| 06-05-2025 | ‫| مهندس نظم‬ ‫عمر‬ |
| 07-05-2025 | ‫| محلل بيانات‬ ‫خالد‬ |

Python Code:
------------------------------------------
import pandas as pd
from docx import Document

df = pd.read_excel("employees.xlsx")
doc = Document()
doc.add_heading("Employee Daily Report", level=1)

table = doc.add_table(rows=1, cols=3)

table.style = "Table Grid"
table.cell(0, 0).text = "‫"االسم‬
table.cell(0, 1).text = "‫"الوظيفة‬
table.cell(0, 2).text = "‫"التاريخ‬

for _, row in df.iterrows():

cells = table.add_row().cells
cells[0].text = str(row["‫)]"االسم‬
cells[1].text = str(row["‫)]"الوظيفة‬
cells[2].text = str(row["‫)]"التاريخ‬

doc.save("Staff_Report.docx")

=========================
📘 Project 3: Multi-Page Offer Letters (Advanced)
=========================
Goal: Read job offers from Excel and generate a multi-paragraph Word document for
each candidate.

Excel (offers.xlsx):
------------------------
| ‫| تاريخ البدء‬ ‫| المسمى الوظيفي | الراتب‬ ‫| االسم‬
|----------|----------------|----------|-------------|
| 01-07-2025 | ‫ ج‬8000 | ‫| مطور برمجيات‬ ‫| ندى‬

Word Template (offer_template.docx):

------------------------------------------
Dear (‫)االسم‬,

We are pleased to offer you the position of (‫ )المسمى الوظيفي‬at our company.
Your starting salary will be (‫)الراتب‬, beginning on (‫)تاريخ البدء‬.

Best regards,
HR Department

Python Code:
------------------------------------------
import pandas as pd
from docx import Document

df = pd.read_excel("offers.xlsx")

for _, row in df.iterrows():

doc = Document("offer_template.docx")
replacements = {
"(‫")االسم‬: row["‫]"االسم‬,
"(‫")المسمى الوظيفي‬: row["‫]"المسمى الوظيفي‬,
"(‫")الراتب‬: str(row["‫)]"الراتب‬,
"(‫")تاريخ البدء‬: str(row["‫)]"تاريخ البدء‬
}

for p in doc.paragraphs:
for key, val in replacements.items():
if key in p.text:
 p.text = p.text.replace(key, val)

doc.save(f"Offer_Letter_{row['‫}]'االسم‬.docx")

=========================
➜Project 4: Student Evaluation Generator (Excel ➜ Word & Feedback in Excel)
=========================
Goal:
- Read student scores from Excel
- Generate personalized Word feedback letters
- Write feedback evaluations back to Excel

Excel (students_scores.xlsx):
------------------------
| ‫| الدرجة‬ ‫| االسم‬
|--------|--------|
| 90 | ‫خالد‬ |
| 72 | ‫منى‬ |
| 55 | ‫أحمد‬ |

Word Template (feedback_template.docx):

------------------------------------------
)‫عزيزي (االسم‬،

‫لقد حصلت على درجة (الدرجة) في االختبار النهائي‬.

)‫ (التقييم‬:‫تقييمك العام هو‬

‫نتمنى لك دوام النجاح والتفوق‬.

Python Code:
------------------------------------------
import pandas as pd
from docx import Document

df = pd.read_excel("students_scores.xlsx")

def get_evaluation(score):
if score >= 85:
return "‫"ممتاز‬
elif score >= 70:
return "‫"جيد جدًا‬
elif score >= 50:
return "‫"مقبول‬
else:
return "‫"ضعيف‬

for i, row in df.iterrows():

name = row["‫]"االسم‬
score = row["‫]"الدرجة‬
evaluation = get_evaluation(score)

df.at[i, "‫ = ]"التقييم‬evaluation

doc = Document("feedback_template.docx")
for p in doc.paragraphs:
p.text = p.text.replace("(‫")االسم‬, name)
p.text = p.text.replace("(‫")الدرجة‬, str(score))
 p.text = p.text.replace("(‫")التقييم‬, evaluation)

doc.save(f"Feedback_{name}.docx")

df.to_excel("students_scores_updated.xlsx", index=False)

=========================
📎 TIPS & TRICKS
=========================
- Always check encoding if you read/write Arabic data.
- Excel date columns can be converted to strings using: df["date"] =
df["date"].astype(str)
- python-docx does not support editing headers/footers directly.

=========================
📂 FILE FORMATS SUPPORTED
=========================
- .docx for Word files (not .doc)
- .xlsx for Excel files (not .xls)