Skip to content

Commit 451a1e8

Browse files
authored
Merge pull request #25 from kafiln/master
updated the documentation
2 parents 4bcb6fc + 669d854 commit 451a1e8

File tree

1 file changed

+207
-19
lines changed

1 file changed

+207
-19
lines changed

README.md

Lines changed: 207 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,25 @@
44

55
> Daily prayer time in all the cities in [Morocco](https://www.google.com/search?q=morocco) :morocco:, directly in your terminal, at the tip of your fingers
66
7-
87
**A stupid simple Command line utility to get the daily prayers time for all the citiy in Morocco**
98

109
The source of the data is [the Moroccan Ministery Website](http://www.habous.gov.ma)
1110

1211
## Getting started
1312

13+
```bash
14+
npx salat [cityName]
15+
```
16+
17+
Please note that if the cityName contains space of `'` you need to use quotes, example
18+
19+
```bash
20+
npx salat "el jadida"
21+
npx salat "L'msid"
22+
```
23+
24+
You can also install it globally
25+
1426
```bash
1527
# Install
1628

@@ -25,33 +37,210 @@ $ salat
2537
$ salat [cityName]
2638
```
2739

28-
Alternatively, if you don't want to install it globally, you can just use:
29-
30-
```bash
31-
npx salat
32-
```
33-
34-
`City name should be provided the same way it's written in the cities.json`
40+
This is an exhaustive list of the supported cities :
41+
42+
- Agadir
43+
- Ahfir
44+
- Ain Aouda
45+
- Aïn Chaïr
46+
- Ait El Kak
47+
- Ait Ourir
48+
- Akayouar
49+
- Akdal Amelchil
50+
- Akdez
51+
- Akhefnir
52+
- Akka
53+
- Aknoul
54+
- Akoudal Amelchil Midelt
55+
- Amkala
56+
- Amsmrir
57+
- Araich
58+
- Arbaoua
59+
- Arfoud
60+
- Asa
61+
- Askin
62+
- Asoul
63+
- Assila
64+
- Azemmour
65+
- Azilal
66+
- Azrou
67+
- Bab Bared
68+
- Ben Ahmed
69+
- Ben Slimane
70+
- Bengrir
71+
- Beni Adrar
72+
- Beni Ansar
73+
- Beni Mellal
74+
- Beni Tejit
75+
- Berkane
76+
- Berrchid
77+
- Bir Anzaran
78+
- Bir Kandour
79+
- Bouanan
80+
- Bouarfa
81+
- Bouikra
82+
- Bouizkaren
83+
- Boujdour
84+
- Boukrae
85+
- Boulmane
86+
- Boumalen Dadas
87+
- Bourd
88+
- Bouskoura
89+
- Bouznika
90+
- Casablanca
91+
- Chefchaouan
92+
- Chichaoua
93+
- Dakhla
94+
- Debdou
95+
- Demnat
96+
- Deryouche
97+
- El Brouj
98+
- El Gara
99+
- El Hajeb
100+
- El Jabha
101+
- El Jadida
102+
- El Kasba
103+
- El Mahbes
104+
- El Menzel
105+
- Enif
106+
- Erich
107+
- Errachidia
108+
- Essaouira
109+
- Ezak
110+
- Fem Lehsan
111+
- Fem Zkid
112+
- Ferkhana
113+
- Fes
114+
- Fezouane
115+
- Figuig
116+
- Fnideq
117+
- Fquih Ben Salah
118+
- Geltat Zamour
119+
- Guelmim
120+
- Guercif
121+
- Hoceima
122+
- Igherem
123+
- Ikes
124+
- Imelchil
125+
- Imin Telat
126+
- Imntanout
127+
- Imouzzer Kandar
128+
- Jerada
129+
- Kalaat Megouna
130+
- Kalaat Sraghna
131+
- Kares
132+
- Kariat Ba Mohammed
133+
- Kasbah Tadla
134+
- Katara
135+
- Kelmima
136+
- Kénitra
137+
- Ketama
138+
- Khemis Sidi Abd Jelil
139+
- Khemis Zemamra
140+
- Khémissat
141+
- Khenifra
142+
- Khouribga
143+
- Ksar El Kebir
144+
- Ksar El Sghir
145+
- Ksar Ich
146+
- L'msid
147+
- Laayoune
148+
- Laayoune Sidi Mellouk
149+
- Lagouira
150+
- Marrakech
151+
- Martil
152+
- Mediek
153+
- Meknes
154+
- Melilla
155+
- Meskoura
156+
- Metmata
157+
- Midelt
158+
- Misour
159+
- Mohammedia
160+
- Moulay Bouaza
161+
- Moulay Bousselham
162+
- Moulay Yacoub
163+
- Nador
164+
- Oualidia
165+
- Ouazane
166+
- Oued Amlil
167+
- Oued Law
168+
- Oued Zam
169+
- Oujda
170+
- Oulad Ayad
171+
- Oulad Tayma
172+
- Oulmes
173+
- Ourzazate
174+
- Ousered
175+
- Rabat
176+
- Ras Alma
177+
- Remani
178+
- Rhamna
179+
- Ribate El Kheir
180+
- Risani
181+
- Safi
182+
- Saïdia
183+
- Sebta
184+
- Sefrou
185+
- Selouane
186+
- Settat
187+
- Sidi Benour
188+
- Sidi Ghanem
189+
- Sidi Ifni
190+
- Sidi Kacém
191+
- Sidi Slimane
192+
- Sidi Yahya Gharb
193+
- Smara
194+
- Souq Arbiâ Gharb
195+
- Tafntan
196+
- Tafougalt
197+
- Tafraouet
198+
- Tahla
199+
- Tahla
200+
- Talouine
201+
- Talsint
202+
- Tamslouhet
203+
- Tanger
204+
- Tantan
205+
- Taounat
206+
- Taourirt
207+
- Tarfaya
208+
- Taroudant
209+
- Tasltanet
210+
- Tata
211+
- Taza
212+
- Tazarin
213+
- Tefariti
214+
- Temnar
215+
- Tendrara
216+
- Tenghir
217+
- Tenjedad
218+
- Tetouan
219+
- Tiflet
220+
- Tindit
221+
- Tisa
222+
- Tisenet
223+
- Tizi Ousli
224+
- Tiznit
225+
- Toulkoult
226+
- Yefrin
227+
- Yousofia
228+
- Zagoura
229+
- Zaouiat Ahansal
230+
- Zaouiat Moulay Ibrahim
231+
- Zayou
232+
- Zerhoune
35233

36234
## Output
37235

38236
```bash
39237
# The programs prints to the console the prayers' time for the current day in the default city as shown bellow:
40238
```
239+
41240
![screen 1](images/screenShot1.png)
42241
![screen 2](images/screenShot2.png)
43242
![screen 3](images/screenShot3.png)
44243

45-
46-
## Dependecies
47-
48-
The code behind depends on :
49-
50-
- [axios](https://github.com/axios/axios) to make an http request ( fetch the data).
51-
- [jsdom](https://github.com/jsdom/jsdom) to parse the html result.
52-
- [chalk](https://github.com/chalk/chalk) to avoid boring styles and colors.
53-
- [node-localstorage](https://github.com/lmaccherone/node-localstorage) to read and write from localstorage.
54-
55244
## Change the default city
56245

57246
- The default city is :heart: [Marrakech](https://www.google.com/search?q=marrakech) :heart:, set as a value for the `DEFAULT_CITY` variable in `./constants.js`
@@ -68,7 +257,6 @@ The code behind depends on :
68257

69258
- [x] Use a default city
70259
- [x] Use localstorage-like api for caching purposes
71-
- [x] Display execution time
72260
- [ ] Improve performance
73261
- [ ] Add unit tests
74262
- [ ] Add a documentation site

0 commit comments

Comments
 (0)