hijri-cli 0.1.0__py3-none-any.whl

cli.py

@@ -0,0 +1,91 @@
+"""
+hijri - print and convert dates in the Umm al-Qura Hijri calendar
+from the command line.
+
+Copyright (c) 2026 Muhammad Bakhit <muhammadbakhit@outlook.com>
+
+This tool is inspired by, and built on, the "hijra" project by Ojuba Linux
+(https://github.com/ojuba-org/hijra), written by Muayyad Saleh Alsadi.
+Sadly, that project is no longer being developed. This tool is my attempt
+to keep its work useful: it reuses its conversion engine (hijra.py), adds
+official Umm al-Qura calendar support, and offers it as a simple command
+that works like the "date" command.
+
+    Released under the terms of the Waqf Public License.
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the latest version of the Waqf Public License
+    as published by Ojuba.org.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+    A copy of the license is included in this repository (LICENSE.txt).
+
+Umm al-Qura table data (hijra_uq.py) is taken from the "hijridate" project
+by Mohammed Alshehri, under the MIT License (see hijridate-LICENSE.txt).
+"""
+
+import datetime
+import hijra
+import argparse
+
+HIJRI_MONTHS = ["Muharram", "Safar", "Rabi' I", "Rabi' II", "Jumada I", "Jumada II", "Rajab", "Sha'ban", "Ramadan", "Shawwal", "Dhul Qadah", "Dhul Hijjah"]
+
+def format_hijri (year,month,day,weekday):
+    """This function formats the Hijri date into a string representation, including the weekday, day, month name, and year."""
+    hijri_month = HIJRI_MONTHS[month - 1]
+    return f"{weekday} {day} {hijri_month} {year}"
+
+
+def parse_hijri (parts):
+    parts = [int(num) for num in parts.split("-")]
+    h_year, h_month, h_day = parts
+    if not (1 <= h_month <= 12 and 1 <= h_day <= 30):
+            raise ValueError("month or day out of range")
+    if h_year < 1343 or h_year > 1500:
+            print("Warning: The date is less than 1343 or greater than 1500, which is outside the range of the Umm al-Qura calendar. This date may not be accurate!.")
+    return h_year, h_month, h_day
+
+def main():
+    parser = argparse.ArgumentParser(prog="hijri",description="Print or convert dates in the Umm al-Qura Hijri calendar.")
+    parser.add_argument("-d", "--date", help="Gregorian date to convert to Hijri, as YYYY-MM-DD")
+    parser.add_argument("-g", "--to-gregorian", help="Hijri date to convert to gregorian, as YYYY-MM-DD")
+    args = parser.parse_args()
+
+    """From Hijri to Gregorian, and Exit"""
+    if args.to_gregorian != None:
+        try:
+            h_year,h_month,h_day = parse_hijri(args.to_gregorian)
+            g_year,g_month,g_day = hijra.hijri_to_gregorian(h_year,h_month,h_day)
+            g_date = datetime.date(g_year,g_month,g_day)
+        except ValueError:
+            parser.error("Invalid Hijri date. Use YYYY-MM-DD.")
+        print(g_date.strftime("%A %d %B %Y")) # Example: Monday 05 August 2024
+        return
+
+    """From Gregorian to Hijri"""
+    if args.date == None:
+        target = datetime.datetime.now() # Example: 2026-11-13 01:49:45
+        time_text = target.strftime("%X") # Time Now in HH:mm:ss
+    else:
+        try:
+            target = datetime.date.fromisoformat(args.date)
+            time_text = ""
+        except ValueError:
+            parser.error("Invalid date format. Please use YYYY-MM-DD.")
+
+    weekday = target.strftime("%A") # Example Friday
+    h_year,h_month,h_day = hijra.gregorian_to_hijri(target.year,target.month,target.day)
+    text = format_hijri(h_year,h_month,h_day,weekday)
+
+    if time_text:
+        print(text, time_text)
+    else:
+        print(text)
+
+
+if __name__ == "__main__":
+    main()
+
+

hijra.py

@@ -0,0 +1,343 @@
+#!/usr/bin/python3
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2006-2008 Muayyad Saleh Alsadi<alsadi@gmail.com>
+Copyright (c) 2026 Muhammad Bakhit https://github.com/mubakhit
+  Umm al-Qura table support, Python 3 integer-division fixes, date validation
+
+Hijri Islamic Calendar converting functions,
+Copyright (c) 2006-2008 Muayyad Saleh Alsadi<alsadi@gmail.com>
+Based on an enhanced algorithm designed by me
+the algorithm is discussed in a book titled "حتى لا ندخل جحور الضباب"
+(not yet published)
+
+This file can be used to implement apps, gdesklets or karamba ..etc
+
+This algorithm is based on integer operations
+which that there is no round errors (given accurate coefficients)
+the accuracy of this algorithm is based on 3 constants (p,q and a)
+where p/q is the full months percentage [ gcd(p,q) must be 1 ]
+currently it's set to 191/360 which mean that there is 191 months
+having 30 days in a span of 360 years, other months are 29 days.
+and a is just a shift.
+
+
+    Released under terms on Waqf Public License.
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the latest version Waqf Public License as
+    published by Ojuba.org.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+    The Latest version of the license can be found on
+    "http://www.ojuba.org/wiki/doku.php/waqf/license"
+
+
+Portions of this algorithm is based on that found on GNU EMACS
+the difference is that this algorithm does not set
+all months to a fixed number of days (in the original algorithm
+first month always have 30 days)
+
+
+The original GNU Emacs LISP algorithm
+Copyright (C) 1995, 1997, 2001 Free Software Foundation, Inc.
+  	Edward M. Reingold <reingold@cs.uiuc.edu>
+  Technical details of all the calendrical calculations can be found in
+  ``Calendrical Calculations'' by Nachum Dershowitz and Edward M. Reingold,
+  Cambridge University Press (1997).
+  Comments, corrections, and improvements should be sent to
+   Edward M. Reingold               Department of Computer Science
+   (217) 333-6733                   University of Illinois at Urbana-Champaign
+   reingold@cs.uiuc.edu             1304 West Springfield Avenue
+"""
+__p_const=191
+__q_const=360
+__a_const=48
+__hijri_epoch=227015; # = Julian 0622-7-16 = gregorian 0759-6-11 (I think it should be 622, 7, 19)
+# TODO: Why does the the hijri_epoch 227015 does not give the expected value when converted to gregorian
+
+# Umm al-Qura table support: inside the table range (1343-1500 AH) dates
+# follow the official Umm al-Qura calendar, outside it the arithmetic
+# algorithm below is used. Call set_method("arithmetic") to disable the table.
+from bisect import bisect_right
+try: from hijra_uq import UQ_FIRST_YEAR, UQ_MONTH_STARTS
+except ImportError: UQ_FIRST_YEAR=0; UQ_MONTH_STARTS=()
+__use_uq=len(UQ_MONTH_STARTS)>1
+
+def set_method(method):
+   """Choose the calendar method: "ummalqura" (default, when table exists) or "arithmetic" """
+   global __use_uq
+   if method not in ("ummalqura", "arithmetic"): raise ValueError("unknown method %r" % (method,))
+   __use_uq=(method=="ummalqura" and len(UQ_MONTH_STARTS)>1)
+def get_method():
+   """Return the calendar method currently in use"""
+   if __use_uq: return "ummalqura"
+   return "arithmetic"
+def __uq_index(Y,M):
+   """Return index of month (Y,M) in Umm al-Qura table, or -1 if not covered"""
+   if not __use_uq: return -1
+   i=(Y-UQ_FIRST_YEAR)*12+M-1
+   if 0 <= i < len(UQ_MONTH_STARTS)-1 and 1 <= M <= 12: return i
+   return -1
+
+def get_consts():
+   """Return a tuple of the 3 constants (p,q,a) used by this algothim, for debuging"""
+   return (__p_const, __q_const, __a_const)
+def get_epoch():
+   """Return Hijri epoch, number of days since gregorian epoch, (should be Julian 0622-7-16 (ie. 227015 days)"""
+   return __hijri_epoch
+
+def hijri_month_days(Y,M):
+   """Return the number of days in a given hijri month M in a given Y"""
+   i=__uq_index(Y,M)
+   if i>=0: return UQ_MONTH_STARTS[i+1]-UQ_MONTH_STARTS[i]
+   Mc = ( Y -1) *12 + M
+   if (((Mc+ __a_const) * __p_const) % __q_const)  < __p_const : return 30
+   else: return 29
+
+# NOTE: trivial implementation
+#def hijri_days_before_month_(Y,M): # simple mothod, optimization is possible by reusing Mc ..etc.
+#   """Return the number of days before a given moth M in a given year Y"""
+#   sum=0
+#   for i in xrange(1,M): sum+=hijri_month_days(Y,i);
+#   return sum
+
+def hijri_days_before_month(Y,M):
+   """Return the number of days before a given moth M in a given year Y (0 for M=1)"""
+   i=__uq_index(Y,1)
+   if i>=0 and 1 <= M <= 13: return UQ_MONTH_STARTS[i+M-1]-UQ_MONTH_STARTS[i]
+   Mc = ( Y -1) *12 + 1 + __a_const
+   McM=Mc * __p_const
+   sum=0
+   for i in range(1,M):
+      if (McM % __q_const)  < __p_const : sum+=30
+      else: sum+=29
+      McM+=__p_const
+   return sum
+
+def hijri_year_days(Y):
+   """Return the number of days in a given year Y"""
+   return hijri_days_before_month(Y,13)
+
+def hijri_day_number (Y, M, D):
+   """Return the day number within the year of the Islamic date (Y, M, D), 1 for 1/1 in any year"""
+   return hijri_days_before_month(Y,M)+D
+
+# correct implementation # TODO: optimize it more and test that after optimization
+def hijri_to_absolute (Y, M, D):
+   """Return absolute date of Hijri (Y,M,D), eg. ramadan (9),1,1427 -> 732578 """   
+   i=__uq_index(Y,M)
+   if i>=0: return UQ_MONTH_STARTS[i]+D-1
+   Mc=(Y-1)*12
+   # day count=days before Hijra plus (...)
+   dc=__hijri_epoch
+   # plus days in the years before till first multiples of q plus (...)
+   Mc-=Mc % __q_const
+   y=Y-Mc//12
+   dc+=Mc*29 + Mc*__p_const//__q_const
+   # plus those after the multiples plus (...)
+   for i in range(1,y): dc+=hijri_year_days(i)
+   # plus days from the begining of that year
+   dc+=hijri_day_number (Y, M, D) - 1
+   return dc
+
+def hijri_month_days_(y,m):
+   """Return the number of days in a given hijri month M in a given Y"""
+   return hijri_to_absolute(y+m//12,m%12+1,1)-hijri_to_absolute(y,m,1)
+
+# TEST: PASSED
+#def test_hijri_to_absolute_v_month_days():
+#  #l=[(y,m) for y in xrange(1,31) for m in xrange(1,13)]
+#  l=[(y,m) for y in xrange(1400,1499) for m in xrange(1,13)]
+#  for y,m in l:
+#    d1=hijri_month_days(y,m)
+#    d2=hijri_to_absolute(y+m/12,m%12+1,1)-hijri_to_absolute(y,m,1)
+#    if d1!=d2: print y,m,y+m/12,m%12+1,'d1=',d1,", d2=",d2
+
+# round then move to exact, very slow perfect implementation
+#def absolute_to_hijri_ (date): # TODO: check if it's always compatible with absolute_from_hijri
+#   """Return Hijri date (Y,M,D) corresponding to the given absolute number of days."""
+#   if date < __hijri_epoch: return None; # pre-Islamic date
+#   dd=date-__hijri_epoch
+#   Mc=dd/(29*(__q_const-__p_const)+ 30*__p_const)*__q_const # mounth count till multibles of q
+#   Y=y=Mc/12+1; M=m=(Mc%12)+1
+#   while(date > hijri_to_absolute(Y,M,1)):
+#     y,m=Y,M
+#     M+=1
+#     if M>12: M=1; Y+=1
+#   Y=y; M=m
+#   D=1 + date - hijri_to_absolute(Y,M,1)
+#   if D>hijri_month_days(Y,M): 
+#     M+=1
+#     if M>12: M=1; Y+=1
+#   D=1 + date - hijri_to_absolute(Y,M,1)
+#   return (Y,M,D)
+
+
+# direct way, test PASSED
+def absolute_to_hijri (date):
+   """Return Hijri date (Y,M,D) corresponding to the given absolute number of days."""
+   if date < __hijri_epoch: return None; # pre-Islamic date
+   if __use_uq and UQ_MONTH_STARTS[0] <= date < UQ_MONTH_STARTS[-1]:
+     i=bisect_right(UQ_MONTH_STARTS, date)-1
+     return (UQ_FIRST_YEAR+i//12, i%12+1, date-UQ_MONTH_STARTS[i]+1)
+   Mc=(date-__hijri_epoch+1)*__q_const//(29*__q_const+__p_const)
+   Y=Mc//12+1; M=(Mc%12)+1
+   # consistency check
+   d=hijri_to_absolute(Y,M,1) # TODO: this is an expensive call
+   if (date < d): # go one month back if needed
+     M-=1
+     if M==0: Y-=1; M=12
+     d-=hijri_month_days(Y,M) # this call is fast
+   #
+   D=1 + date - d
+   return (Y,M,D)
+
+# TEST: PASSED
+#def test_c():
+#  l=[(y,m) for y in xrange(1400,1499) for m in xrange(1,13)]
+#  for y,m in l:
+#    d=hijri_month_days(y,m)
+#    if absolute_to_hijri(hijri_to_absolute(y,m,1))!=(y,m,1): print y,m,1, absolute_to_hijri(hijri_to_absolute(y,m,1))
+#    if absolute_to_hijri(hijri_to_absolute(y,m,d))!=(y,m,d): print y,m,d, absolute_to_hijri(hijri_to_absolute(y,m,d))
+
+def hijri_day_of_week (Y, M, D):
+   """Return the day-of-the-week index of hijri (Y,M,D) Date, 0 for Sunday, 1 for Monday, etc."""
+   return hijri_to_absolute (Y,M, D) % 7;
+# ///////////////////////////////
+# high level converting functions
+
+def hijri_to_gregorian (year, month, day):
+   """Return gregorian (year, month, day) converted from Islamic Hijri calender"""
+   if not (1 <= month <= 12 and 1 <= day <= hijri_month_days(year, month)):
+      raise ValueError("invalid hijri date: %d-%d-%d" % (year, month, day))
+   return absolute_to_gregorian( hijri_to_absolute (year, month, day));
+
+def gregorian_to_hijri (year, month, day):
+   """Return Hijri  (year, month, day) converted from gregorian calender"""
+   if not (1 <= month <= 12 and 1 <= day <= gregorian_month_days(year, month)):
+      raise ValueError("invalid gregorian date: %d-%d-%d" % (year, month, day))
+   return absolute_to_hijri( gregorian_to_absolute (year, month, day));
+
+#///////////////////////////////////
+# Gregorian functions
+#///////////////////////////////////
+# This Portions of is based on that found on GNU EMACS
+
+#The original GNU Emacs LISP algorithm
+#Copyright (C) 1995, 1997, 2001 Free Software Foundation, Inc.
+#	Edward M. Reingold <reingold@cs.uiuc.edu>
+#  Technical details of all the calendrical calculations can be found in
+#  ``Calendrical Calculations'' by Nachum Dershowitz and Edward M. Reingold,
+#  Cambridge University Press (1997).
+#  Comments, corrections, and improvements should be sent to
+#  Edward M. Reingold               Department of Computer Science
+#  (217) 333-6733                   University of Illinois at Urbana-Champaign
+#  reingold@cs.uiuc.edu             1304 West Springfield Avenue
+
+days_in_month=( 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31);
+def gregorian_leap_year_p (year):
+   """Return 1 (True) if YEAR is a Gregorian leap year."""
+   if ((year % 4) == 0 and ((year % 100) or (year % 400) == 0)): return 1;
+   return 0;
+
+def gregorian_month_days (year, month):
+   """The last day in MONTH during YEAR."""
+   if (month == 2 and gregorian_leap_year_p (year)): return 29;
+   return days_in_month[month-1];
+
+def gregorian_day_number (year, month, day):
+   """Return the day number within the year of the date (year,month, day)"""
+   if month<3: return day + (31 * (month - 1));
+   return day + (31 * (month - 1)) - \
+   ((month << 2) + 23) // 10 + (gregorian_leap_year_p (year) & 1);
+
+def gregorian_to_absolute (year, month, day):
+   prior_years = year - 1;
+   return gregorian_day_number (year, month, day) + \
+   365 * prior_years + (prior_years >> 2) - \
+   (prior_years // 100) + (prior_years // 400);
+
+def absolute_to_gregorian(date):
+   """return (year month day) corresponding to the absolute DATE.
+The absolute date is the number of days elapsed since the (imaginary)
+Gregorian date Sunday, December 31, 1 BC."""
+
+# See the footnote on page 384 of ``Calendrical Calculations, Part II:
+# Three Historical Calendars'' by E. M. Reingold,  N. Dershowitz, and S. M.
+# Clamen, Software--Practice and Experience, Volume 23, Number 4
+# (April, 1993), pages 383-404 for an explanation.
+   d0 = date - 1;
+   n400 = d0 // 146097;
+   d1 = d0 % 146097;
+   n100 = d1 // 36524;
+   d2 = d1 % 36524;
+   n4 = d2 // 1461;
+   d3 = d2 % 1461;
+   n1 = d3 // 365;
+   dd = (d3 % 365) + 1;
+   yy = ((400 * n400) + (100 * n100) + (n4 * 4) + n1);
+   if (n100 == 4) or (n1 == 4): return (yy, 12, 31);
+   yy=yy+1;
+   mm = 1;
+   while(date >= gregorian_to_absolute (yy,mm, 1)): mm+=1;
+   d=gregorian_to_absolute (yy, mm-1, 1);
+   return (yy, mm-1,date-d+1);	
+# 	d = calendar_absolute_from_gregorian (1, 1, yy);
+# 	mm=1;
+# 	while(mm <= 12):
+# 		dd = date - d + 1;
+# 		dm = calendar_last_day_of_month (mm, yy);
+# 		if dd <= dm: return (mm,dd+1,yy);
+# 		d += dm;
+# 		mm=mm+1;
+#	return 0; # should not happened
+def gregorian_day_of_week (yy, mm, dd):
+   """Return the day-of-the-week index of gregorian (yy, mm, dd) DATE, 0 for Sunday, 1 for Monday, etc."""
+   return gregorian_to_absolute (yy,mm, dd) % 7;
+
+if __name__ == "__main__":
+   # conclusion
+   # 0% for a=16 48 65
+   # 7% for a=1 31 33 50 80 82 97 99
+   # 13% for a=14 18 46 63 67 95
+   # 20% for a=12 29 3 35 52 78 84
+   # ...
+   # 73% for a=45 47 49 ..etc.
+   ##########################
+   __a_const=16
+   print("for a=%d" % __a_const)
+   sum=0.0
+   for y in range(1,4001): sum+= float(hijri_month_days(y,12)==30)
+   print("perfect thu-hijja months is %f %% " % float(float(sum)/4000.0*100.0))
+   sum=0.0
+   for y in range(1,4001): sum+= float(hijri_month_days(y,9)==30)
+   print("perfect Ramadan months is %f %% " % float(float(sum)/4000.0*100.0))
+   
+   __a_const=48
+   print("for a=%d" % __a_const)
+   sum=0.0
+   for y in range(1,4001): sum+= float(hijri_month_days(y,12)==30)
+   print("perfect thu-hijja months is %f %% " % float(float(sum)/4000.0*100.0))
+   sum=0.0
+   for y in range(1,4001): sum+= float(hijri_month_days(y,9)==30)
+   print("perfect Ramadan months is %f %% " % float(float(sum)/4000.0*100.0))
+   
+   __a_const=65
+   print("for a=%d" % __a_const)
+   sum=0.0
+   for y in range(1,4001): sum+= float(hijri_month_days(y,12)==30)
+   print("perfect thu-hijja months is %f %% " % float(float(sum)/4000.0*100.0))
+   sum=0.0
+   for y in range(1,4001): sum+= float(hijri_month_days(y,9)==30)
+   print("perfect Ramadan months is %f %% " % float(float(sum)/4000.0*100.0))
+   
+   __a_const=48
+   print("for a=%d" % __a_const)
+   for m in range(1,13):
+      sum=0.0
+      for y in range(1,4001): sum+= float(hijri_month_days(y,m)==30)
+      print("perfect %d months is %f %% " % (m,float(float(sum)/4000.0*100.0)))
+

hijra_uq.py

@@ -0,0 +1,175 @@
+# -*- coding: utf-8 -*-
+"""
+Umm al-Qura calendar table (1343 AH - 1500 AH).
+
+UQ_MONTH_STARTS[i] is the absolute day number (same scale used in hijra.py,
+1 = Gregorian 0001-01-01) of the first day of Hijri month number i,
+counted from Muharram of UQ_FIRST_YEAR. The last entry is 1 Muharram 1501,
+kept only to know the length of the last month.
+
+Table data taken from the "hijridate" project (MIT License),
+Copyright (c) Mohammed Alshehri, https://github.com/dralshehri/hijridate
+which is based on the official Umm al-Qura calendar of Saudi Arabia.
+"""
+UQ_FIRST_YEAR = 1343
+UQ_MONTH_STARTS = (
+   702574, 702604, 702633, 702663, 702693, 702722, 702752, 702782, 702812, 702840, 702870, 702900,
+   702930, 702959, 702988, 703018, 703047, 703077, 703106, 703136, 703165, 703195, 703224, 703254,
+   703283, 703313, 703342, 703372, 703401, 703432, 703461, 703491, 703519, 703549, 703579, 703608,
+   703638, 703667, 703696, 703726, 703756, 703785, 703815, 703845, 703874, 703903, 703933, 703963,
+   703992, 704021, 704050, 704080, 704110, 704139, 704169, 704199, 704228, 704258, 704288, 704317,
+   704346, 704376, 704405, 704435, 704464, 704494, 704523, 704553, 704583, 704612, 704641, 704672,
+   704700, 704730, 704759, 704789, 704818, 704848, 704877, 704907, 704937, 704967, 704995, 705026,
+   705056, 705085, 705115, 705144, 705174, 705203, 705232, 705262, 705291, 705321, 705351, 705380,
+   705410, 705440, 705469, 705499, 705528, 705558, 705587, 705616, 705645, 705675, 705705, 705734,
+   705764, 705794, 705823, 705853, 705882, 705912, 705941, 705971, 706000, 706030, 706059, 706089,
+   706118, 706148, 706177, 706207, 706237, 706266, 706296, 706325, 706355, 706385, 706414, 706443,
+   706473, 706502, 706532, 706561, 706591, 706620, 706650, 706680, 706709, 706739, 706768, 706798,
+   706827, 706857, 706886, 706916, 706945, 706975, 707004, 707034, 707063, 707093, 707123, 707152,
+   707182, 707211, 707240, 707270, 707299, 707329, 707358, 707388, 707418, 707447, 707476, 707506,
+   707535, 707565, 707594, 707624, 707653, 707683, 707712, 707742, 707771, 707801, 707830, 707860,
+   707890, 707920, 707950, 707979, 708009, 708038, 708067, 708097, 708126, 708155, 708185, 708215,
+   708244, 708274, 708304, 708334, 708363, 708393, 708422, 708451, 708481, 708510, 708539, 708569,
+   708598, 708628, 708657, 708687, 708716, 708746, 708775, 708805, 708834, 708864, 708893, 708923,
+   708953, 708983, 709012, 709042, 709071, 709101, 709130, 709160, 709189, 709219, 709248, 709278,
+   709307, 709337, 709366, 709396, 709425, 709455, 709484, 709514, 709543, 709573, 709602, 709632,
+   709661, 709691, 709720, 709750, 709779, 709809, 709838, 709868, 709897, 709927, 709956, 709986,
+   710016, 710046, 710075, 710105, 710134, 710164, 710193, 710223, 710251, 710281, 710311, 710341,
+   710370, 710400, 710429, 710459, 710488, 710518, 710547, 710577, 710606, 710636, 710665, 710695,
+   710725, 710755, 710784, 710814, 710843, 710873, 710902, 710932, 710961, 710991, 711020, 711050,
+   711079, 711109, 711138, 711168, 711197, 711227, 711256, 711286, 711315, 711345, 711374, 711404,
+   711433, 711463, 711492, 711522, 711551, 711581, 711610, 711640, 711669, 711699, 711728, 711758,
+   711788, 711818, 711847, 711877, 711906, 711936, 711965, 711995, 712025, 712054, 712084, 712114,
+   712143, 712173, 712202, 712232, 712261, 712291, 712320, 712350, 712379, 712409, 712438, 712468,
+   712497, 712527, 712556, 712586, 712615, 712644, 712674, 712703, 712733, 712762, 712792, 712822,
+   712852, 712881, 712911, 712940, 712970, 712999, 713029, 713058, 713087, 713117, 713146, 713176,
+   713206, 713235, 713265, 713294, 713324, 713353, 713383, 713412, 713442, 713471, 713501, 713530,
+   713560, 713590, 713619, 713649, 713678, 713708, 713737, 713767, 713797, 713826, 713855, 713885,
+   713915, 713945, 713974, 714004, 714033, 714063, 714092, 714122, 714151, 714180, 714210, 714240,
+   714269, 714298, 714328, 714357, 714386, 714416, 714446, 714476, 714505, 714535, 714564, 714594,
+   714623, 714653, 714682, 714711, 714741, 714770, 714800, 714829, 714859, 714889, 714918, 714948,
+   714978, 715008, 715037, 715067, 715096, 715126, 715155, 715185, 715214, 715244, 715273, 715303,
+   715332, 715361, 715391, 715420, 715450, 715479, 715509, 715538, 715568, 715597, 715627, 715656,
+   715686, 715716, 715745, 715775, 715804, 715834, 715863, 715893, 715922, 715952, 715981, 716011,
+   716040, 716070, 716099, 716129, 716159, 716188, 716218, 716247, 716276, 716306, 716335, 716365,
+   716394, 716424, 716453, 716483, 716513, 716542, 716572, 716602, 716631, 716660, 716690, 716719,
+   716749, 716778, 716808, 716837, 716867, 716897, 716926, 716956, 716985, 717015, 717044, 717074,
+   717103, 717133, 717162, 717192, 717221, 717251, 717280, 717310, 717339, 717369, 717398, 717428,
+   717457, 717487, 717516, 717546, 717576, 717605, 717634, 717664, 717693, 717723, 717753, 717783,
+   717812, 717842, 717872, 717901, 717930, 717960, 717989, 718019, 718048, 718078, 718107, 718137,
+   718167, 718196, 718225, 718255, 718284, 718314, 718343, 718373, 718402, 718432, 718461, 718491,
+   718521, 718550, 718580, 718610, 718639, 718669, 718698, 718728, 718757, 718787, 718816, 718846,
+   718875, 718905, 718934, 718964, 718993, 719023, 719052, 719082, 719111, 719141, 719170, 719200,
+   719230, 719260, 719289, 719319, 719348, 719378, 719407, 719437, 719467, 719496, 719526, 719555,
+   719584, 719614, 719643, 719673, 719702, 719732, 719761, 719791, 719820, 719850, 719879, 719909,
+   719939, 719968, 719997, 720027, 720056, 720086, 720115, 720145, 720174, 720204, 720233, 720263,
+   720293, 720323, 720352, 720382, 720411, 720440, 720469, 720499, 720528, 720558, 720587, 720617,
+   720647, 720677, 720706, 720736, 720765, 720795, 720824, 720854, 720883, 720912, 720942, 720972,
+   721001, 721031, 721060, 721090, 721120, 721149, 721179, 721208, 721237, 721267, 721296, 721326,
+   721355, 721385, 721414, 721444, 721474, 721504, 721533, 721563, 721592, 721621, 721651, 721680,
+   721710, 721739, 721769, 721798, 721828, 721858, 721887, 721917, 721946, 721976, 722005, 722035,
+   722064, 722094, 722123, 722153, 722182, 722212, 722241, 722271, 722301, 722330, 722360, 722389,
+   722419, 722448, 722478, 722507, 722537, 722566, 722596, 722625, 722655, 722684, 722714, 722744,
+   722773, 722803, 722833, 722862, 722892, 722921, 722950, 722980, 723009, 723039, 723068, 723098,
+   723128, 723157, 723187, 723216, 723246, 723275, 723305, 723334, 723363, 723393, 723422, 723452,
+   723481, 723511, 723541, 723571, 723600, 723630, 723659, 723689, 723718, 723747, 723777, 723806,
+   723836, 723865, 723895, 723925, 723955, 723984, 724014, 724043, 724073, 724102, 724131, 724161,
+   724190, 724219, 724249, 724279, 724308, 724338, 724368, 724398, 724427, 724457, 724486, 724515,
+   724545, 724574, 724603, 724633, 724663, 724692, 724722, 724752, 724781, 724811, 724840, 724870,
+   724899, 724929, 724958, 724988, 725017, 725047, 725076, 725106, 725135, 725165, 725195, 725224,
+   725254, 725283, 725313, 725342, 725372, 725401, 725431, 725460, 725490, 725519, 725549, 725578,
+   725608, 725638, 725667, 725697, 725726, 725756, 725785, 725815, 725844, 725873, 725903, 725932,
+   725962, 725992, 726021, 726051, 726081, 726110, 726140, 726169, 726199, 726228, 726257, 726287,
+   726316, 726346, 726375, 726405, 726435, 726465, 726494, 726524, 726553, 726583, 726612, 726641,
+   726671, 726700, 726730, 726759, 726789, 726819, 726848, 726878, 726908, 726937, 726967, 726996,
+   727025, 727055, 727084, 727113, 727143, 727173, 727202, 727232, 727262, 727292, 727321, 727351,
+   727380, 727409, 727439, 727468, 727497, 727527, 727557, 727586, 727616, 727646, 727675, 727705,
+   727735, 727764, 727793, 727823, 727852, 727881, 727911, 727940, 727970, 728000, 728030, 728059,
+   728089, 728118, 728148, 728177, 728207, 728236, 728265, 728295, 728324, 728354, 728384, 728413,
+   728443, 728473, 728502, 728532, 728561, 728591, 728620, 728650, 728679, 728708, 728738, 728767,
+   728797, 728827, 728856, 728886, 728915, 728945, 728975, 729004, 729034, 729063, 729093, 729122,
+   729151, 729181, 729210, 729240, 729269, 729299, 729329, 729359, 729388, 729418, 729447, 729477,
+   729506, 729535, 729565, 729594, 729624, 729653, 729683, 729713, 729742, 729772, 729802, 729831,
+   729861, 729890, 729920, 729949, 729978, 730008, 730037, 730067, 730097, 730127, 730157, 730186,
+   730216, 730245, 730274, 730304, 730333, 730362, 730391, 730421, 730451, 730481, 730511, 730540,
+   730570, 730600, 730629, 730658, 730688, 730717, 730746, 730775, 730805, 730835, 730865, 730894,
+   730924, 730954, 730983, 731013, 731042, 731072, 731101, 731130, 731160, 731189, 731219, 731248,
+   731278, 731308, 731337, 731367, 731397, 731426, 731456, 731485, 731514, 731544, 731573, 731603,
+   731632, 731662, 731691, 731721, 731751, 731780, 731810, 731839, 731869, 731899, 731928, 731958,
+   731987, 732016, 732046, 732075, 732105, 732134, 732164, 732194, 732223, 732253, 732283, 732312,
+   732342, 732371, 732400, 732430, 732459, 732489, 732518, 732548, 732578, 732607, 732637, 732667,
+   732696, 732726, 732755, 732784, 732814, 732843, 732872, 732902, 732932, 732962, 732991, 733021,
+   733051, 733080, 733110, 733139, 733168, 733198, 733227, 733256, 733286, 733316, 733345, 733375,
+   733405, 733434, 733464, 733494, 733523, 733552, 733582, 733611, 733641, 733670, 733700, 733729,
+   733759, 733788, 733818, 733848, 733877, 733907, 733936, 733966, 733995, 734025, 734054, 734083,
+   734113, 734142, 734172, 734202, 734232, 734261, 734291, 734320, 734350, 734379, 734409, 734438,
+   734467, 734497, 734526, 734556, 734586, 734615, 734645, 734675, 734704, 734734, 734763, 734793,
+   734822, 734851, 734881, 734910, 734940, 734969, 734999, 735029, 735058, 735088, 735118, 735147,
+   735176, 735206, 735235, 735265, 735294, 735324, 735353, 735383, 735412, 735442, 735472, 735501,
+   735531, 735560, 735590, 735619, 735649, 735678, 735708, 735737, 735767, 735796, 735826, 735855,
+   735885, 735915, 735944, 735974, 736004, 736033, 736062, 736092, 736121, 736151, 736180, 736209,
+   736239, 736269, 736298, 736328, 736358, 736388, 736417, 736446, 736476, 736505, 736534, 736564,
+   736593, 736623, 736652, 736682, 736712, 736742, 736771, 736801, 736830, 736860, 736889, 736918,
+   736948, 736977, 737007, 737036, 737066, 737096, 737126, 737155, 737185, 737214, 737244, 737273,
+   737302, 737332, 737361, 737391, 737420, 737450, 737480, 737509, 737539, 737569, 737598, 737628,
+   737657, 737686, 737716, 737745, 737775, 737804, 737834, 737863, 737893, 737923, 737952, 737982,
+   738011, 738041, 738070, 738100, 738129, 738159, 738188, 738218, 738247, 738277, 738306, 738336,
+   738366, 738395, 738425, 738454, 738484, 738514, 738543, 738572, 738602, 738631, 738661, 738690,
+   738720, 738749, 738779, 738809, 738839, 738868, 738898, 738927, 738956, 738986, 739015, 739044,
+   739074, 739103, 739133, 739163, 739193, 739222, 739252, 739282, 739311, 739340, 739370, 739399,
+   739428, 739458, 739487, 739517, 739547, 739577, 739606, 739636, 739665, 739695, 739724, 739754,
+   739783, 739812, 739842, 739871, 739901, 739931, 739960, 739990, 740020, 740049, 740079, 740108,
+   740138, 740167, 740196, 740226, 740255, 740285, 740314, 740344, 740374, 740403, 740433, 740463,
+   740492, 740522, 740551, 740581, 740610, 740639, 740669, 740698, 740728, 740757, 740787, 740817,
+   740846, 740876, 740906, 740935, 740965, 740994, 741023, 741053, 741082, 741112, 741141, 741171,
+   741200, 741230, 741260, 741290, 741319, 741349, 741378, 741407, 741437, 741466, 741496, 741525,
+   741555, 741584, 741614, 741644, 741674, 741703, 741732, 741762, 741791, 741821, 741850, 741880,
+   741909, 741938, 741968, 741998, 742028, 742057, 742087, 742116, 742146, 742175, 742205, 742234,
+   742264, 742293, 742322, 742352, 742382, 742411, 742441, 742470, 742500, 742530, 742559, 742589,
+   742618, 742648, 742677, 742706, 742736, 742765, 742795, 742824, 742854, 742884, 742914, 742943,
+   742973, 743002, 743032, 743061, 743090, 743120, 743149, 743178, 743208, 743238, 743267, 743297,
+   743327, 743357, 743386, 743416, 743445, 743474, 743504, 743533, 743562, 743592, 743622, 743651,
+   743681, 743711, 743741, 743770, 743800, 743829, 743858, 743888, 743917, 743946, 743976, 744006,
+   744035, 744065, 744095, 744124, 744154, 744183, 744213, 744242, 744272, 744301, 744330, 744360,
+   744390, 744419, 744449, 744478, 744508, 744538, 744567, 744597, 744626, 744656, 744685, 744715,
+   744744, 744774, 744803, 744833, 744862, 744892, 744921, 744951, 744980, 745010, 745040, 745069,
+   745099, 745128, 745158, 745187, 745216, 745246, 745275, 745305, 745335, 745364, 745394, 745424,
+   745453, 745483, 745512, 745542, 745571, 745600, 745630, 745659, 745689, 745718, 745748, 745778,
+   745808, 745837, 745867, 745896, 745926, 745955, 745984, 746014, 746043, 746072, 746102, 746132,
+   746162, 746192, 746221, 746251, 746280, 746310, 746339, 746368, 746398, 746427, 746457, 746486,
+   746516, 746546, 746575, 746605, 746635, 746664, 746694, 746723, 746752, 746782, 746811, 746841,
+   746870, 746900, 746929, 746959, 746989, 747018, 747048, 747077, 747107, 747136, 747166, 747195,
+   747225, 747254, 747283, 747313, 747343, 747372, 747402, 747432, 747461, 747491, 747521, 747550,
+   747579, 747609, 747638, 747667, 747697, 747727, 747756, 747786, 747815, 747845, 747875, 747905,
+   747934, 747963, 747993, 748022, 748051, 748081, 748110, 748140, 748170, 748199, 748229, 748259,
+   748288, 748318, 748347, 748377, 748406, 748436, 748465, 748494, 748524, 748553, 748583, 748613,
+   748642, 748672, 748701, 748731, 748761, 748790, 748820, 748849, 748878, 748908, 748937, 748967,
+   748996, 749026, 749056, 749085, 749115, 749145, 749174, 749204, 749233, 749262, 749292, 749321,
+   749351, 749380, 749410, 749439, 749469, 749499, 749529, 749558, 749588, 749617, 749646, 749676,
+   749705, 749734, 749764, 749793, 749823, 749853, 749883, 749912, 749942, 749972, 750001, 750030,
+   750060, 750089, 750118, 750148, 750177, 750207, 750237, 750266, 750296, 750326, 750356, 750385,
+   750414, 750444, 750473, 750502, 750532, 750561, 750591, 750621, 750650, 750680, 750710, 750739,
+   750769, 750798, 750828, 750857, 750886, 750916, 750945, 750975, 751004, 751034, 751064, 751093,
+   751123, 751152, 751182, 751212, 751241, 751270, 751300, 751329, 751359, 751388, 751418, 751447,
+   751477, 751506, 751536, 751566, 751595, 751625, 751655, 751684, 751714, 751743, 751772, 751802,
+   751831, 751861, 751890, 751920, 751950, 751979, 752009, 752039, 752068, 752098, 752127, 752156,
+   752186, 752215, 752244, 752274, 752304, 752333, 752363, 752393, 752423, 752452, 752482, 752511,
+   752540, 752570, 752599, 752628, 752658, 752688, 752717, 752747, 752777, 752806, 752836, 752866,
+   752895, 752924, 752954, 752983, 753012, 753042, 753072, 753101, 753131, 753160, 753190, 753220,
+   753250, 753279, 753308, 753338, 753367, 753397, 753426, 753456, 753485, 753515, 753544, 753574,
+   753604, 753633, 753663, 753692, 753722, 753751, 753781, 753810, 753839, 753869, 753898, 753928,
+   753958, 753987, 754017, 754047, 754076, 754106, 754135, 754165, 754194, 754223, 754253, 754282,
+   754312, 754341, 754371, 754401, 754431, 754460, 754490, 754519, 754549, 754578, 754607, 754637,
+   754666, 754696, 754725, 754755, 754785, 754814, 754844, 754874, 754903, 754933, 754962, 754991,
+   755021, 755050, 755080, 755109, 755139, 755168, 755198, 755228, 755257, 755287, 755316, 755346,
+   755376, 755405, 755434, 755464, 755493, 755523, 755552, 755582, 755611, 755641, 755671, 755700,
+   755730, 755760, 755789, 755818, 755848, 755877, 755907, 755936, 755965, 755995, 756025, 756054,
+   756084, 756114, 756144, 756173, 756202, 756232, 756261, 756290, 756320, 756349, 756379, 756408,
+   756438, 756468, 756498, 756527, 756557, 756586, 756616, 756645, 756674, 756704, 756733, 756763,
+   756792, 756822, 756852, 756882, 756911, 756941, 756970, 757000, 757029, 757058, 757088, 757117,
+   757147, 757176, 757206, 757236, 757265, 757295, 757325, 757354, 757383, 757413, 757442, 757472,
+   757501, 757531, 757560, 757590, 757619, 757649, 757679, 757708, 757738, 757767, 757797, 757826,
+   757856, 757885, 757915, 757944, 757974, 758003, 758033, 758062, 758092, 758121, 758151, 758181,
+   758210, 758240, 758270, 758299, 758328, 758358, 758387, 758416, 758446, 758475, 758505, 758535,
+   758565,
+)

hijri_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: hijri-cli
+Version: 0.1.0
+Summary: Hijri (Umm al-Qura) date command for the terminal: print today's Hijri date or convert between Hijri and Gregorian.
+Author: Muhammad Bakhit
+Project-URL: Homepage, https://github.com/mubakhit/hijri-cli
+Project-URL: Issues, https://github.com/mubakhit/hijri-cli/issues
+Keywords: hijri,umm al-qura,islamic calendar,date,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+License-File: LICENSE-ar.txt
+License-File: hijridate-LICENSE.txt
+Dynamic: license-file
+
+# hijri-cli
+
+A simple command that prints and converts dates in the Umm al-Qura Hijri
+calendar, the official calendar of Saudi Arabia. It works like the `date`
+command, with no locale setup needed.
+
+## Install
+
+```
+pip install hijri-cli
+```
+
+## Usage
+
+Print today's Hijri date:
+
+```
+$ hijri
+Friday 3 Jumada II 1448 14:34:5
+```
+
+Convert a Gregorian date to Hijri:
+
+```
+$ hijri -d 2024-08-05
+Monday 1 Safar 1446
+```
+
+Convert a Hijri date to Gregorian:
+
+```
+$ hijri -g 1446-02-01
+Monday 05 August 2024
+```
+
+Show help:
+
+```
+$ hijri --help
+```
+
+## Accuracy
+
+Dates from 1343 AH to 1500 AH (1924 to 2077 CE) follow the official
+Umm al-Qura table. Dates outside this range are calculated arithmetically
+and may differ from the official calendar by a day.
+
+## Credits
+
+This tool is inspired by, and built on, the
+[hijra](https://github.com/ojuba-org/hijra) project by Ojuba Linux, written
+by Muayyad Saleh Alsadi. Sadly, that project is no longer being developed.
+This tool reuses its conversion engine (`hijra.py`) and adds Umm al-Qura
+support.
+
+The Umm al-Qura table data comes from the
+[hijridate](https://github.com/dralshehri/hijridate) project by
+Mohammed Alshehri.
+
+## License
+
+Released under the Waqf Public License. See `LICENSE.txt`.
+
+The Umm al-Qura table data is under the MIT License.
+See `hijridate-LICENSE.txt`.

hijri_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+cli.py,sha256=FqGS5kd6vnN5F9-j5di1zKeDxWuLOI3A34Ob27CDQrA,3817
+hijra.py,sha256=0ngk7OKB7v0tFnnjJO0H7P4NHyfbBsfRoo4p8L4UFrw,14230
+hijra_uq.py,sha256=c9XLz-ccWv5z0oCcYVtFyNNMDnGbtNuBZHv9rMYstbY,16423
+hijri_cli-0.1.0.dist-info/licenses/LICENSE-ar.txt,sha256=j5N7v5-c5J55df1sKPgMbdCCTS83nc8gMyn6NtjDWrY,13779
+hijri_cli-0.1.0.dist-info/licenses/LICENSE.txt,sha256=3K38Ingmk0T5wpUM3-K40CxVtVCm-McCEIVpH8wSuV0,12221
+hijri_cli-0.1.0.dist-info/licenses/hijridate-LICENSE.txt,sha256=a9HR0X3rN3B5CchU5peHCnSJcYq_on4DzRSgTZMpaTQ,1069
+hijri_cli-0.1.0.dist-info/METADATA,sha256=4Uh48vpfG9iY0JWf3aQHhpz0zq18lJwCNU-XkRiNFQ8,2123
+hijri_cli-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+hijri_cli-0.1.0.dist-info/entry_points.txt,sha256=_YUlhEwrUym0DBhZ24hH_Y94N8UjDIdo7rZHVPBmM0I,35
+hijri_cli-0.1.0.dist-info/top_level.txt,sha256=JZOO_j5jVkcSb3S6o1aGNeyueRix59HFiFZJzqUPxaQ,19
+hijri_cli-0.1.0.dist-info/RECORD,,

hijri_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hijri_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hijri = cli:main

hijri_cli-0.1.0.dist-info/licenses/LICENSE-ar.txt

@@ -0,0 +1,138 @@
+   بسم الله الرحمن الرحيم
+
+                                         رخصة "وقف" العامة
+
+                                               مقدمة
+
+   إن نشر أي عمل فكري (برنامج حاسوبي أو كتاب على سبيل المثال لا الحصر) لا يكون بالبيع وإن بدا
+   كذلك بل يكون باتفاقية ضمنية لا قيمة لها لولا مفهوم الملكية الفكرية الذي رسخته القوانين الوضعة
+   التي يفترض أنها وضعت لحفز نشر الأعمال الفكرية النافعة. ترتكز الملكية الفكرية على أن أول مودع
+   العمل (يسمى المالك Owner أو copyright holder وسنشير له في هذه الوثيقة باسم صاحب العمل) يملك
+   الحق في العمل بصورته المعنوية على أي وسيط مادي كان وله حق التصرف في ملكه المزعوم. إن أي
+   استعمال للعمل الفكري دون الإذن المسبق الصريح من مالك العمل يعد مكافئا أخلاقيا لسرقة السفن أو
+   “قرصنة” بنظرهم. هذا الإذن يسمى “رخصة License” وتهدف تلك الرخص غالبا لإعطاء المالك (غالبا
+   الناشر) أفضلية في السوق أمام الناشرين الآخرين من خلال احتكار العمل وذلك بفرض قيود على
+   المستخدمين لا الناشرين. تسمى مثل تلك الأعمال بالأعمال “المملوكة Proprietary”.
+
+   إننا نرى أن هذه الاتفاقيات (الرخص المملوكة) مجحفة جدا لكننا ندرك إن قبول اتفاقية معينة (مثل
+   رخص البرامج المملوكة) وأنت تضمر مسبقا خرقها أمر غير أخلاقي ^1). لهذا فنحن لا نحل المشكلة
+   بمشكلة أخرى بل إننا نقدم البديل.
+
+   نحن لدينا رؤية مختلفة فنحن نقدم أعمالنا الفكرية من برامج حاسوبية وغيرها ابتغاء وجه الله، والتي
+   هي الركيزة الأساسية لهذه الرخصة التي تميزها عن الرخص المملوكة وعلى أي غاية آخرى (مثل نشر العلم
+   النافع أو جني الأرباح) أن تتحقق بوسيلة لا تخالف هذا الهدف الأسمى.
+
+   في قناعتنا - التي لا نلزم أحدا بها والتي لا يضيرك أن لا تشترك معنا فيها - أن الاسلام يحرم
+   وبشكل قطعي حكر العلم والمعرفة والانتاج الفكري على وجه العموم، وهذا التحريم يأتي من عدة أوجه :
+
+     * الحديث النبوي الشريف : “من كتم علما ألجمه الله يوم القيامة بلجام من نار” ^2) وقد جاءت
+       كلمة العلم نكرة عامة فهي تنطبق على كل علم ينتفع الناس به سواء علم ديني أو دنيوي.
+     * أن الإسلام حدد ما يصح أن يكون مملوكا وذلك لا ينطبق على العمل الفكري لأنه ليس عينا محصورا
+       وأغلب شروط البرمجيات المملوكة تقع في بيع الغرر (ذاك أن ما لا يجوز بيعه لا يجوز تملكه) دل
+       عليه ما ورد من النهي عن بيع الغرر في صحيح مسلم (ويدخل فيه مسائل كثيرة غير منحصرة كبيع
+       المعدوم والمجهول وما لا يقدر على تسليمه وما لم يتم ملك البائع عليه) وما ورد عن الأئمة
+       الأربعة من فهمهم لهذا.
+     * لسنا بحاجة لابتداع شيء لنشر العلم لأن الأعمال الفكرية ليست محدثة وأن قرون الخير الأولى
+       نشرت العلم دون تملكها.
+     * حبس المعرفة والعلم عمن يحتاجه هو إضرار بالناس لصالح قلة منهم، وهذا مما نهى عنه الشارع ولا
+       يبرر هكذا فعل إلا من يؤمن بالرأسمالية الذاتية التي تطرفت في تعظيم مصلحة الفرد.
+     * انتفاء مبرر المصلحة إذا وجدت طرق لنشر الأعمال الفكرية والتربح منها دون كتمها.
+     * إن المتمعن في قوانين الملكية الفكرية المختلفة يجد في أنها تتلخص بإعطاء “المالك” المزعوم
+       الحق في تحريم ما أحله الله ليكون ذلك مدخلا له في كسب مادي ولا علاقة لها بتقديم خدمة أو
+       منتج معين.
+     * الغموض الذي يحيط بماهية الشيء المزعوم ملكه تفتح الباب أمام جبات “الأتاوات” حيث تتكسب بعض
+       الشركات من التهديد بخطر المقاضاة حتى على أشياء لا تملكها والقضاء الأمريكي يغص بمثل هذه
+       القضايا.
+
+   فإن كانت الغاية قد بررت الوسيلة لواضعي الدستور الأمريكي حين أقروا مفهوم ”الملكية الفكرية”
+   كحق مكتسب (غير فطري باعترافهم) يخدم ما تؤمن به ثقافتهم من تعظيم المصلحة الذاتية وتقديمها على
+   كل شيء؛ ذاك لا يعنينا في شيء ونحن نؤمن بعدم صلاحية ذلك لعموم البشر، لهذا جاءت رخصة “وقف”
+   العامة (كما غيرها الكثير من رخص التوزيع المضادة لحكر التوزيع)، فهي وضعت لكي تؤكد لمستهلك العمل
+   الفكري أن لا قيد يفرضه صاحب العمل على استخدم منتجه والإفادة منه أو إعادة انتاجه وتوزيعه. أي أن
+   تجعل حقوق الطبع والتوزيع “ممنوحة” أو مرفوعة وليس “محفوظة” (وبالإنجليزية يشار لها باسم copyleft
+   او copy-wrong تهكما على copyright)
+
+   فمعادلة وتفاصيل تركيب الدواء هي عمل فكري، وبرمجية الحاسوب هي عمل فكري وقصيدة الشعر هي عمل
+   فكري. وهي بشكل عام كل فكرة تنفع الناس تصلهم على شكل منتج. وعندما نتكلم عن العمل الفكري فإننا
+   نحدد التعريف بالفكر الذي ينفع الناس نشره ولا نقصد به عموم الفكر فلكل منا خصوصيته وأسراره التي
+   لايشارك بها الاخرين. فأسماء الزبائن وأرقام المناقصات وسياسة الدولة العسكرية أو السياسية ليست
+   أعمالا فكرية.
+
+   وهنا يجدر الوقوف عند مسألتين :
+
+     * الأولى، أن الحق الأدبي للصاحب العمل يبقى للمبتكر الأصلي على كل الأحوال. فلا يجوز لأحد أن
+       يأخذ هذا العمل وينتحله ويدعيه لنفسه.
+     * والثانية، أن لصحاب العمل ولغيره (ممن عندهم الكفاية) الإفادة المادية من العمل كأن يطلب
+       أتعابا أو يتقاضى أجرا عن تحسينه أوتطويره أو أجرا عن تدريسه وهكذا. ولكن ما وراء ذلك فلا يحق
+       له إدعاء ملكيته للفكرة أو العمل في صورته المعنوية ولا يحق له منع الآخرين من اعادة نشرها
+       والاستفادة منها. وهذا لا تناقض مع كون العمل موقوفا لأن الموقوف هو أصل العمل الفكري بصورته
+       المعنوية وليس الوسيط أو الخدمة ^3)
+
+                                              تعريفات
+
+   تكون التعريفات هنا هي المقصودة عند استخدامها في الرخصة :
+
+     * العمل الفكري (أو اختصارا العمل): هو أي عمل فكري نافع غير مادي ولا ملموس ويمكن لمن يتلقاه
+       عمل نسخ منه ونقله إلى آخرين دون أي عبء على من قام بإيصال النسخة اليه.
+     * صاحب العمل : هو الشخص المُبتكِر أو الجهة التي قامت بتطوير وتوفير العمل الفكري (والتي تملك
+       حقوق النسخ عند الجهات الرسمية إن لزم الأمر).
+     * المُنتًفع (المستخدِم): هو الشخص أو الجهة التي ترغب بالانتفاع من العمل الفكري.
+     * رخصة الاستخدام (أو اختصارا الرخصة): هي هذا العقد الذي بين يديك وهو عقد بين صاحب العمل
+       والمنتفع يحق للمنتفع بموجبه وضمن شروطه الاستفادة والانتفاع من العمل. ونظرا لتوفر العمل
+       بشكل مفتوح للجميع فإن قيام المنتفع بالاستفادة من العمل الفكري يعني بالضرورة إقراره
+       وموافقته على كافة شروط الرخصة. فإذا لم يكن المنتفع موافقا على الرخصة تنتفي عنه حقوق الحقوق
+       الممنوحة بموجبها ويصبح أي انتفاع بالعمل غير مشروع ويعرض نفسه للمقاضاة.
+
+                                            بنود الرخصة
+
+   رخصة وقف العامة، يرمز لها اختصارا بـ “وقف”، هي رخصة لتوزيع العمل الفكري (من برمجيات أو مؤلفات
+   مكتوبة أو إنتاج فني على سبيل المثال لا الحصر). تتشابه هذه الرخصه في اهدافها مع رخص البرمجيات
+   الحرة والتوثيق الحر و رخصة الانتاج المشترك. ولكنها تزيد عليها ببعض الجوانب المتعلقة بالهدف من
+   وراء الانتاج و حدود الاستخدام.
+
+   رخصة وقف وكما يقترح الاسم هي إقرار من صاحب العمل بأن هذا العمل هو وقف لله تعالى ويتقصد به نوال
+   رضاه من خلال انتفاع الناس به، أي أن هذا العمل هو صدقة جارية لوجه الله تعالى. وبذلك فإن رخصة
+   وقف تقر بأن للمنتفع -أيا كان جنسه أو لونه أو عقيدته- الحق في الإفادة من العمل وإعادة توزيعه
+   وحتى تطويره ضمن الشروط التالية:
+
+     * أولا - أوجه الاستخدام :
+
+   يحق للمنتفع استخدام العمل ضمن أي غرض فيه منفعة ولايجوز استخدامه فيما يسئ للأخرين أو يخالف
+   مبادئ الإسلام السمحة. مع ملاحظة أن الأعمال التي يغلب الظن أنها الضارة لا يجوز أن توضع تحت هذه
+   الرخصة أصلا.
+
+     * ثانيا - حق التوزيع :
+
+   يحق للمنتفع إعادة توزيع العمل بصورته الأصلية ودون تعديل وتحت شروط رخصة وقف، بالكم الذي يريد مع
+   صون ذكر الحق الأدبي لصاحب العمل.
+
+     * ثالثا - حق التعديل :
+
+   يحق للمنتفع الحصول على النسخة المصدرية للعمل كما ويحق له التعديل عليها بما يناسب احتياجاته
+   وضمن الحدود الموضحة في بند أولا.
+
+     * رابعا - حق توزيع النسخة المُعدّلة :
+
+   يحق للمنتفع إعادة توزيع العمل المعدّل فقط تحت رخصة وقف العامة وعلى أن يذكر أصل العمل المعدل
+   وطبيعة التعديل وأن يكون واضحا بما لايدع مجالا للبس أن هذه النسخة معدلة وليست هي النسخة الأصلية
+   التي انتجها صاحب العمل الأول.
+
+     * خامسا - عدم المسؤلية :
+
+   لا يتحمل صاحب العمل أية مسؤوليه لا قانونية ولا أخلاقية عن حسن أو إساءة استخدام العمل أو
+   الأضرار المباشرة أو غير المباشرة الناتجة عنه إلى أقصى حد يسمح به القانون. وصاحب العمل بهذا لا
+   يقدم أية ضمانة لا ضمنا ولا تصريحا بقدرة المنتج على تحقيق أي غرض.
+
+   المسؤولية الكاملة تقع على عاتق المنتفع والضمانة الوحيدة المقدمة له هي مصدر العمل.
+
+                                              الخلاصة
+
+   استخدام رخصة وقف العامة يساعد في نشر الوعي على خطر مفاهيم الملكية الفكرية. كما ويقدم البديل
+   القانوني وإن كنّا لانؤمن بقانونية تلك الملكيات.
+
+   ^1) انظر http://www.islam-qa.com/ar/ref/454
+   ^2) الحديث صحيح رواه أحمد وأبو داود والترمذي وابن ماجه انظر “رفع المنار بطرق حديث من
+   كتم علماً ألجمه الله بلجام من نار”
+   ^3) مثلا يجوز أخذ أجل على نقل ثمار أرض موقوفة أو عصرها
+
+

hijri_cli-0.1.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,222 @@
+   بسم الله الرحمن الرحيم
+
+   In the name of Allah, Most Gracious, Most Merciful
+
+                         "Waqf" General Public License
+
+   This is the informal English translation of Waqf General Public License.
+   Anything but the Arabic version of the license has no value except for
+   convenience of our English speaking users. When we talk about the License
+   we refer to the Arabic version, which is the only one we officially
+   offer, we will try our best to make other translation as accurate as
+   possible but because of the nature of human languages we use one single
+   reference language.
+
+                                    Preamble
+
+   Publishing any intellectual work (including but not limited to books and
+   Computer Software) is not done by selling even if it appeared to be so,
+   but it's about getting an implied license that has no enforcement without
+   the concept of intellectual property granted by man-made laws which was
+   acquired as they claim to promote the publication of science and the
+   useful arts. The concept of the so called “intellectual property” is
+   centered around giving ownership to the first one who register the work
+   (called owner or copyright holder and we will refer to him/her/it as
+   holder) then the holder practice his rights on the work in it's intangible
+   form on any media it's carried, and thus using the intellectual work
+   without explicit prior permission is according to them ethically
+   equivalent to hijacking ships or “piracy” as they call it. This permission
+   is called License and it's aimed to give the holder (usually the
+   publisher) an advantage in the market against other publishers through
+   monopoly on providing that work by imposing restrictions on the users not
+   the publishers. Such works are called “Proprietary”.
+
+   We see that such agreements (proprietary licenses) are evil, but we also
+   acknowledge that making an agreement with a prior intention to violate it
+   is another immoral evil ^1). We don't solve problems with problems, we
+   offer an alternative.
+
+   We have a different vision, we offer our work (like computer software) to
+   please Allah, and this is the pillar of this license which distinguish it
+   from proprietary licenses. Any other intention (like spreading knowledge
+   or getting profits) should be accomplished in ways that does not go
+   against our primary moral aim.
+
+   According to our believes (which we don't enforce on any one, and you may
+   or may not share it with us) that Islam certainly forbids monopoly and
+   concealing knowledge in general, and this comes from:
+
+     * The sound Hadith (saying of prophet Muhammad PBUH): “Who conceal any
+       type of knowledge will be bridle with a bridle of fire on the Day of
+       Resurrection.” ^2)
+     * Islamic Jurisprudence has specified what can be owned, and the rules
+       does not apply to ideas as it's not a bounded tangible object and
+       almost all the terms of proprietary agreements fall in ruling of
+       forbidden Gharar^3) (a kind of fraud that use uncertainty to
+       fool the customers) as we see in Imam Muslim Sahih description of that
+       term {and below that term we classify so many actions like selling
+       negligible objects or unknowns or what can't be delivered or things
+       that are not full owned by the seller} and such view is also shared by
+       the four major scholars.
+     * The laws of Fiqh (Islamic Jurisprudence) have been perfected in the
+       good centuries and no new rulings are allowed to be brought except for
+       newly discovered things and this does not apply ideas as they did
+       exist in the past centuries and Muslims massively spread them without
+       owning them. FYI: Almost all the Islamic literature is freely
+       available on the internet.
+     * Concealing useful knowledge from those who need it impose damage to
+       people for temporal gains to few individuals. This can not be
+       justified by Shari'a (Islamic Law), it's only justified by
+       individualist capitalism ^4)
+     * Even bringing interests to software publishers is not a valid excuse
+       because there are some companies produce and publish software without
+       owning them (proprietary software) and yet they gain profits.
+     * the so call “Intellectual Proprietary” is all about giving owners the
+       right to forbid what Allah had made lawful to gain money, not by
+       providing service nor goods.
+     * The uncertainty and untangable nature of the claimed owned product is
+       the source of “protection money collecting” where some company
+       threaten some smaller company by copyright infringement lawsuit on
+       some purposely ambiguous product which the later can't afford so they
+       go safe and pay.
+
+   If the good intentions made excuses to introduce “intellectual
+   proprietary” by the Machiavellists who wrote the American constitution
+   as an acquired right (at least they admit it's not a natural right), they
+   serve their own way of life which is not international. We don't take
+   that. We have our own high moral standards. We introduce Waqf General
+   Public License to place it among the anti-copyright licenses. This license
+   is designed to grant rights to users not to restrict them, it's uses the
+   concept of copyleft/copy-wrong as opposed to the concept of copyright.
+
+   Computer software, Medicine formula or even poems are considered to be
+   intellectual works and thus can be covered by “Waqf”. An intellectual work
+   is any useful idea that can be delivered or utilized by people. “Waqf” is
+   not meant for ideas in general, but for intellectual work which is
+   beneficial to people if published. As we support protecting privacy for
+   example one shouldn't publish names of his customers, bid prices,
+   government military or political secrets because those are not
+   intellectual works.
+
+   We should clarify two things:
+
+     * First: The favor and ethical rights of the holder are preserved and
+       acknowledged
+     * Second: original author and any other party (if they have the
+       intention and the ability) have the right to get fees on enhancing the
+       work or developing it or to provide paid services or paid courses
+       …etc. but not the work in its intangible form. There is not
+       contradiction between getting fees on services because what is covered
+       by “Waqf” is the source form of the work not the media nor the service
+       (the same way one can take fees on shipping fruits for a charitable
+       Waqf fruit field or make juice)
+
+                                  Definitions
+
+   The following terms would have the corresponding meanings in this license
+
+     * The intellectual work (or The work for short): is any useful
+       intangible intellectual product that can be passed on to others or
+       replicated withno cost imposed on the original author or the one who
+       pass it on before.
+     * The holder: is the creative author or the party which carried the
+       process of developing the work and make it available (and the one who
+       holds the copyrights on the product before the governmental offices).
+     * the licensee or the user: any one or party who uses the work (runs,
+       copies, modifies or otherwise takes benefits provided by the work).
+     * The license: this agreement (the Arabic version of “Waqf”) between the
+       two parties (the holder and the user) covering the usage of the second
+       party on the work provided by the first party. The usage of the
+       product is with accordance to the terms of this license. And because
+       of the intangible nature of the work, this agreement applies by using
+       the product (in any way) without signing the agreement. One do not
+       accept the terms looses the rights given by this license and his/her
+       usage of the work is considered illegal and will be sued.
+
+                                   The Terms
+
+   Waqf General Public license (or “Waqf” for short) covers intellectual
+   works (including but not limited to Software and paper publications,
+   scientific theses, art works) and have many common features with FLOSS
+   licenses. Waf is distinguished with its moral intentions behind the work
+   and usage limits.
+
+   As the name suggests, with “Waqf” ^5) the holder announce his/her work
+   was produced and made available to the public for the sake of Allah aimed
+   to please Allah by providing people with useful works. It's a form of
+   “Sadaqa Jariah” ^6).
+
+   “Waqf” gives users (regardless of their nationality, color, race,
+   religion) the right to benefit from the work with running, copying,
+   redistribution, or even develop and only with according to the following
+
+     * First - Usage :
+
+   The user may use the work for any good purpose and he may not use it to
+   harm others or violate the permissive principles of Islam ^7). Notice
+   that any work that is most likely harmful can't be put under Waqf in the
+   first place.
+
+     * Second - Redistribution :
+
+   The user have the right to redistribute the unmodified work in any
+   quantity to any third party under the terms of this license, acknowledging
+   the favor and ethical rights of the holder to the third party.
+
+     * Third - Modifications :
+
+   The user has the right to get the source form of the work and make
+   modifications enhancing or adopting to the user's needs to the limits
+   given by this license.
+
+     * Fourth - Redistribute modifications:
+
+   The user can redistribute modifications only under this license provided
+   that he points to previous original work (the unmodified work) and its
+   author and the nature of modification clearly to the third party to whom
+   the modified work is presented in a way that no one may reasonably get
+   confused between it and the original unmodified work of the previous
+   author.
+
+     * Fourth - Disclaimer of responsibility :
+
+   The holder does not take any legal nor moral direct or indirect
+   responsibility nor liability on the good or bad usage or damages caused by
+   the work to the farthest level allowed by the law. THIS SOFTWARE IS
+   PROVIDED AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+   PARTICULAR PURPOSE ARE DISCLAIMED BY THE HOLDER.
+
+   The entire responsibility is on the user and the only warranty given to
+   him is the source of the work.
+
+                                   Conclusion
+
+   Applying Waqf public license help to spread the awareness of dangers
+   caused by intellectual property. And provide people with a legal
+   alternative even though we don't believe on the validity of such man made
+   laws.
+
+   ^1) http://www.islam-qa.com/ar/ref/454
+   ^2) This is an authentic sound/Sahih as it's narrated by Imam
+   Ahmad, Abu Dawood, AlTirmithi and Ibn Majah. Refer to “Hoisting the
+   Lighthouse : A synopsis of the Various narrations of the Hadith: Whoever
+   conceals knowledge, Allah will bridle him with a bridle of fire” or in
+   Arabic “رفع المنار بطرق حديث من كتم علماً ألجمه الله بلجام من نار”.
+   ^3) Some information about Ghrar is available at
+   http://www.investopedia.com/terms/g/gharar.asp
+   ^4) Although Islamic economy is a kind of liberal capitalism economy
+   but it's regulated with so many moral rulings that guarantee social
+   justice
+   ^5) The name Waqf means to prevent the source or assets from being
+   consumed while giving away for charity the proceeds.
+   ^6) Sadaqa Jariah means sustainable charity which is a kind of charity
+   that continue to be beneficial to people even after the death of the one
+   who give it like giving the fruits of a field but not the field, more over
+   prophet Muhammad PBUH specifically named useful knowledge as a form of
+   that kind of charity.
+   ^7) Some scholars use the term Maqasid Alsharia and summarize them by
+   saying that it aims to protect people rights in religion, lives, sanity,
+   breed, and properties.
+
+

hijri_cli-0.1.0.dist-info/licenses/hijridate-LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Mohammed Alshehri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hijri_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+cli
+hijra
+hijra_uq