在Python编程中，合并PDF文件是一项常见的任务，特别是在处理大量文档时。本示例将详细介绍如何使用Python将同一个文件夹下的所有PDF文件合并为一个单一的PDF文档。这个过程涉及到了对PDF文件的读取、判断、解密（如果需要的话）以及写入合并等操作。以下是详细的步骤和相关知识点：
1. **导入必要的库**：
我们需要导入Python中的几个库来执行此操作。这里用到的是`os`库，用于遍历文件夹，`os.path`用于处理路径，`pyPdf`库用于处理PDF文件的读取、解密和合并。
```python
import os
import os.path
from pyPdf import PdfFileReader, PdfFileWriter
```
2. **获取文件夹中的PDF文件列表**：
`getFileName()`函数利用`os.walk()`遍历指定的文件夹，收集所有PDF文件的完整路径，并将它们存储在一个列表中。
```python
def getFileName(filepath):
file_list = []
for root, dirs, files in os.walk(filepath):
for filename in files:
if filename.endswith('.pdf'):
file_list.append(os.path.join(root, filename))
return file_list
```
3. **PDF文件的合并**：
`MergePDF()`函数是整个过程的核心。它接收两个参数：文件夹路径和输出合并后的PDF文件名。该函数创建一个新的`PdfFileWriter`对象，然后遍历所有PDF文件，逐一读取它们的页面，添加到输出对象中。
```python
def MergePDF(filepath, outfile):
output = PdfFileWriter()
outputPages = 0
pdf_fileNames = getFileName(filepath)
for each in pdf_fileNames:
# 读取源pdf文件
input = PdfFileReader(file(each, "rb"))
# 检查是否加密并解密
if input.isEncrypted == True:
input.decrypt("map")
# 获取源pdf文件中页面总数并累加
pageCount = input.getNumPages()
outputPages += pageCount
# 将每一页添加到输出
for iPage in range(0, pageCount):
output.addPage(input.getPage(iPage))
print "All Pages Number:", str(outputPages)
# 写入合并后的PDF文件
outputStream = file(filepath + outfile, "wb")
output.write(outputStream)
outputStream.close()
print "finished"
```
4. **主函数调用**：
在主程序中，定义要合并的文件夹路径和输出文件名，然后调用`MergePDF()`函数进行实际的合并操作。计算并打印整个过程的运行时间。
```python
if __name__ == '__main__':
file_dir = r'D:/course/'
out = u"第一周.pdf"
MergePDF(file_dir, out)
time2 = time.time()
print u'总共耗时：' + str(time2 - time1) + 's'
```
这个示例不仅展示了如何合并PDF文件，还涉及到文件路径处理、条件判断（如检查PDF是否加密）和时间戳操作等基本编程概念。通过这个脚本，你可以批量处理文件夹中的PDF，方便管理和查看文档。需要注意的是，`pyPdf`库可能无法处理某些复杂或加密的PDF文件，这时可能需要寻找其他库，如`PyPDF2`或`PDFMiner`等替代方案。
