myprayer 3.2.0

A CLI tool to get prayer times

MyPrayer

MyPrayer is a command line application for getting Islamic prayer times for a given location and date.

Features

• Get prayer times for a specific date and location
• Show next upcoming prayer time
• Support from multiple calculation methods
• Output prayer times in different formats
• Save default location and settings

Dependencies

• Python 3.8+
• Typer - CLI app framework
• Inquirer.py - user prompts
• Rich - output formatting
• adhanpy - Prayer times calculation
• geopy - Geocoding library
• tzlocal - Local timezone
• pydantic - Data validation
• tzdata - Timezone data

Install

pip install myprayer

Usage

myprayer

Usage: myprayer [OPTIONS] COMMAND [ARGS]...                                                 

MyPrayer CLI.                                                                               

Options 
  --install-completion        [bash|zsh|fish|powershell|pwsh]   Install completion for the specified shell.              
                                                                [default: None]               
  --show-completion           [bash|zsh|fish|powershell|pwsh]   Show completion for the specified shell, to copy it or customize the installation.   
                                                                [default: None]               
  --help                                                        Show this message and exit.    

Commands
  config                   Configure myprayer.                                              
  list                     List prayer times.                                               
  next                     Show next prayer.  

myparyer list

Usage: myprayer list [OPTIONS]                                                                                                                                                                 
List prayer times.                                                                                                                                                                             
Options 
 --city                 -c        TEXT                         City name.                            
 --country              -C        TEXT                         Country name.                              
 --address              -a        TEXT                         Address.                               
 --latitude             -lat      FLOAT                        Latitude.                               
 --longitude            -lon      FLOAT                        Longitude. 
 --date                 -d        [%Y-%m-%d|%Y-%m-%dT%H:%M:%S  Date (YYYY-MM-DD) ISO 8601
 --method               -M        INTEGER                      Calculation method. [default: (Egyptian General Authority of Survey)]         
 --time-format          -t        [12|24]                      Time format. [default: 12]       
 --custom-time-format   -T        TEXT                         Custom time format.
 --output               -o        [pretty|machine|table|json]  Output type. [default: table]            
 --next                 -n                                     Show next prayer, has no effect if day, month, or year are given. [default: True]         
 --help                                                        Show this message and exit.  

myparyer next

Usage: myprayer next [OPTIONS]                                                                                                                                                                 
Show next prayer. 

Options 
 --city         -c        TEXT                         City name.                            
 --country      -C        TEXT                         Country name.                              
 --address      -a        TEXT                         Address.                               
 --latitude     -lat      FLOAT                        Latitude.                               
 --longitude    -lon      FLOAT                        Longitude. 
 --day          -d        INTEGER RANGE [1<=x<=31]     Day (1-31) [default: (Current day)]            
 --method       -M        INTEGER                      Calculation method. [default: (Egyptian General Authority of Survey)]         
 --time-format  -t        [12|24]                      Time format. [default: 12]       
 --output       -o        [pretty|machine|table|json]  Output type. [default: table]            
 --help                                                Configure default settings

Configuration

Default settings like location, calculation method, and output format can be configured in $XDG_CONFIG_HOME/myprayer/config.json or $HOME/.config/myprayer/config.json using myprayer config.

Example configuration

{
    "time_format": "12", // 12 or 24
    "custom_time_format": "%I:%M", // Custom time format
    "print_type": "table", // pretty, machine, table, json
    "method": 5, // Calculation method
    "show_next": true, // Highlight next prayer in list
    "prayers": [ // Prayer to show
        "Fajr",
        "Dhuhr",
        "Asr",
        "Maghrib",
        "Isha"
    ],
    "location": { // Default location used if no location is provided in command
        "latitude": 30,
        "longitude": 31,
    }
}

Credits

• adhanpy - Prayer times calculation

License

This project is licensed under the MIT License - see the LICENSE file for details.