Skip to content

πŸ“š Actuaries India Paper Downloader - Automated exam papers & solutions merger for Indian actuarial students

License

Notifications You must be signed in to change notification settings

reachvivek/actuaries-india-paper-downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ“ Actuaries India - Question Papers & Solutions Downloader

A user-friendly Python application that automatically downloads and merges actuarial exam papers from the Institute of Actuaries of India website.

Python License

✨ Features

  • πŸ“… Custom Date Range: Select any date range (e.g., Jun 2005 to Sep 2018)
  • πŸ“š All Subjects: Choose from 40+ available subjects (ST, SP, CT, CP, CM, CS, CB, SA, CA)
  • πŸ”„ Auto-Merge: Downloads and merges question papers + solutions into one PDF
  • πŸ“Š Organized: PDFs are sorted in decreasing chronological order
  • 🎯 User-Friendly: Interactive menu-driven interface
  • βœ… Validation: Checks PDF integrity and skips corrupt files
  • πŸ“ Clean Output: Organized folder structure with timestamps

πŸš€ Quick Start

Prerequisites

  • Python 3.7 or higher
  • Internet connection

Windows Setup

  1. Download or Clone this repository

    git clone <repository-url>
    cd PdfMerger
  2. Run the setup script (automatically installs dependencies)

    python app.py

    The first run will automatically install required packages if missing.

Manual Setup (if needed)

  1. Install Python dependencies

    pip install -r requirements.txt
  2. Run the application

    python app.py

πŸ“– How to Use

Step 1: Run the Application

python app.py

Step 2: Enter Date Range

πŸ“… DATE RANGE SELECTION:
Please enter the date range (format: MMM YYYY)
Examples: 'Jun 2005', 'Sep 2018', 'May 2025'

Enter START date (e.g., 'Jun 2005'): Jun 2005
Enter END date (e.g., 'Sep 2018'): Sep 2018

Step 3: Select Subject

The application will show all available subjects organized by category:

πŸ“š SUBJECT SELECTION:
Available subjects:

πŸ“– Core Principles (CP):
   1. CP1A - Actuarial Practice
   2. CP1B - Actuarial Practice
   3. CP2A - Actuarial Modelling

πŸ“– Specialist Technical (ST):
  15. ST1 - Health and Care Insurance
  16. ST2 - Life Insurance
  17. ST6 - Finance and Investment B

Select subject (1-45): 17

Step 4: Wait for Download & Merge

The application will:

  • Find all available sessions in your date range
  • Download question papers and solutions
  • Merge everything into one PDF file
  • Show progress with real-time updates

Step 5: Get Your PDF

πŸŽ‰ SUCCESS! Your merged PDF is ready:
πŸ“„ File: Actuaries_ST6_Jun2005_to_Sep2018_Merged.pdf
πŸ“ Location: D:\PdfMerger\downloads\session_20241205_143022\Actuaries_ST6_Jun2005_to_Sep2018_Merged.pdf
πŸ“Š Total PDFs merged: 54
πŸ“š Subject: ST6 - Finance and Investment B
πŸ“… Date range: Jun 2005 to Sep 2018

πŸ“‚ Output Structure

downloads/
β”œβ”€β”€ session_20241205_143022/          # Timestamped session folder
β”‚   β”œβ”€β”€ individuals/                  # Individual PDF files
β”‚   β”‚   β”œβ”€β”€ June_2005_Question.pdf
β”‚   β”‚   β”œβ”€β”€ June_2005_Solution.pdf
β”‚   β”‚   β”œβ”€β”€ November_2005_Question.pdf
β”‚   β”‚   └── ...
β”‚   └── Actuaries_ST6_Jun2005_to_Sep2018_Merged.pdf  # Final merged PDF

🎯 Example Use Cases

For Students

# Get all ST-6 papers for preparation
Start: Jun 2005
End: Sep 2018
Subject: ST6 - Finance and Investment B

For Reference

# Get recent SP-6 papers
Start: Jun 2019
End: May 2025
Subject: SP6 - Financial Derivatives

For Complete Study

# Get all CT-1 papers ever available
Start: Nov 2005
End: Nov 2024
Subject: CT1 - Financial Mathematics

πŸ“š Available Subjects

The application supports all subjects available on the Actuaries India website:

Core Subjects:

  • CP (Core Principles): Actuarial Practice, Actuarial Modelling, Communication
  • CM (Core Mathematics): Actuarial Mathematics, Financial Engineering
  • CS (Core Statistics): Actuarial Statistics, Risk Modelling
  • CB (Core Business): Business Finance, Business Economics, Business Management

Specialist Subjects:

  • ST (Specialist Technical): Health Insurance, Life Insurance, General Insurance, Pensions, Finance & Investment
  • SP (Specialist Principles): Health & Care, Life Insurance, Pensions, Investment & Finance, Financial Derivatives, General Insurance
  • SA (Specialist Advanced): Advanced versions of specialist subjects

Legacy Subjects:

  • CT (Core Technical): Financial Mathematics, Finance, Statistics, Models, Economics
  • CA (Core Applications): Risk Management, Communications

⚠️ Important Notes

  1. Internet Required: Application downloads files from actuariesindia.org
  2. Large Downloads: Some date ranges may result in 100+ MB downloads
  3. Processing Time: Larger ranges take more time (typically 1-5 minutes)
  4. PDF Validation: Corrupt PDFs are automatically skipped
  5. Respectful Usage: Application includes reasonable delays between requests

πŸ› οΈ Troubleshooting

Common Issues

"No PDFs found in the specified date range"

  • Check if the website has papers for those dates
  • Try a broader date range
  • Verify subject availability for that time period

"SSL Certificate Error"

  • The application handles this automatically
  • If issues persist, check your internet connection

"Module not found" errors

  • Run: pip install -r requirements.txt
  • Make sure Python 3.7+ is installed

Slow downloads

  • Normal for large date ranges
  • Application shows progress bars
  • Can be interrupted with Ctrl+C

πŸ“‹ Requirements

Automatically installed dependencies:

  • requests - For web scraping
  • beautifulsoup4 - For parsing HTML
  • PyPDF2 - For PDF operations
  • tqdm - For progress bars
  • python-dateutil - For date parsing

🀝 Contributing

Feel free to:

  • Report bugs or issues
  • Suggest new features
  • Submit improvements
  • Share with fellow actuaries

πŸ“„ License

This project is for educational purposes. Please respect the Institute of Actuaries of India's terms of service.

πŸ™ Acknowledgments

  • Institute of Actuaries of India for providing question papers
  • Python community for excellent libraries
  • Fellow actuaries who inspired this tool

Happy studying! πŸ“šβœ¨

Made with ❀️ for the actuarial community

About

πŸ“š Actuaries India Paper Downloader - Automated exam papers & solutions merger for Indian actuarial students

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages