api: Remove unnecessary API key details.

Fixes #1.
This commit is contained in:
derAnfaenger 2017-08-25 11:03:06 +02:00 committed by Tim Abbott
parent 9d683e4669
commit 86729a862c
14 changed files with 44 additions and 41 deletions

View file

@ -29,7 +29,9 @@ usage = """create-user --new-email=<email address> --new-password=<password> --n
Create a user. You must be a realm admin to use this API, and the user Create a user. You must be a realm admin to use this API, and the user
will be created in your realm. will be created in your realm.
Example: create-user --site=http://localhost:9991 --user=rwbarton@example.com --new-email=jarthur@example.com --new-password=random17 --new-full-name 'J. Arthur Random' --new-short-name='jarthur' Example: create-user --new-email=jarthur@example.com --new-password=random17 --new-full-name 'J. Arthur Random' --new-short-name='jarthur'
Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -24,13 +24,13 @@
from __future__ import print_function from __future__ import print_function
import argparse import argparse
usage = """edit-message [options] --message=<msg_id> --subject=<new subject> --content=<new content> --user=<sender's email address> --api-key=<sender's api key> usage = """edit-message [options] --message=<msg_id> --subject=<new subject> --content=<new content>
Edits a message that you sent Edits a message that you sent
Example: edit-message --message-id="348135" --subject="my subject" --content="test message" --user=othello-bot@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 Example: edit-message --message-id="348135" --subject="my subject" --content="test message"
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -24,13 +24,13 @@
from __future__ import print_function from __future__ import print_function
import argparse import argparse
usage = """get-public-streams --user=<bot's email address> --api-key=<bot's api key> [options] usage = """get-public-streams [options]
Prints out all the public streams in the realm. Prints out all the public streams in the realm.
Example: get-public-streams --user=othello-bot@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 Example: get-public-streams
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -24,11 +24,13 @@
from __future__ import print_function from __future__ import print_function
import argparse import argparse
usage = """list-members --user=<bot's email address> --api-key=<bot's api key> [options] usage = """list-members [options]
List the names and e-mail addresses of the people in your realm. List the names and e-mail addresses of the people in your realm.
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Example: list-members
Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -24,13 +24,13 @@
from __future__ import print_function from __future__ import print_function
import argparse import argparse
usage = """list-subscriptions --user=<bot's email address> --api-key=<bot's api key> [options] usage = """list-subscriptions [options]
Prints out a list of the user's subscriptions. Prints out a list of the user's subscriptions.
Example: list-subscriptions --user=username@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 Example: list-subscriptions
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -26,13 +26,13 @@ import argparse
from typing import Any, Dict from typing import Any, Dict
usage = """print-events --user=<bot's email address> --api-key=<bot's api key> [options] usage = """print-events [options]
Prints out certain events received by the indicated bot or user matching the filter below. Prints out certain events received by the indicated bot or user matching the filter below.
Example: print-events --user=username@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 Example: print-events
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -26,13 +26,13 @@ import argparse
from typing import Any, Dict from typing import Any, Dict
usage = """print-messages --user=<bot's email address> --api-key=<bot's api key> [options] usage = """print-messages [options]
Prints out each message received by the indicated bot or user. Prints out each message received by the indicated bot or user.
Example: print-messages --user=username@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 Example: print-messages
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -25,13 +25,13 @@ from __future__ import print_function
import json import json
import argparse import argparse
usage = """recent-messages [options] --count=<no. of previous messages> --user=<sender's email address> --api-key=<sender's api key> usage = """recent-messages [options] --count=<no. of previous messages>
Prints out last count messages received by the indicated bot or user Prints out last count messages received by the bot or user used for authentication.
Example: recent-messages --count=101 --user=username@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 Example: recent-messages --count=101
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -25,14 +25,14 @@ from __future__ import print_function
import sys import sys
import argparse import argparse
usage = """subscribe --user=<bot's email address> --api-key=<bot's api key> [options] --streams=<streams> usage = """subscribe [options] --streams=<streams>
Ensures the user is subscribed to the listed streams. Ensures the user is subscribed to the listed streams.
Examples: subscribe --user=username@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 --streams=foo Examples: subscribe --streams=foo
subscribe --user=username@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 --streams='foo bar' subscribe --streams='foo bar'
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -25,14 +25,14 @@ from __future__ import print_function
import sys import sys
import argparse import argparse
usage = """unsubscribe --user=<bot's email address> --api-key=<bot's api key> [options] --streams=<streams> usage = """unsubscribe [options] --streams=<streams>
Ensures the user is not subscribed to the listed streams. Ensures the user is not subscribed to the listed streams.
Examples: unsubscribe --user=username@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 --streams=foo Examples: unsubscribe --streams=foo
unsubscribe --user=username@example.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 --streams='foo bar' unsubscribe --streams='foo bar'
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
""" """
import zulip import zulip

View file

@ -31,13 +31,13 @@ import zulip
class StringIO(_StringIO): class StringIO(_StringIO):
name = '' # https://github.com/python/typeshed/issues/598 name = '' # https://github.com/python/typeshed/issues/598
usage = """upload-file --user=<user's email address> --api-key=<user's api key> [options] usage = """upload-file [options]
Upload a file, and print the corresponding URI. Upload a file, and print the corresponding URI.
Example: upload-file --user=cordelia@zulip.com --api-key=a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 --file-path=cat.png Example: upload-file --file-path=cat.png
You can omit --user and --api-key arguments if you have a properly set up ~/.zuliprc Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
If no --file-path is specified, a placeholder text file will be used instead. If no --file-path is specified, a placeholder text file will be used instead.
""" """

View file

@ -42,12 +42,12 @@ sys.path.append(os.path.dirname(__file__))
parser = zulip.add_default_arguments(argparse.ArgumentParser(r""" parser = zulip.add_default_arguments(argparse.ArgumentParser(r"""
google-calendar \ google-calendar --calendar calendarID@example.calendar.google.com
--user foo@zulip.com \
--calendar calendarID@example.calendar.google.com
This integration can be used to send yourself reminders, on Zulip, of Google Calendar Events. This integration can be used to send yourself reminders, on Zulip, of Google Calendar Events.
Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
Before running this integration make sure you run the get-google-credentials file to give Zulip Before running this integration make sure you run the get-google-credentials file to give Zulip
access to certain aspects of your Google Account. access to certain aspects of your Google Account.

View file

@ -106,13 +106,13 @@ class IRCBot(irc.bot.SingleServerIRCBot):
return return
self.dcc_connect(address, port) self.dcc_connect(address, port)
usage = """./irc-mirror.py --server=IRC_SERVER --channel=<CHANNEL> --nick-prefix=<NICK> [optional args] usage = """./irc-mirror.py --irc-server=IRC_SERVER --channel=<CHANNEL> --nick-prefix=<NICK> [optional args]
Example: Example:
./irc-mirror.py --irc-server=127.0.0.1 --channel='#test' --nick-prefix=username ./irc-mirror.py --irc-server=127.0.0.1 --channel='#test' --nick-prefix=username
--site=https://zulip.example.com --user=irc-bot@example.com
--api-key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
Note that "_zulip" will be automatically appended to the IRC nick provided Note that "_zulip" will be automatically appended to the IRC nick provided

View file

@ -60,8 +60,7 @@ def main():
Examples: zulip-send --stream denmark --subject castle -m "Something is rotten in the state of Denmark." Examples: zulip-send --stream denmark --subject castle -m "Something is rotten in the state of Denmark."
zulip-send hamlet@example.com cordelia@example.com -m "Conscience doth make cowards of us all." zulip-send hamlet@example.com cordelia@example.com -m "Conscience doth make cowards of us all."
These examples assume you have a proper '~/.zuliprc'. You may also set your credentials with the Specify your Zulip API credentials and server in a ~/.zuliprc file or using the options.
'--user' and '--api-key' arguments.
""" """
parser = zulip.add_default_arguments(argparse.ArgumentParser(usage=usage)) parser = zulip.add_default_arguments(argparse.ArgumentParser(usage=usage))