# Dart Angles #

Official Dart package

Say goodby to naming suffixes like `...deg` or `...rad`, manual angle conversions like `x * rad2deg` and the inevitable mess when mixing up multiple angle units in your code.

This library provides a single class named `Angle`, wrapping your angle variables in a far more readable way, whereas raw doubles aren't very expressive about how they store their values. One can create an angle from various units, including degrees, radians, gradians and turns.

``````
// Various ways to define a half turn:
a0 = Angle.fromDegrees(180.0);
a2 = Angle.fromTurns(0.5);

a0.degrees; // = 180.0
a2.turns;   // = 0.5

``````

Trigonometic functions are defined on instances:

``````
x = Angle.asin(0.3);
y = x.sin; // = 0.3

``````

Angles are immutable by design, but there are operators like `+`, creating new angles:

``````
// 270°:
x = Angle.halfTurn() + Angle.fromDegrees(90.0);

``````

example/angles_example.dart

``````import 'package:angles/angles.dart';
import 'dart:math' as math;

main() {
// Various ways to define a half turn:
final x = Angle.fromDegrees(180.0);
final z = Angle.fromTurns(0.5);

x.degrees; // = 180.0
x.turns;   // = 0.5

// One can use built-in trigonometric functions:
final a = Angle.asin(0.3);
print(a.sin); // = 0.3

// Angles are immutable, but there are operators like +, creating new angles:
final threeQuarterTurn = Angle.halfTurn() + Angle.fromDegrees(90.0);
print(threeQuarterTurn); // 270°
}
``````

## Use this package as a library

### 1. Depend on it

``````
dependencies:
angles: ^1.2.1

``````

### 2. Install it

You can install packages from the command line:

with pub:

``````
\$ pub get

``````

with Flutter:

``````
\$ flutter pub get

``````

Alternatively, your editor might support `pub get` or `flutter pub get`. Check the docs for your editor to learn more.

### 3. Import it

Now in your Dart code, you can use:

``````
import 'package:angles/angles.dart';
``````
 Popularity: Describes how popular the package is relative to other packages. [more] 84 Health: Code health derived from static analysis. [more] 100 Maintenance: Reflects how tidy and up-to-date the package is. [more] 80 Overall: Weighted score of the above. [more] 88

We analyzed this package on Jan 19, 2020, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

• Dart: 2.7.0
• pana: 0.13.4

#### Health suggestions

Format `lib/src/angles_base.dart`.

Run `dartfmt` to format `lib/src/angles_base.dart`.

#### Maintenance issues and suggestions

Provide a file named `CHANGELOG.md`. (-20 points)

Changelog entries help developers follow the progress of your package. See the example generated by `stagehand`.

#### Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.0.0 <3.0.0
meta ^1.0.0 1.1.8
Dev dependencies
test ^1.0.0