degrees 0.1.7

A python lib for degree calculations and conversions

degrees V0.1.7

Contents

• Introduction
• Importing
• Class
  • Degree
• Functions
  • degree2radian
  • radian2degree
  • normalize
• Changelog

Introduction

A python lib for degree calculations and conversions

Importing

Just type import degrees.

Class

• class degrees.Degree(number)
  class degrees.Degree(degree_obj)
  class degrees.Degree(degree=0, minute=0, second=0)

  • Creating a Degree object

import degrees

print(degrees.Degree(1))  # 1°
print(degrees.Degree(2, 3, 4))  # 2°3'4"
print(degrees.Degree(1, second=2))  # 1°0'2"
print(degrees.Degree(1, 3))  # 1°3'
print(degrees.Degree(0, -1))  # -1'
print(degrees.Degree(1.5))  # 1°30'
print(degrees.Degree(2, -4))  # ValueError: if degree is not 0, minute and second must be positive integer

• calculating:

  a + b	a - b	a * b	a / b	math.trunc(a)
  abs(a)	math.ceil(a)	math.floor(a)	a % b
  a // b	+a	-a	hash(a)

  Added in version 0.1.7: Implemented the math.trunc function on the Degree objects.

• conversions:

  int(a)	float(a)	str(a)	repr(a)	bool(a)	complex(a)

• comparisons:

  a >= b	a > b	a = b
  a <= b	a < b	a != b

• staticmethod from_str(string)

  Return a degree object from a string.

• staticmethod from_iter(iterable)

  Return a degree object from an iterable.

• functools.cached_property total_seconds

  The total seconds of a degree object.

• deg

  The degree of a degree object(without sign).

• min

  The minute of a degree object(without sign).

• sec

  The second of a degree object(without sign).

• sign

  The sign of a degree object.

• property dms

  A tuple of (degree, minute, second).

Note

The attributes of Degree are read-only.

Functions

def degree2radian(x: Degree, /)

• Convert angle x from a degree object to radians.

def radian2degree(x: Union[int, float], /)

• Convert angle x from radians to a degree object.

def normalize(x: Degree, /)

• Be using for angle normalization.

Note:

These functions are renamed since version 0.1.5(did NOT declared in the doc of V0.1.5).

Version

version_info

• The version of this package, like sys.version_info.

Changelog

1. Added degrees.__trunc__.
2. Updated README.md.

Write in the end

If you found the bug in the code, you can email me at [e-mail]. I am happy to receive the advice!