Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/nixzhu/Proposer

Make permission request easier.
https://github.com/nixzhu/Proposer

Last synced: about 2 months ago
JSON representation

Make permission request easier.

Lists

README 

        









# Proposer



Proposer provides a single API to request permission for access **Camera**, **Photos**, **Microphone**, **Contacts**, **Reminders**, **Calendar**, **Location** or **Notifications**.



## Requirements



Swift 4.2, iOS 9.0



(Swift 3, use version 1.1.0)



## Example



Only one single API:



```swift

proposeToAccess(_:agreed:rejected:)

```



In real world:



```swift

import Proposer

```



```swift

@IBAction func choosePhoto() {

    let photos: PrivateResource = .photos

    let propose: Propose = {

        proposeToAccess(photos, agreed: {

            print("I can access Photos. :]\n")

            if UIImagePickerController.isSourceTypeAvailable(.savedPhotosAlbum) {

                let imagePicker = UIImagePickerController()

                imagePicker.sourceType = .savedPhotosAlbum

                self.present(imagePicker, animated: true, completion: nil)

            }

        }, rejected: {

            self.alertNoPermissionToAccess(photos)

        })

    }

    showProposeMessageIfNeedFor(photos, andTryPropose: propose)

}

```



When you want to get user's location, thanks to Swift's enum, you can even choose the usage mode:



```swift

@IBAction func shareLocation() {

    let location: PrivateResource = .location(.whenInUse)

    let propose: Propose = {

        proposeToAccess(location, agreed: {

            print("I can access Location. :]\n")

        }, rejected: {

            self.alertNoPermissionToAccess(location)

        })

    }

    showProposeMessageIfNeedFor(location, andTryPropose: propose)

}

```



Depending on your needs, you must add a `NSLocationWhenInUseUsageDescription` or `NSLocationAlwaysUsageDescription` to your Info.plist



See the demo for more information.



I recommend you add a `UIViewController+Proposer.swift` file (like the demo) for show localized alert before the first proposal or when propose failed.



## Installation



Feel free to drag `Proposer.swift` to your iOS Project. But it's recommended to use Carthage (or CocoaPods).



### Carthage



```ogdl

github "nixzhu/Proposer"

```



#### CocoaPods



```ruby

pod 'Proposer'

```



# Contact



NIX [@nixzhu](https://twitter.com/nixzhu)



## License



Proposer is available under the MIT license. See the LICENSE file for more info.