add_item_to_keychain	# Adds the credentials to the keychain on behalf of the user

add_item_to_keychain(
      item_name: "personal-access-token", # Item name to be stored in the keychain
      account_name: "username", # An account name associated with the keychain item
      password: ENV["PERSONAL_ACCESS_TOKEN"] # Password to be stored in the keychain
    )

remove_item_from_keychain	# Removes the credentials from the keychain on behalf of the user

remove_item_from_keychain(
      item_name: "personal-access-token", # Item name to be removed from the keychain
    )

read_item_from_keychain	# Reads the password from the keychain for a given item

read_item_from_keychain(
      item_name: "personal-access-token", # Item name for a given password stored in the keychain
    )

lane :request_3rd_party_API do
    password = read_item_from_keychain(
        item_name: PERSONAL_ACCESS_TOKEN
    )

    if password
        # You can use your password here
    else
        # The password for a given item has not been found in the keychain. Request a user to provide the password. 
        UI.message 'Falstlane will talk to the 3rd party service on your behalf. In order to do so, it needs a personal access token. It will ask about it only once and store it in the keychain. Please provide your token 🙏🏻'

        # Since `password` field is non-optional, Fastlane will ask to provide it via a user input. 
        password = add_item_to_keychain(
            item_name: PERSONAL_ACCESS_TOKEN,
            account_name: ENV["USER"]
        )

        # Now you can read a password successfully. 
    end
end