KL-Py 0.1.9__tar.gz → 0.2.0__tar.gz

{kl_py-0.1.9 → kl_py-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: KL_Py
-Version: 0.1.9
+Version: 0.2.0
 Summary: A Python simplification module
 Author-email: Abbaskhurram255 <abbaskhurram255@gmail.com>
 Classifier: Programming Language :: Python :: 3

{kl_py-0.1.9 → kl_py-0.2.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "KL_Py"
-version = "0.1.9"
+version = "0.2.0"
 authors = [
     { name = "Abbaskhurram255", email = "abbaskhurram255@gmail.com" }
 ]

{kl_py-0.1.9 → kl_py-0.2.0}/src/KL_Py/KL_Py.py

@@ -921,7 +921,16 @@ class Date:
 				self.date_object.strftime(
 					"%D"
 				)
-	def hour(self) -> int:
+	def hour(self, new: Optional[int] = None) -> Self | int:
+		if isinstance(new, int)\
+			and not isinstance(new, bool)\
+			and new\
+				not in (True, False):
+					# if it's a true int, not a bool disguised as such
+					hour: int = new
+					return self.set_hour(
+						hour
+					)
 		hrs: int = self\
 			.date_object\
 			.hour
@@ -930,19 +939,42 @@ class Date:
 		return hrs
 	hours = hrs = hr = h = hour
 	get_hours = get_hrs = get_hr = get_h = get_hour = hour
-	def minute(self) -> int:
+	def minute(self, new: Optional[int] = None) -> Self | int:
+		if isinstance(new, int)\
+			and not isinstance(new, bool)\
+			and new\
+				not in (True, False):
+					# if it's a true int, not a bool disguised as such
+					minute: int = new
+					return self.set_minute(
+						minute
+					)
 		return self\
 			.date_object\
 			.minute
 	minutes = mins = min = m = minute
 	get_minutes = get_mins = get_min = get_m = get_minute = minute
-	def second(self) -> int:
+	def second(self, new: Optional[int] = None) -> Self | int:
+		if isinstance(new, int)\
+			and not isinstance(new, bool)\
+			and new\
+				not in (True, False):
+					# if it's a true int, not a bool disguised as such
+					second: int = new
+					return self.set_second(
+						second
+					)
 		return self\
 			.date_object\
 			.second
 	seconds = secs = sec = s = second
 	get_seconds = get_secs = get_sec = get_s = get_second = second
-	def period(self) -> int:
+	def period(self, new: Optional[str] = None) -> Self | str:
+		if isinstance(new, str):
+			period: str = new
+			return self.set_period(
+				period
+			)
 		return self.\
 			date_object\
 			.strftime("%p")
@@ -1005,8 +1037,8 @@ class Date:
 				.split(",")[0]\
 				.strip()
 			return name_of_day
-	day_name = day_of_week = dow = day_only
-	get_day_name = get_day_of_week = get_dow = get_day_only = day_only
+	name = day_name = day_of_week = dow = day_only
+	get_name = get_day_name = get_day_of_week = get_dow = get_day_only = day_only
 	def day_number(
 		self,
 		short: bool = False
@@ -1051,7 +1083,7 @@ class Date:
 		self,
 		short: bool = False
 	) -> str:
-			if isinstance(short, int)\
+			if isinstance(short, (str, int))\
 				and not isinstance(short, bool)\
 				and short\
 					not in (True, False):
@@ -1218,6 +1250,34 @@ class Date:
 		self,
 		mn: int
 	) -> Self:
+			if isinstance(mn, str):
+				if len(mn) < 3:
+					return self
+				mn = mn\
+					.strip()\
+					.lower()[:3]
+				months: list[str] = [
+					"jan",
+					"feb",
+					"mar",
+					"apr",
+					"may",
+					"jun",
+					"jul",
+					"aug",
+					"sep",
+					"oct",
+					"nov",
+					"dec"
+				]
+				if mn not in months:
+					return self
+				try:
+					mn = months.index(
+						mn
+					) + 1
+				except ValueError:
+					return self
 			if not isinstance(mn, int):
 				return self
 			if mn < 1:
@@ -1260,6 +1320,227 @@ class Date:
 			# and non-31-day months
 			return self
 	set_d = set_day
+	def add_day(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.set_d(
+				self.d_nr() + n
+			)
+			return self
+	add_days = increment_days =\
+		increment_day = add_d = add_day
+	def remove_day(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.add_days(
+				-abs(n)
+			)
+			return self
+	remove_days =\
+		decrement_days = decrement_day =\
+		subtract_days = subtract_day =\
+		remove_d = remove_day
+	def add_month(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.set_mn(
+				self.mn_nr() + n
+			)
+			return self
+	add_months = increment_months =\
+		increment_month = add_mn = add_month
+	def remove_month(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.add_months(
+				-abs(n)
+			)
+			return self
+	remove_months =\
+		decrement_months = decrement_month =\
+		subtract_months = subtract_month =\
+		remove_mn = remove_month
+	def add_year(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.set_yr(
+				self.yr() + n
+			)
+			return self
+	add_years = increment_years =\
+		increment_year = add_yr = add_year
+	def remove_year(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.add_years(
+				-abs(n)
+			)
+			return self
+	remove_years =\
+		decrement_years = decrement_year =\
+		subtract_years = subtract_year =\
+		remove_yr = remove_year
+	def add_hour(
+		self,
+		n: int = 1,
+		*args,
+		**kwargs
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.set_hours(
+				self.hours() + n,
+				*args,
+				**kwargs
+			)
+			return self
+	add_hours = increment_hours =\
+		increment_hour = add_h = add_hour
+	def remove_hour(
+		self,
+		n: int = 1,
+		*args,
+		**kwargs
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.add_hours(
+				-abs(n),
+				*args,
+				**kwargs
+			)
+			return self
+	remove_hours =\
+		decrement_hours = decrement_hour =\
+		subtract_hours = subtract_hour =\
+		remove_h = remove_hour
+	def add_minute(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.set_minute(
+				self.minute() + n
+			)
+			return self
+	add_minutes = increment_minutes =\
+		increment_minute = add_m = add_min = add_minute
+	def remove_minute(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.add_minutes(
+				-abs(n)
+			)
+			return self
+	remove_minutes =\
+		decrement_minutes = decrement_minute =\
+		subtract_minutes = subtract_minute =\
+		remove_m = remove_min = remove_minute
+	def add_second(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.set_second(
+				self.second() + n
+			)
+			return self
+	add_seconds = increment_seconds =\
+		increment_second = add_s = add_second
+	def remove_second(
+		self,
+		n: int = 1
+	) -> Self:
+			if not isinstance(n, int)\
+				or not n:
+					return self
+			self.add_seconds(
+				-abs(n)
+			)
+			return self
+	remove_seconds =\
+		decrement_seconds = decrement_second =\
+		subtract_seconds = subtract_sec =\
+		remove_s = remove_second
+	@classmethod
+	def tomorrow(cls) -> str:
+		return cls()\
+			.add_day()
+	@classmethod
+	def day_name_tomorrow(
+		cls,
+		*args,
+		**kwargs
+	) -> str:
+			return cls()\
+				.tomorrow()\
+				.name(*args, **kwargs)
+	name_tomorrow = day_name_tomorrow
+	@classmethod
+	def after_tomorrow(cls) -> str:
+		return cls()\
+			.add_days(
+				n=2
+			)
+	tomorrow_after_tomorrow = after_tomorrow
+	@classmethod
+	def day_name_after_tomorrow(
+		cls,
+		*args,
+		**kwargs
+	) -> str:
+			return cls()\
+				.after_tomorrow()\
+				.name(*args, **kwargs)
+	name_after_tomorrow = day_name_after_tomorrow
+	@classmethod
+	def yesterday(cls) -> str:
+		return cls()\
+			.remove_day()
+	@classmethod
+	def day_name_yesterday(
+		cls,
+		*args,
+		**kwargs
+	) -> str:
+			return cls()\
+				.yesterday()\
+				.name(*args, **kwargs)
+	name_yesterday = day_name_yesterday
 	def set_time(
 		self,
 		h: int,
@@ -1274,6 +1555,11 @@ class Date:
 					p = ampm
 				elif period is not None:
 					p = period
+			if type(p) == type(None):
+				# dont remove
+				# if p is STILL none
+				# use a fallback
+				p = self.ampm()
 			p = str(p)\
 				.strip()\
 				.lower()

{kl_py-0.1.9 → kl_py-0.2.0}/src/KL_Py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: KL_Py
-Version: 0.1.9
+Version: 0.2.0
 Summary: A Python simplification module
 Author-email: Abbaskhurram255 <abbaskhurram255@gmail.com>
 Classifier: Programming Language :: Python :: 3