Skip to content

Commit

Permalink
[ADD] Convenience initializers
Browse files Browse the repository at this point in the history
  • Loading branch information
Freelenzer committed Jul 25, 2023
1 parent 7903113 commit d6a0714
Show file tree
Hide file tree
Showing 9 changed files with 120 additions and 0 deletions.
7 changes: 7 additions & 0 deletions .swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

9 changes: 9 additions & 0 deletions Classes/GPXPoint.swift
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,15 @@ open class GPXPoint: GPXElement, Codable {
self.longitude = longitude
}

/// Initialize with elevation, time, latitude, longitude
public init(elevation: Double? = nil, time: Date? = nil, latitude: Double? = nil, longitude: Double? = nil) {
super.init()
self.elevation = elevation
self.time = time
self.latitude = latitude
self.longitude = longitude
}

/// Inits native element from raw parser value
///
/// - Parameters:
Expand Down
5 changes: 5 additions & 0 deletions Classes/GPXPointSegment.swift
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,11 @@ open class GPXPointSegment: GPXElement, Codable {
}
}

/// Initialize with points
public init(points: [GPXPoint]) {
self.points = points
}

// MARK:- Public Methods

/// Adds a new point to segment, and returns the added point.
Expand Down
15 changes: 15 additions & 0 deletions Classes/GPXRoot.swift
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,21 @@ public final class GPXRoot: GPXElement, Codable {
self.creator = creator
}

/// Initialize with values
///
/// - Parameters:
/// - version: GPX version that will be generated
/// - creator: Name of the creator of the GPX content
/// - metadata: Metadata to be included in your GPX content
/// - waypoints: Array of waypoints
/// - routes: Array of routes
/// - tracks: Array of tracks
/// - extensions: Items for extensions to GPX schema (if any).
/// Leave it as is, if used without modification to GPX schema
public init(version: String = "1.1", creator: String? = nil, metadata: GPXMetadata? = nil, waypoints: [GPXWaypoint] = [], routes: [GPXRoute] = [], tracks: [GPXTrack] = [], extensions: GPXExtensions? = nil) {

}

/// Inits native element from raw parser value
///
/// - Parameters:
Expand Down
23 changes: 23 additions & 0 deletions Classes/GPXRoute.swift
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,29 @@ public final class GPXRoute: GPXElement, Codable, GPXRouteType {
super.init()
}

/// Initializer with values for convenience
///
/// - Parameters:
/// - name: Name of the route.
/// - comment: Additional comment of the route.
/// - desc: Description of the route.
/// - source: Source of the route.
/// - links: A value type for link properties (see `GPXLink`)
/// Intended for additional information about current route through web links.
/// - type: Type of route.
/// - extensions: Items for extensions to GPX schema (if any).
public init(name: String? = nil, comment: String? = nil, desc: String? = nil, source: String? = nil, links: [GPXLink] = [], type: String? = nil, extensions: GPXExtensions? = nil, points: [GPXRoutePoint] = [], number: Int? = nil) {
self.name = name
self.comment = comment
self.desc = desc
self.source = source
self.links = links
self.type = type
self.extensions = extensions
self.points = points
self.number = number
}

/// Inits native element from raw parser value
///
/// - Parameters:
Expand Down
24 changes: 24 additions & 0 deletions Classes/GPXTrack.swift
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,30 @@ public final class GPXTrack: GPXElement, Codable {
super.init()
}

/// Initialize with values
///
/// - Parameters:
/// - links: A value type for link properties (see `GPXLink`)
/// Holds web links to external resources regarding the current track.
/// - segments: Array of track segments. Must be included in every track.
/// - name: Name of track.
/// - comment: Additional comment of track.
/// - desc: A full description of the track. Can be of any length.
/// - source: Source of track.
/// - number: GPS track number.
/// - type: Type of current track.
/// - extensions: Custom Extensions of track, if needed.
public init(links: [GPXLink] = [], segments: [GPXTrackSegment] = [], name: String? = nil, comment: String? = nil, desc: String? = nil, source: String? = nil, number: Int? = nil, type: String? = nil, extensions: GPXExtensions? = nil) {
self.links = links
self.segments = segments
self.name = name
self.comment = comment
self.desc = desc
self.source = source
self.number = number
self.type = type
self.extensions = extensions
}
/// Inits native element from raw parser value
///
/// - Parameters:
Expand Down
4 changes: 4 additions & 0 deletions Classes/GPXTrackPoint.swift
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,10 @@ public final class GPXTrackPoint: GPXWaypoint {
super.init(latitude: latitude, longitude: longitude)
}

public override init(links: [GPXLink] = [], elevation: Double? = nil, time: Date? = nil, magneticVariation: Double? = nil, geoidHeight: Double? = nil, source: String? = nil, type: String? = nil, satellites: Int? = nil, horizontalDilution: Double? = nil, verticalDilution: Double? = nil, positionDilution: Double? = nil, extensions: GPXExtensions? = nil, latitude: Double? = nil, longitude: Double? = nil) {
super.init(links: links, elevation: elevation, time: time, magneticVariation: magneticVariation, geoidHeight: geoidHeight, source: source, type: type, satellites: satellites, horizontalDilution: horizontalDilution, verticalDilution: verticalDilution, positionDilution: positionDilution, extensions: extensions, latitude: latitude, longitude: longitude)
}

override init(raw: GPXRawElement) {
super.init(raw: raw)
}
Expand Down
10 changes: 10 additions & 0 deletions Classes/GPXTrackSegment.swift
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,16 @@ public final class GPXTrackSegment: GPXElement, Codable {
super.init()
}

/// Inits segment from
///
/// - Parameters:
/// - points: Track points of the segment.
/// - extensions: Custom Extensions, if needed.
public init(points: [GPXTrackPoint] = [], extensions: GPXExtensions? = nil) {
self.points = points
self.extensions = extensions
}

/// Inits native element from raw parser value
///
/// - Parameters:
Expand Down
23 changes: 23 additions & 0 deletions Classes/GPXWaypoint.swift
Original file line number Diff line number Diff line change
Expand Up @@ -218,6 +218,29 @@ public class GPXWaypoint: GPXElement, GPXWaypointProtocol, Codable {
self.longitude = longitude
}

/// Initialize with parameters.
///
/// - Parameters:
/// - latitude: latitude value of the waypoint, in `Double` or `CLLocationDegrees`, **WGS 84** datum only. Should be within the ranges of **-90.0 to 90.0**
/// - longitude: longitude value of the waypoint, in `Double` or `CLLocationDegrees`, **WGS 84** datum only. Should be within the ranges of **-180.0 to 180.0**
///
public init(links: [GPXLink] = [], elevation: Double? = nil, time: Date? = nil, magneticVariation: Double? = nil, geoidHeight: Double? = nil, source: String? = nil, type: String? = nil, satellites: Int? = nil, horizontalDilution: Double? = nil, verticalDilution: Double? = nil, positionDilution: Double? = nil, extensions: GPXExtensions? = nil, latitude: Double? = nil, longitude: Double? = nil) {
self.links = links
self.elevation = elevation
self.time = time
self.magneticVariation = magneticVariation
self.geoidHeight = geoidHeight
self.source = source
self.type = type
self.satellites = satellites
self.horizontalDilution = horizontalDilution
self.verticalDilution = verticalDilution
self.positionDilution = positionDilution
self.extensions = extensions
self.latitude = latitude
self.longitude = longitude
}

/// Initialize a point type, and verifies that point is within ranges of what latitude and longitude should be.
///
/// - SeeAlso:
Expand Down

0 comments on commit d6a0714

Please sign in to comment.