https://github.com/timoliver/toreachability

A lightweight, unit-tested class that detects network status changes on iOS.
https://github.com/timoliver/toreachability

cocoapods internet ios macos network objective-c reachability

Last synced: 15 days ago
JSON representation

A lightweight, unit-tested class that detects network status changes on iOS.

• Host: GitHub
• URL: https://github.com/timoliver/toreachability
• Owner: TimOliver
• License: mit
• Created: 2019-02-23T10:22:56.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-01-27T05:32:46.000Z (10 months ago)
• Last Synced: 2024-10-14T21:51:47.760Z (29 days ago)
• Topics: cocoapods, internet, ios, macos, network, objective-c, reachability
• Language: Objective-C
• Homepage:
• Size: 652 KB
• Stars: 21
• Watchers: 3
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        


# TOReachability

	

[![CI](https://github.com/TimOliver/TOReachability/workflows/CI/badge.svg)](https://github.com/TimOliver/TOReachability/actions?query=workflow%3ACI)

[![Version](https://img.shields.io/badge/version-1.2.0-blueviolet?style=flat)](http://cocoadocs.org/docsets/TOReachability)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/TimOliver/TOReachability/master/LICENSE)

[![PayPal](https://img.shields.io/badge/paypal-donate-blue.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=M4RKULAVKV7K8)

*A lightweight, unit-tested class that detects network status changes on iOS.*

`TOReachability` is a small Objective-C class that can be used to detect when the current device changes its network status; between Wi-Fi, cellular, or none.

It based on, but is a completely new implementation of Apple's [Reachability](https://github.com/robovm/apple-ios-samples/tree/master/Reachability) class. Compared to Reachability, apart from being properly name-spaced for Objective-C, it has been cleaned up to use modern Objective-C conventions, removes since deprecated features, and removes much of the unnecessary code Apple included.

While `TOReachability` only currently includes the most basic of functionality, it is definitely open to PRs when and if anyone has additional functionality they would like.

## Features

* Fully-unit tested.

* Integrated with CocoaPods and Carthage.

* Reactively executes callback logic whenever the network status of the current status changes.

* Callback choices include blocks, delegates and `NSNotification`.

* For cases where only Wi-Fi is needed, an option may be set to ignore cellular status changes.

* Fully-bridged and tested to work in Swift.

## Minimum Requirements

* iOS 11.0 

* tvOS 11.0 

* macOS 10.13

* Xcode 14.0

## Installation Instructions

	CocoaPods

	


	
pod 'TOReachability'


	Carthage

	


	
github "TimOliver/TOReachability"


	Manual Installation

	


	Simply move the `TOReachability` folder to your Xcode project and import it.

## Sample Code

### Objective-C

```objc

TOReachability *reachability = [[TOReachability alloc] init];

reachability.statusChangedHandler = ^(TOReachability *reachability,

					TOReachabilityStatus newStatus,

					TOReachabilityStatus oldStatus) {

        NSLog(@"Network Status Changed!");

};

[reachability start];

```

### Swift

```swift

let reachability = Reachability()

reachability.statusChangedHandler = { reachability, newStatus, oldStatus in

    print("Network Status Changed!")

}

reachability.start()

```

## Credits

Developed by [Tim Oliver](http://twitter.com/TimOliverAU) as a component for [iComics](http://icomics.co).

Device mockup by [Mockups Design](https://mockups-design.com/).

## License

`TOReachability` is licensed under the MIT License, please see the [LICENSE](LICENSE) file.