salat

3.1.1 • Public • Published

Salat npm version

Description

Daily prayer time in all the cities in Morocco 🇲🇦, directly in your terminal, at the tip of your fingers

A stupid simple Command line utility to get the daily prayers time for all the citiy in Morocco

The source of the data is the Moroccan Ministery Website

Getting started

# Install

$ npm i -g salat

# Run with default city

$ salat

# Run with custom city

$ salat [cityName]

Alternatively, if you don't want to install it globally, you can just use:

npx salat

City name should be provided the same way it's written in the cities.json

Output

# The programs prints to the console the prayers' time for the current day in the default city as shown bellow:

screen 1 screen 2 screen 3

Dependecies

The code behind depends on :

  • axios to make an http request ( fetch the data).
  • jsdom to parse the html result.
  • chalk to avoid boring styles and colors.
  • node-localstorage to read and write from localstorage.

Change the default city

  • The default city is ❤️ Marrakech ❤️, set as a value for the DEFAULT_CITY variable in ./constants.js

  • You can change it by replacing Marrakech by your city name according to the values from ./data/cities.json

Help

  • Please keep in mind that this is a work in progress in a very early stages, any help is appreciated and more than welcome.

  • If you think this piece of code is anyhow useful, please feel free to contribute, star ⭐⭐ and share 🙏 🙏

Todo

  • [x] Use a default city
  • [x] Use localstorage-like api for caching purposes
  • [x] Display execution time
  • [ ] Improve performance
  • [ ] Add unit tests
  • [ ] Add a documentation site
  • [ ] Command to set the default city
  • [ ] Command to display the list of available cities
  • [ ] Command to display the time table for the whole month

License

This project is under the MIT license.

Built With ❤️ in Ramadan

Package Sidebar

Install

npm i salat

Weekly Downloads

12

Version

3.1.1

License

MIT

Unpacked Size

18.9 kB

Total Files

7

Last publish

Collaborators

  • kafiil