islam 0.1.1

Islamic library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

<div align="center">
<h1>islam</h1>

<a href="https://builds.sr.ht/~azzamsa/islam?">
<img src="https://builds.sr.ht/~azzamsa/islam.svg">
</a>
<a href="https://crates.io/crates/islam">
<img src="https://img.shields.io/crates/v/islam.svg">
</a>
<a href=" https://docs.rs/islam/">
<img src="https://docs.rs/islam/badge.svg">
</a>

<p></p>

</div>

---

*islam* is an Islamic library for Rust.
It is a direct port of [PyIslam](https://github.com/abougouffa/pyIslam) with a slight change in the API part.

## Why?

I have always got `panic!` working with [salah](https://github.com/insha/salah).
Previously, I have good experience with [PyIslam](https://github.com/abougouffa/pyIslam).
In my case, it is very precise and has a simple algorithm. Nowadays, I work a lot with Rust.
So here it is, `islam` is born!

## Features

- Hijri date
- Prayer times

## Usage

### Getting Prayer Times

``` rust
// GMT+7
let timezone = 7;
// https://www.mapcoordinates.net/en
let jakarta_city = Location::new(-6.18233995_f32, 106.84287154_f32, timezone);
let date = Local.ymd(2021, 4, 9);
let config = Config::new().with(Method::Singapore, Madhab::Shafi);
let prayer_times = Prayer::new(jakarta_city)
    .on(date)
    .with_config(config)
    .calculate();
```

First, you need to specify `Location` with `latitude, longitude, timezone` as
parameters.
Then choose a calculation method such `Singapore`. Other methods available [in the
docs](https://docs.rs/islam/0.1.1/islam/pray/method/enum.Method.html#variants).
There are also `madhab` configurations that you [can choose from](https://docs.rs/islam/0.1.1/islam/pray/madhab/enum.Madhab.html#variants).

### Getting Hijri Date

``` rust
let from_gregorian = HijriDate::from_gregorian(Local.ymd(2021, 4, 9), 0);
println!(
        "From gregorian: {}-{}-{}",
        from_gregorian.year, from_gregorian.month, from_gregorian.day,
    );
```

`from_gregorian` accepts `Date` and `correction value` as parameters.

## More Examples

To learn more, see other [examples](examples/).

## Contributing

For reporting issues, visit the tracker here: https://todo.sr.ht/~azzamsa/islam

Please send patches to `~azzamsa/public-inbox@lists.sr.ht`

## Acknowledgement

The calculation part of this library is a direct port of
[PyIslam](https://github.com/abougouffa/pyIslam) with a slight change in the API
part. The API took inspiration from [salah](https://github.com/insha/salah)