Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sentryco/nettime
🕑 Network-time-synchronization in swift
https://github.com/sentryco/nettime
ios macos network-time-protocol ntp ntp-client swift
Last synced: 1 day ago
JSON representation
🕑 Network-time-synchronization in swift
- Host: GitHub
- URL: https://github.com/sentryco/nettime
- Owner: sentryco
- License: mit
- Created: 2024-02-09T05:13:28.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-11-06T13:10:25.000Z (11 days ago)
- Last Synced: 2024-11-06T14:22:45.605Z (11 days ago)
- Topics: ios, macos, network-time-protocol, ntp, ntp-client, swift
- Language: Swift
- Homepage:
- Size: 30.3 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/sentryco/NetTime/actions/workflows/tests.yml) [](https://codebeat.co/projects/github-com-sentryco-nettime-main)
# 🕑 NetTime
Network-time-synchronization in swift
## Features
- Network Time Protocol (NTP) support for accurate time synchronization.
- Easy to use API for fetching and using network time.
- Caching of server time for quick access.
- Compatible with iOS and macOS.
## Requirements
- iOS 17 and later
- macOS 14 and later
## Installation
To add the NetTime package to your Swift project, add the following line to the `dependencies` value of your `Package.swift`.
```swift
.package(url: "https://github.com/sentryco/NetTime", branch: "main")
```
Then include `"NetTime"` in the `dependencies` value of any Target in which you want to use NetTime.
## Usage
Here's an example of how to use NetTime:
```swift
import NetTime
Date.updateTime { // Call when app launches etc
print("☀️ Current Date: \(Date().formatted())")
print("☎️ Server time: \(Date.serverTime.formatted())")
}
Date.serverTime // Returns the cached server date
```
## Competitors:
There are several libraries available for network time synchronization in Swift. Here are a few:
1. [TrueTime.swift](https://github.com/instacart/TrueTime.swift): An NTP client for Swift. This library allows you to get the "true" network time, and not rely on the device's system clock.
2. [Kronos](https://github.com/lyft/Kronos): Another NTP based time synchronization library developed by Lyft.
3. [NetClock](https://github.com/troligtvis/NetClock): A simple NTP client to get internet time in Swift.
4. [SwiftNTP](https://github.com/DoubleSymmetry/SwiftNTP): A simple Network Time Protocol client written in Swift.
> [!TIP]
> Remember to check the documentation and the community around these libraries to ensure they fit your needs and are actively maintained.
## Contributing
Contributions are welcome! Please read our [contributing guidelines](CONTRIBUTING.md) for details.
## License
NetTime is released under the MIT License. See [LICENSE](LICENSE) for details.
## Todo:
- Do more exploration into side-effects
- Comb the competitors for ways to improve
- add Troubleshooting or FAQ section: If there are common issues users run into, addressing them in the README can save time for both you and the users.
- add Versioning: If you're planning on maintaining this project long-term, it might be helpful to include information about the versioning system you're using.
- add Screenshots or GIFs: If applicable, visual aids can help users understand how your package works or what it looks like when it's running.
- Error Handling and Logging: The current implementation of network requests and error handling could be improved for better reliability and maintainability. For instance, in the updateTime function in Date+NetTime.swift, the error handling is minimal and does not provide detailed feedback for debugging. Action: Enhance error handling by using Result types or throwing errors that can be caught and handled appropriately. Also, improve logging to capture more detailed information about the state and errors.
- Unit Testing: The unit tests could be expanded to cover more scenarios and ensure robustness. For example, the NetTimeTests.swift file shows tests for time conversion and connectivity but could include more comprehensive tests for error cases and edge cases. Action: Add more comprehensive tests, particularly focusing on failure modes and network issues.
- Network Reliability The Reachability.swift utility checks for internet connectivity but could be enhanced to handle different network conditions more robustly. Action: Enhance the network reachability checks to handle various network conditions and provide fallbacks or retries.
- Remove Logger as a dependency. do logging in higher levels of the code etc.