--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2009-2019, Joshua Roesslein
+# This file is distributed under the same license as the tweepy package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: tweepy 3.8.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-11-15 19:26+0900\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.7.0\n"
+
+#: ../../api.rst:6
+msgid "API Reference"
+msgstr ""
+
+#: ../../api.rst:8
+msgid "This page contains some basic documentation for the Tweepy module."
+msgstr ""
+
+#: ../../api.rst:12
+msgid ":mod:`tweepy.api` --- Twitter API wrapper"
+msgstr ""
+
+#: ../../api.rst:22
+msgid ""
+"This class provides a wrapper for the API as provided by Twitter. The "
+"functions provided in this class are listed below."
+msgstr ""
+
+#: ../../api.rst
+msgid "Parameters"
+msgstr ""
+
+#: ../../api.rst:25
+msgid "authentication handler to be used"
+msgstr ""
+
+#: ../../api.rst:26
+msgid "general API host"
+msgstr ""
+
+#: ../../api.rst:27
+msgid "search API host"
+msgstr ""
+
+#: ../../api.rst:28
+msgid "cache backend to use"
+msgstr ""
+
+#: ../../api.rst:29
+msgid "general API path root"
+msgstr ""
+
+#: ../../api.rst:30
+msgid "search API path root"
+msgstr ""
+
+#: ../../api.rst:31
+msgid "default number of retries to attempt when error occurs"
+msgstr ""
+
+#: ../../api.rst:32
+msgid "number of seconds to wait between retries"
+msgstr ""
+
+#: ../../api.rst:33
+msgid "which HTTP status codes to retry"
+msgstr ""
+
+#: ../../api.rst:34
+msgid "The maximum amount of time to wait for a response from Twitter"
+msgstr ""
+
+#: ../../api.rst:36
+msgid "The object to use for parsing the response from Twitter"
+msgstr ""
+
+#: ../../api.rst:37
+msgid "Whether or not to use GZIP compression for requests"
+msgstr ""
+
+#: ../../api.rst:38
+msgid "Whether or not to automatically wait for rate limits to replenish"
+msgstr ""
+
+#: ../../api.rst:40
+msgid ""
+"Whether or not to print a notification when Tweepy is waiting for rate "
+"limits to replenish"
+msgstr ""
+
+#: ../../api.rst:43
+msgid "The full url to an HTTPS proxy to use for connecting to Twitter."
+msgstr ""
+
+#: ../../api.rst:48
+msgid "Timeline methods"
+msgstr ""
+
+#: ../../api.rst:52
+msgid ""
+"Returns the 20 most recent statuses, including retweets, posted by the "
+"authenticating user and that user's friends. This is the equivalent of "
+"/timeline/home on the Web."
+msgstr ""
+
+#: ../../api.rst:56 ../../api.rst:89 ../../api.rst:101 ../../api.rst:112
+#: ../../api.rst:877
+msgid "|since_id|"
+msgstr ""
+
+#: ../../api.rst:57 ../../api.rst:90 ../../api.rst:102 ../../api.rst:113
+#: ../../api.rst:766 ../../api.rst:878
+msgid "|max_id|"
+msgstr ""
+
+#: ../../api.rst:58 ../../api.rst:91 ../../api.rst:103 ../../api.rst:114
+#: ../../api.rst:315 ../../api.rst:330 ../../api.rst:395 ../../api.rst:757
+#: ../../api.rst:848 ../../api.rst:861 ../../api.rst:879 ../../api.rst:1026
+msgid "|count|"
+msgstr ""
+
+#: ../../api.rst:59 ../../api.rst:92 ../../api.rst:104 ../../api.rst:374
+#: ../../api.rst:560 ../../api.rst:611
+msgid "|page|"
+msgstr ""
+
+#: ../../api.rst
+msgid "Return type"
+msgstr ""
+
+#: ../../api.rst:60 ../../api.rst:76 ../../api.rst:93 ../../api.rst:105
+#: ../../api.rst:115 ../../api.rst:274 ../../api.rst:561 ../../api.rst:885
+msgid "list of :class:`Status` objects"
+msgstr ""
+
+#: ../../api.rst:66
+msgid ""
+"Returns full Tweet objects for up to 100 tweets per request, specified by"
+" the ``id_`` parameter."
+msgstr ""
+
+#: ../../api.rst:69
+msgid "A list of Tweet IDs to lookup, up to 100"
+msgstr ""
+
+#: ../../api.rst:70 ../../api.rst:133 ../../api.rst:357 ../../api.rst:502
+#: ../../api.rst:651 ../../api.rst:767 ../../api.rst:880 ../../api.rst:1027
+msgid "|include_entities|"
+msgstr ""
+
+#: ../../api.rst:71 ../../api.rst:128 ../../api.rst:199
+msgid "|trim_user|"
+msgstr ""
+
+#: ../../api.rst:72
+msgid ""
+"A boolean indicating whether or not to include tweets that cannot be "
+"shown. Defaults to False."
+msgstr ""
+
+#: ../../api.rst:74 ../../api.rst:134
+msgid "|include_ext_alt_text|"
+msgstr ""
+
+#: ../../api.rst:75 ../../api.rst:135
+msgid "|include_card_uri|"
+msgstr ""
+
+#: ../../api.rst:82
+msgid ""
+"Returns the 20 most recent statuses posted from the authenticating user "
+"or the user specified. It's also possible to request another user's "
+"timeline via the id parameter."
+msgstr ""
+
+#: ../../api.rst:86 ../../api.rst:292 ../../api.rst:311 ../../api.rst:326
+#: ../../api.rst:441 ../../api.rst:453 ../../api.rst:476 ../../api.rst:487
+#: ../../api.rst:590 ../../api.rst:601 ../../api.rst:630 ../../api.rst:640
+#: ../../api.rst:672
+msgid "|uid|"
+msgstr ""
+
+#: ../../api.rst:87 ../../api.rst:293 ../../api.rst:312 ../../api.rst:327
+#: ../../api.rst:443 ../../api.rst:455 ../../api.rst:478 ../../api.rst:489
+#: ../../api.rst:592 ../../api.rst:603 ../../api.rst:632 ../../api.rst:642
+#: ../../api.rst:674 ../../api.rst:828 ../../api.rst:843 ../../api.rst:859
+#: ../../api.rst:909 ../../api.rst:941 ../../api.rst:986 ../../api.rst:1040
+msgid "|user_id|"
+msgstr ""
+
+#: ../../api.rst:88 ../../api.rst:294 ../../api.rst:313 ../../api.rst:328
+#: ../../api.rst:442 ../../api.rst:454 ../../api.rst:477 ../../api.rst:488
+#: ../../api.rst:591 ../../api.rst:602 ../../api.rst:631 ../../api.rst:641
+#: ../../api.rst:673 ../../api.rst:827 ../../api.rst:842 ../../api.rst:858
+#: ../../api.rst:908 ../../api.rst:940 ../../api.rst:985 ../../api.rst:1039
+msgid "|screen_name|"
+msgstr ""
+
+#: ../../api.rst:98
+msgid ""
+"Returns the 20 most recent tweets of the authenticated user that have "
+"been retweeted by others."
+msgstr ""
+
+#: ../../api.rst:110
+msgid "Returns the 20 most recent mentions, including retweets."
+msgstr ""
+
+#: ../../api.rst:119
+msgid "Status methods"
+msgstr ""
+
+#: ../../api.rst:125
+msgid "Returns a single status specified by the ID parameter."
+msgstr ""
+
+#: ../../api.rst:127 ../../api.rst:245 ../../api.rst:253 ../../api.rst:262
+#: ../../api.rst:272 ../../api.rst:281 ../../api.rst:569 ../../api.rst:578
+msgid "|sid|"
+msgstr ""
+
+#: ../../api.rst:129
+msgid ""
+"A boolean indicating if any Tweets returned that have been retweeted by "
+"the authenticating user should include an additional current_user_retweet"
+" node, containing the ID of the source status for the retweet."
+msgstr ""
+
+#: ../../api.rst:136 ../../api.rst:209 ../../api.rst:237 ../../api.rst:246
+#: ../../api.rst:254 ../../api.rst:282 ../../api.rst:570 ../../api.rst:579
+msgid ":class:`Status` object"
+msgstr ""
+
+#: ../../api.rst:147
+msgid "Updates the authenticating user's current status, also known as Tweeting."
+msgstr ""
+
+#: ../../api.rst:149
+msgid ""
+"For each update attempt, the update text is compared with the "
+"authenticating user's recent Tweets. Any attempt that would result in "
+"duplication will be blocked, resulting in a 403 error. A user cannot "
+"submit the same status twice in a row."
+msgstr ""
+
+#: ../../api.rst:154
+msgid ""
+"While not rate limited by the API, a user is limited in the number of "
+"Tweets they can create at a time. If the number of updates posted by the "
+"user reaches the current allowed limit this method will return an HTTP "
+"403 error."
+msgstr ""
+
+#: ../../api.rst:158 ../../api.rst:223
+msgid "The text of your status update."
+msgstr ""
+
+#: ../../api.rst:159
+msgid ""
+"The ID of an existing status that the update is in reply to. Note: This "
+"parameter will be ignored unless the author of the Tweet this parameter "
+"references is mentioned within the status text. Therefore, you must "
+"include @username, where username is the author of the referenced Tweet, "
+"within the update."
+msgstr ""
+
+#: ../../api.rst:164
+msgid ""
+"If set to true and used with in_reply_to_status_id, leading @mentions "
+"will be looked up from the original Tweet, and added to the new Tweet "
+"from there. This wil append @mentions into the metadata of an extended "
+"Tweet as a reply chain grows, until the limit on @mentions is reached. In"
+" cases where the original Tweet has been deleted, the reply will fail."
+msgstr ""
+
+#: ../../api.rst:170
+msgid ""
+"When used with auto_populate_reply_metadata, a comma-separated list of "
+"user ids which will be removed from the server-generated @mentions prefix"
+" on an extended Tweet. Note that the leading @mention cannot be removed "
+"as it would break the in-reply-to-status-id semantics. Attempting to "
+"remove it will be silently ignored."
+msgstr ""
+
+#: ../../api.rst:176
+msgid ""
+"In order for a URL to not be counted in the status body of an extended "
+"Tweet, provide a URL as a Tweet attachment. This URL must be a Tweet "
+"permalink, or Direct Message deep link. Arbitrary, non-Twitter URLs must "
+"remain in the status text. URLs passed to the attachment_url parameter "
+"not matching either a Tweet permalink or Direct Message deep link will "
+"fail at Tweet creation and cause an exception."
+msgstr ""
+
+#: ../../api.rst:182
+msgid ""
+"A list of media_ids to associate with the Tweet. You may include up to 4 "
+"photos or 1 animated GIF or 1 video in a Tweet."
+msgstr ""
+
+#: ../../api.rst:184
+msgid ""
+"If you upload Tweet media that might be considered sensitive content such"
+" as nudity, or medical procedures, you must set this value to true."
+msgstr ""
+
+#: ../../api.rst:187
+msgid ""
+"The latitude of the location this Tweet refers to. This parameter will be"
+" ignored unless it is inside the range -90.0 to +90.0 (North is positive)"
+" inclusive. It will also be ignored if there is no corresponding long "
+"parameter."
+msgstr ""
+
+#: ../../api.rst:191
+msgid ""
+"The longitude of the location this Tweet refers to. The valid ranges for "
+"longitude are -180.0 to +180.0 (East is positive) inclusive. This "
+"parameter will be ignored if outside that range, if it is not a number, "
+"if geo_enabled is disabled, or if there no corresponding lat parameter."
+msgstr ""
+
+#: ../../api.rst:196
+msgid "A place in the world."
+msgstr ""
+
+#: ../../api.rst:197
+msgid ""
+"Whether or not to put a pin on the exact coordinates a Tweet has been "
+"sent from."
+msgstr ""
+
+#: ../../api.rst:200
+msgid ""
+"When set to true, enables shortcode commands for sending Direct Messages "
+"as part of the status text to send a Direct Message to a user. When set "
+"to false, disables this behavior and includes any leading characters in "
+"the status text that is posted"
+msgstr ""
+
+#: ../../api.rst:204
+msgid ""
+"When set to true, causes any status text that starts with shortcode "
+"commands to return an API error. When set to false, allows shortcode "
+"commands to be sent in the status text and acted on by the API."
+msgstr ""
+
+#: ../../api.rst:207
+msgid ""
+"Associate an ads card with the Tweet using the card_uri value from any "
+"ads card response."
+msgstr ""
+
+#: ../../api.rst:217
+msgid ""
+"*Deprecated*: Use :func:`API.media_upload` instead. Update the "
+"authenticated user's status. Statuses that are duplicates or too long "
+"will be silently ignored."
+msgstr ""
+
+#: ../../api.rst:221
+msgid ""
+"The filename of the image to upload. This will automatically be opened "
+"unless `file` is specified"
+msgstr ""
+
+#: ../../api.rst:224
+msgid "The ID of an existing status that the update is in reply to."
+msgstr ""
+
+#: ../../api.rst:226
+msgid "Whether to automatically include the @mentions in the status metadata."
+msgstr ""
+
+#: ../../api.rst:228
+msgid "The location's latitude that this tweet refers to."
+msgstr ""
+
+#: ../../api.rst:229
+msgid "The location's longitude that this tweet refers to."
+msgstr ""
+
+#: ../../api.rst:230
+msgid ""
+"Source of the update. Only supported by Identi.ca. Twitter ignores this "
+"parameter."
+msgstr ""
+
+#: ../../api.rst:232
+msgid ""
+"Twitter ID of location which is listed in the Tweet if geolocation is "
+"enabled for the user."
+msgstr ""
+
+#: ../../api.rst:234
+msgid ""
+"A file object, which will be used instead of opening `filename`. "
+"`filename` is still required, for MIME type detection and to use as a "
+"form field in the POST data"
+msgstr ""
+
+#: ../../api.rst:242
+msgid ""
+"Destroy the status specified by the id parameter. The authenticated user "
+"must be the author of the status to destroy."
+msgstr ""
+
+#: ../../api.rst:251
+msgid "Retweets a tweet. Requires the id of the tweet you are retweeting."
+msgstr ""
+
+#: ../../api.rst:259
+msgid ""
+"Returns up to 100 user IDs belonging to users who have retweeted the "
+"Tweet specified by the id parameter."
+msgstr ""
+
+#: ../../api.rst:263 ../../api.rst:314 ../../api.rst:329 ../../api.rst:396
+#: ../../api.rst:479 ../../api.rst:490 ../../api.rst:619 ../../api.rst:650
+#: ../../api.rst:660 ../../api.rst:847 ../../api.rst:860 ../../api.rst:974
+#: ../../api.rst:1025
+msgid "|cursor|"
+msgstr ""
+
+#: ../../api.rst:264
+msgid "Have ids returned as strings instead."
+msgstr ""
+
+#: ../../api.rst:270
+msgid "Returns up to 100 of the first retweets of the given tweet."
+msgstr ""
+
+#: ../../api.rst:273
+msgid "Specifies the number of retweets to retrieve."
+msgstr ""
+
+#: ../../api.rst:279
+msgid "Untweets a retweeted status. Requires the id of the retweet to unretweet."
+msgstr ""
+
+#: ../../api.rst:286
+msgid "User methods"
+msgstr ""
+
+#: ../../api.rst:290
+msgid "Returns information about the specified user."
+msgstr ""
+
+#: ../../api.rst:295 ../../api.rst:302 ../../api.rst:446 ../../api.rst:456
+#: ../../api.rst:526 ../../api.rst:535 ../../api.rst:548 ../../api.rst:593
+#: ../../api.rst:604 ../../api.rst:633 ../../api.rst:643 ../../api.rst:677
+msgid ":class:`User` object"
+msgstr ""
+
+#: ../../api.rst:300
+msgid "Returns the authenticated user's information."
+msgstr ""
+
+#: ../../api.rst:308
+msgid ""
+"Returns an user's friends ordered in which they were added 100 at a time."
+" If no user is specified it defaults to the authenticated user."
+msgstr ""
+
+#: ../../api.rst:316 ../../api.rst:331 ../../api.rst:503 ../../api.rst:652
+#: ../../api.rst:1028
+msgid "|skip_status|"
+msgstr ""
+
+#: ../../api.rst:317 ../../api.rst:332
+msgid "|include_user_entities|"
+msgstr ""
+
+#: ../../api.rst:318 ../../api.rst:333 ../../api.rst:361 ../../api.rst:375
+#: ../../api.rst:612 ../../api.rst:653 ../../api.rst:975 ../../api.rst:1029
+msgid "list of :class:`User` objects"
+msgstr ""
+
+#: ../../api.rst:323
+msgid ""
+"Returns a user's followers ordered in which they were added. If no user "
+"is specified by id/screen name, it defaults to the authenticated user."
+msgstr ""
+
+#: ../../api.rst:339
+msgid "Returns fully-hydrated user objects for up to 100 users per request."
+msgstr ""
+
+#: ../../api.rst:341
+msgid "There are a few things to note when using this method."
+msgstr ""
+
+#: ../../api.rst:343
+msgid ""
+"You must be following a protected user to be able to see their most "
+"recent status update. If you don't follow a protected user their status "
+"will be removed."
+msgstr ""
+
+#: ../../api.rst:346
+msgid ""
+"The order of user IDs or screen names may not match the order of users in"
+" the returned array."
+msgstr ""
+
+#: ../../api.rst:348
+msgid ""
+"If a requested user is unknown, suspended, or deleted, then that user "
+"will not be returned in the results list."
+msgstr ""
+
+#: ../../api.rst:350
+msgid ""
+"If none of your lookup criteria can be satisfied by returning a user "
+"object, a HTTP 404 will be thrown."
+msgstr ""
+
+#: ../../api.rst:353
+msgid "A list of user IDs, up to 100 are allowed in a single request."
+msgstr ""
+
+#: ../../api.rst:355
+msgid "A list of screen names, up to 100 are allowed in a single request."
+msgstr ""
+
+#: ../../api.rst:358
+msgid ""
+"Valid request values are compat and extended, which give compatibility "
+"mode and extended mode, respectively for Tweets that contain over 140 "
+"characters."
+msgstr ""
+
+#: ../../api.rst:366
+msgid ""
+"Run a search for users similar to Find People button on Twitter.com; the "
+"same results returned by people search on Twitter.com will be returned by"
+" using this API (about being listed in the People Search). It is only "
+"possible to retrieve the first 1000 matches from this API."
+msgstr ""
+
+#: ../../api.rst:371
+msgid "The query to run against people search."
+msgstr ""
+
+#: ../../api.rst:372
+msgid "Specifies the number of statuses to retrieve. May not be greater than 20."
+msgstr ""
+
+#: ../../api.rst:379
+msgid "Direct Message Methods"
+msgstr ""
+
+#: ../../api.rst:383
+msgid "Returns a specific direct message."
+msgstr ""
+
+#: ../../api.rst:385
+msgid "|id|"
+msgstr ""
+
+#: ../../api.rst:386
+msgid "|full_text|"
+msgstr ""
+
+#: ../../api.rst:387 ../../api.rst:419
+msgid ":class:`DirectMessage` object"
+msgstr ""
+
+#: ../../api.rst:392
+msgid ""
+"Returns all Direct Message events (both sent and received) within the "
+"last 30 days. Sorted in reverse-chronological order."
+msgstr ""
+
+#: ../../api.rst:397
+msgid "list of :class:`DirectMessage` objects"
+msgstr ""
+
+#: ../../api.rst:403
+msgid ""
+"Sends a new direct message to the specified user from the authenticating "
+"user."
+msgstr ""
+
+#: ../../api.rst:406
+msgid "The ID of the user who should receive the direct message."
+msgstr ""
+
+#: ../../api.rst:408
+msgid "The text of your Direct Message. Max length of 10,000 characters."
+msgstr ""
+
+#: ../../api.rst:410
+msgid ""
+"The Quick Reply type to present to the user: * options - Array of "
+"Options objects (20 max). * text_input - Text Input object. * location - "
+"Location object."
+msgstr ""
+
+#: ../../api.rst:410
+msgid "The Quick Reply type to present to the user:"
+msgstr ""
+
+#: ../../api.rst:412
+msgid "options - Array of Options objects (20 max)."
+msgstr ""
+
+#: ../../api.rst:413
+msgid "text_input - Text Input object."
+msgstr ""
+
+#: ../../api.rst:414
+msgid "location - Location object."
+msgstr ""
+
+#: ../../api.rst:415
+msgid "The attachment type. Can be media or location."
+msgstr ""
+
+#: ../../api.rst:416
+msgid ""
+"A media id to associate with the message. A Direct Message may only "
+"reference a single media_id."
+msgstr ""
+
+#: ../../api.rst:424
+msgid ""
+"Deletes the direct message specified in the required ID parameter. The "
+"authenticating user must be the recipient of the specified direct "
+"message. Direct Messages are only removed from the interface of the user "
+"context provided. Other members of the conversation can still access the "
+"Direct Messages."
+msgstr ""
+
+#: ../../api.rst:430
+msgid "The id of the Direct Message that should be deleted."
+msgstr ""
+
+#: ../../api.rst:435
+msgid "Friendship Methods"
+msgstr ""
+
+#: ../../api.rst:439
+msgid "Create a new friendship with the specified user (aka follow)."
+msgstr ""
+
+#: ../../api.rst:444
+msgid "Enable notifications for the target user in addition to becoming friends."
+msgstr ""
+
+#: ../../api.rst:451
+msgid "Destroy a friendship with the specified user (aka unfollow)."
+msgstr ""
+
+#: ../../api.rst:462
+msgid "Returns detailed information about the relationship between two users."
+msgstr ""
+
+#: ../../api.rst:464
+msgid "The user_id of the subject user."
+msgstr ""
+
+#: ../../api.rst:465
+msgid "The screen_name of the subject user."
+msgstr ""
+
+#: ../../api.rst:466
+msgid "The user_id of the target user."
+msgstr ""
+
+#: ../../api.rst:467
+msgid "The screen_name of the target user."
+msgstr ""
+
+#: ../../api.rst:468
+msgid ":class:`Friendship` object"
+msgstr ""
+
+#: ../../api.rst:473
+msgid ""
+"Returns an array containing the IDs of users being followed by the "
+"specified user."
+msgstr ""
+
+#: ../../api.rst:485
+msgid "Returns an array containing the IDs of users following the specified user."
+msgstr ""
+
+#: ../../api.rst:495
+msgid "Account Methods"
+msgstr ""
+
+#: ../../api.rst:500
+msgid "Verify the supplied user credentials are valid."
+msgstr ""
+
+#: ../../api.rst:504
+msgid "When set to true email will be returned in the user objects as a string."
+msgstr ""
+
+#: ../../api.rst:506
+msgid ":class:`User` object if credentials are valid, otherwise False"
+msgstr ""
+
+#: ../../api.rst:511
+msgid ""
+"Returns the current rate limits for methods belonging to the specified "
+"resource families. When using application-only auth, this method's "
+"response indicates the application-only auth rate limiting context."
+msgstr ""
+
+#: ../../api.rst:515
+msgid ""
+"A comma-separated list of resource families you want to know the current "
+"rate limit disposition for."
+msgstr ""
+
+#: ../../api.rst:517 ../../api.rst:1056 ../../api.rst:1080 ../../api.rst:1102
+msgid ":class:`JSON` object"
+msgstr ""
+
+#: ../../api.rst:522
+msgid ""
+"Update the authenticating user's profile image. Valid formats: GIF, JPG, "
+"or PNG"
+msgstr ""
+
+#: ../../api.rst:525 ../../api.rst:534
+msgid "local path to image file to upload. Not a remote URL!"
+msgstr ""
+
+#: ../../api.rst:531
+msgid ""
+"Update authenticating user's background image. Valid formats: GIF, JPG, "
+"or PNG"
+msgstr ""
+
+#: ../../api.rst:540
+msgid ""
+"Sets values that users are able to set under the \"Account\" tab of their"
+" settings page."
+msgstr ""
+
+#: ../../api.rst:543
+msgid "Maximum of 20 characters"
+msgstr ""
+
+#: ../../api.rst:544
+msgid ""
+"Maximum of 100 characters. Will be prepended with \"http://\" if not "
+"present"
+msgstr ""
+
+#: ../../api.rst:546
+msgid "Maximum of 30 characters"
+msgstr ""
+
+#: ../../api.rst:547
+msgid "Maximum of 160 characters"
+msgstr ""
+
+#: ../../api.rst:552
+msgid "Favorite Methods"
+msgstr ""
+
+#: ../../api.rst:556
+msgid ""
+"Returns the favorite statuses for the authenticating user or user "
+"specified by the ID parameter."
+msgstr ""
+
+#: ../../api.rst:559
+msgid "The ID or screen name of the user to request favorites"
+msgstr ""
+
+#: ../../api.rst:566
+msgid ""
+"Favorites the status specified in the ID parameter as the authenticating "
+"user."
+msgstr ""
+
+#: ../../api.rst:575
+msgid ""
+"Un-favorites the status specified in the ID parameter as the "
+"authenticating user."
+msgstr ""
+
+#: ../../api.rst:583
+msgid "Block Methods"
+msgstr ""
+
+#: ../../api.rst:587
+msgid ""
+"Blocks the user specified in the ID parameter as the authenticating user."
+" Destroys a friendship to the blocked user if it exists."
+msgstr ""
+
+#: ../../api.rst:598
+msgid ""
+"Un-blocks the user specified in the ID parameter for the authenticating "
+"user."
+msgstr ""
+
+#: ../../api.rst:609
+msgid "Returns an array of user objects that the authenticating user is blocking."
+msgstr ""
+
+#: ../../api.rst:617
+msgid "Returns an array of numeric user ids the authenticating user is blocking."
+msgstr ""
+
+#: ../../api.rst:624
+msgid "Mute Methods"
+msgstr ""
+
+#: ../../api.rst:628
+msgid "Mutes the user specified in the ID parameter for the authenticating user."
+msgstr ""
+
+#: ../../api.rst:638
+msgid ""
+"Un-mutes the user specified in the ID parameter for the authenticating "
+"user."
+msgstr ""
+
+#: ../../api.rst:648
+msgid "Returns an array of user objects the authenticating user has muted."
+msgstr ""
+
+#: ../../api.rst:658
+msgid "Returns an array of numeric user ids the authenticating user has muted."
+msgstr ""
+
+#: ../../api.rst:665
+msgid "Spam Reporting Methods"
+msgstr ""
+
+#: ../../api.rst:669
+msgid ""
+"The user specified in the id is blocked by the authenticated user and "
+"reported as a spammer."
+msgstr ""
+
+#: ../../api.rst:675
+msgid ""
+"A boolean indicating if the reported account should be blocked. Defaults "
+"to True."
+msgstr ""
+
+#: ../../api.rst:681
+msgid "Saved Searches Methods"
+msgstr ""
+
+#: ../../api.rst:685
+msgid "Returns the authenticated user's saved search queries."
+msgstr ""
+
+#: ../../api.rst:687
+msgid "list of :class:`SavedSearch` objects"
+msgstr ""
+
+#: ../../api.rst:692
+msgid ""
+"Retrieve the data for a saved search owned by the authenticating user "
+"specified by the given id."
+msgstr ""
+
+#: ../../api.rst:695
+msgid "The id of the saved search to be retrieved."
+msgstr ""
+
+#: ../../api.rst:696 ../../api.rst:704 ../../api.rst:713
+msgid ":class:`SavedSearch` object"
+msgstr ""
+
+#: ../../api.rst:701
+msgid "Creates a saved search for the authenticated user."
+msgstr ""
+
+#: ../../api.rst:703
+msgid "The query of the search the user would like to save."
+msgstr ""
+
+#: ../../api.rst:709
+msgid ""
+"Destroys a saved search for the authenticated user. The search specified "
+"by id must be owned by the authenticating user."
+msgstr ""
+
+#: ../../api.rst:712
+msgid "The id of the saved search to be deleted."
+msgstr ""
+
+#: ../../api.rst:717
+msgid "Help Methods"
+msgstr ""
+
+#: ../../api.rst:723
+msgid "Returns a collection of relevant Tweets matching a specified query."
+msgstr ""
+
+#: ../../api.rst:725
+msgid ""
+"Please note that Twitter's search service and, by extension, the Search "
+"API is not meant to be an exhaustive source of Tweets. Not all Tweets "
+"will be indexed or made available via the search interface."
+msgstr ""
+
+#: ../../api.rst:729
+msgid ""
+"In API v1.1, the response format of the Search API has been improved to "
+"return Tweet objects more similar to the objects you’ll find across the "
+"REST API and platform. However, perspectival attributes (fields that "
+"pertain to the perspective of the authenticating user) are not currently "
+"supported on this endpoint.\\ [#]_\\ [#]_"
+msgstr ""
+
+#: ../../api.rst:735
+msgid ""
+"the search query string of 500 characters maximum, including operators. "
+"Queries may additionally be limited by complexity."
+msgstr ""
+
+#: ../../api.rst:737
+msgid ""
+"Returns tweets by users located within a given radius of the given "
+"latitude/longitude. The location is preferentially taking from the "
+"Geotagging API, but will fall back to their Twitter profile. The "
+"parameter value is specified by \"latitide,longitude,radius\", where "
+"radius units must be specified as either \"mi\" (miles) or \"km\" "
+"(kilometers). Note that you cannot use the near operator via the API to "
+"geocode arbitrary locations; however you can use this geocode parameter "
+"to search near geocodes directly. A maximum of 1,000 distinct \"sub-"
+"regions\" will be considered when using the radius modifier."
+msgstr ""
+
+#: ../../api.rst:746
+msgid ""
+"Restricts tweets to the given language, given by an ISO 639-1 code. "
+"Language detection is best-effort."
+msgstr ""
+
+#: ../../api.rst:748
+msgid ""
+"Specify the language of the query you are sending (only ja is currently "
+"effective). This is intended for language-specific consumers and the "
+"default should work in the majority of cases."
+msgstr ""
+
+#: ../../api.rst:751
+msgid ""
+"Specifies what type of search results you would prefer to receive. The "
+"current default is \"mixed.\" Valid values include: * mixed : include "
+"both popular and real time results in the response * recent : return only"
+" the most recent results in the response * popular : return only the most"
+" popular results in the response"
+msgstr ""
+
+#: ../../api.rst:751
+msgid ""
+"Specifies what type of search results you would prefer to receive. The "
+"current default is \"mixed.\" Valid values include:"
+msgstr ""
+
+#: ../../api.rst:754
+msgid "mixed : include both popular and real time results in the response"
+msgstr ""
+
+#: ../../api.rst:755
+msgid "recent : return only the most recent results in the response"
+msgstr ""
+
+#: ../../api.rst:756
+msgid "popular : return only the most popular results in the response"
+msgstr ""
+
+#: ../../api.rst:758
+msgid ""
+"Returns tweets created before the given date. Date should be formatted as"
+" YYYY-MM-DD. Keep in mind that the search index has a 7-day limit. In "
+"other words, no tweets will be found for a date older than one week."
+msgstr ""
+
+#: ../../api.rst:762
+msgid ""
+"|since_id| There are limits to the number of Tweets which can be accessed"
+" through the API. If the limit of Tweets has occurred since the since_id,"
+" the since_id will be forced to the oldest ID available."
+msgstr ""
+
+#: ../../api.rst:768
+msgid ":class:`SearchResults` object"
+msgstr ""
+
+#: ../../api.rst:772
+msgid "List Methods"
+msgstr ""
+
+#: ../../api.rst:776
+msgid ""
+"Creates a new list for the authenticated user. Note that you can create "
+"up to 1000 lists per account."
+msgstr ""
+
+#: ../../api.rst:779
+msgid "The name of the new list."
+msgstr ""
+
+#: ../../api.rst:780 ../../api.rst:806
+msgid "|list_mode|"
+msgstr ""
+
+#: ../../api.rst:781
+msgid "The description of the list you are creating."
+msgstr ""
+
+#: ../../api.rst:782 ../../api.rst:794 ../../api.rst:810 ../../api.rst:897
+#: ../../api.rst:912 ../../api.rst:929 ../../api.rst:944 ../../api.rst:962
+#: ../../api.rst:1000 ../../api.rst:1011
+msgid ":class:`List` object"
+msgstr ""
+
+#: ../../api.rst:787
+msgid ""
+"Deletes the specified list. The authenticated user must own the list to "
+"be able to destroy it."
+msgstr ""
+
+#: ../../api.rst:790 ../../api.rst:808 ../../api.rst:876 ../../api.rst:896
+#: ../../api.rst:911 ../../api.rst:928 ../../api.rst:943 ../../api.rst:961
+#: ../../api.rst:973 ../../api.rst:988 ../../api.rst:999 ../../api.rst:1010
+#: ../../api.rst:1024 ../../api.rst:1042
+msgid "|owner_screen_name|"
+msgstr ""
+
+#: ../../api.rst:791 ../../api.rst:809 ../../api.rst:875 ../../api.rst:895
+#: ../../api.rst:910 ../../api.rst:927 ../../api.rst:942 ../../api.rst:960
+#: ../../api.rst:972 ../../api.rst:987 ../../api.rst:998 ../../api.rst:1009
+#: ../../api.rst:1023 ../../api.rst:1041
+msgid "|owner_id|"
+msgstr ""
+
+#: ../../api.rst:792 ../../api.rst:803 ../../api.rst:873 ../../api.rst:893
+#: ../../api.rst:906 ../../api.rst:921 ../../api.rst:938 ../../api.rst:954
+#: ../../api.rst:970 ../../api.rst:983 ../../api.rst:996 ../../api.rst:1007
+#: ../../api.rst:1021 ../../api.rst:1037
+msgid "|list_id|"
+msgstr ""
+
+#: ../../api.rst:793 ../../api.rst:804 ../../api.rst:874 ../../api.rst:894
+#: ../../api.rst:907 ../../api.rst:922 ../../api.rst:939 ../../api.rst:955
+#: ../../api.rst:971 ../../api.rst:984 ../../api.rst:997 ../../api.rst:1008
+#: ../../api.rst:1022 ../../api.rst:1038
+msgid "|slug|"
+msgstr ""
+
+#: ../../api.rst:800
+msgid ""
+"Updates the specified list. The authenticated user must own the list to "
+"be able to update it."
+msgstr ""
+
+#: ../../api.rst:805
+msgid "The name for the list."
+msgstr ""
+
+#: ../../api.rst:807
+msgid "The description to give the list."
+msgstr ""
+
+#: ../../api.rst:815
+msgid ""
+"Returns all lists the authenticating or specified user subscribes to, "
+"including their own. The user is specified using the ``user_id`` or "
+"``screen_name`` parameters. If no user is given, the authenticating user "
+"is used."
+msgstr ""
+
+#: ../../api.rst:820
+msgid ""
+"A maximum of 100 results will be returned by this call. Subscribed lists "
+"are returned first, followed by owned lists. This means that if a user "
+"subscribes to 90 lists and owns 20 lists, this method returns 90 "
+"subscriptions and 10 owned lists. The ``reverse`` method returns owned "
+"lists first, so with ``reverse=true``, 20 owned lists and 80 "
+"subscriptions would be returned."
+msgstr ""
+
+#: ../../api.rst:829
+msgid ""
+"A boolean indicating if you would like owned lists to be returned first. "
+"See description above for information on how this parameter works."
+msgstr ""
+
+#: ../../api.rst:832 ../../api.rst:849 ../../api.rst:862
+msgid "list of :class:`List` objects"
+msgstr ""
+
+#: ../../api.rst:838
+msgid ""
+"Returns the lists the specified user has been added to. If ``user_id`` or"
+" ``screen_name`` are not provided, the memberships for the authenticating"
+" user are returned."
+msgstr ""
+
+#: ../../api.rst:844
+msgid ""
+"A boolean indicating whether to return just lists the authenticating user"
+" owns, and the user represented by ``user_id`` or ``screen_name`` is a "
+"member of."
+msgstr ""
+
+#: ../../api.rst:855
+msgid ""
+"Obtain a collection of the lists the specified user is subscribed to, 20 "
+"lists per page by default. Does not include the user's own lists."
+msgstr ""
+
+#: ../../api.rst:869
+msgid ""
+"Returns a timeline of tweets authored by members of the specified list. "
+"Retweets are included by default. Use the ``include_rts=false`` parameter"
+" to omit retweets."
+msgstr ""
+
+#: ../../api.rst:881
+msgid ""
+"A boolean indicating whether the list timeline will contain native "
+"retweets (if they exist) in addition to the standard stream of tweets. "
+"The output format of retweeted tweets is identical to the representation "
+"you see in home_timeline."
+msgstr ""
+
+#: ../../api.rst:890
+msgid ""
+"Returns the specified list. Private lists will only be shown if the "
+"authenticated user owns the specified list."
+msgstr ""
+
+#: ../../api.rst:903
+msgid ""
+"Add a member to a list. The authenticated user must own the list to be "
+"able to add members to it. Lists are limited to 5,000 members."
+msgstr ""
+
+#: ../../api.rst:918
+msgid ""
+"Add up to 100 members to a list. The authenticated user must own the list"
+" to be able to add members to it. Lists are limited to 5,000 members."
+msgstr ""
+
+#: ../../api.rst:923 ../../api.rst:956
+msgid ""
+"A comma separated list of screen names, up to 100 are allowed in a single"
+" request"
+msgstr ""
+
+#: ../../api.rst:925 ../../api.rst:958
+msgid ""
+"A comma separated list of user IDs, up to 100 are allowed in a single "
+"request"
+msgstr ""
+
+#: ../../api.rst:935
+msgid ""
+"Removes the specified member from the list. The authenticated user must "
+"be the list's owner to remove members from the list."
+msgstr ""
+
+#: ../../api.rst:950
+msgid ""
+"Remove up to 100 members from a list. The authenticated user must own the"
+" list to be able to remove members from it. Lists are limited to 5,000 "
+"members."
+msgstr ""
+
+#: ../../api.rst:968
+msgid "Returns the members of the specified list."
+msgstr ""
+
+#: ../../api.rst:981
+msgid "Check if the specified user is a member of the specified list."
+msgstr ""
+
+#: ../../api.rst:989
+msgid ":class:`User` object if user is a member of list"
+msgstr ""
+
+#: ../../api.rst:994
+msgid "Subscribes the authenticated user to the specified list."
+msgstr ""
+
+#: ../../api.rst:1005
+msgid "Unsubscribes the authenticated user from the specified list."
+msgstr ""
+
+#: ../../api.rst:1018
+msgid ""
+"Returns the subscribers of the specified list. Private list subscribers "
+"will only be shown if the authenticated user owns the specified list."
+msgstr ""
+
+#: ../../api.rst:1035
+msgid "Check if the specified user is a subscriber of the specified list."
+msgstr ""
+
+#: ../../api.rst:1043
+msgid ":class:`User` object if user is subscribed to list"
+msgstr ""
+
+#: ../../api.rst:1047
+msgid "Trends Methods"
+msgstr ""
+
+#: ../../api.rst:1051
+msgid ""
+"Returns the locations that Twitter has trending topic information for. "
+"The response is an array of \"locations\" that encode the location's "
+"WOEID (a Yahoo! Where On Earth ID) and some other human-readable "
+"information such as a canonical name and country the location belongs in."
+msgstr ""
+
+#: ../../api.rst:1061
+msgid ""
+"Returns the top 50 trending topics for a specific WOEID, if trending "
+"information is available for it."
+msgstr ""
+
+#: ../../api.rst:1064
+msgid ""
+"The response is an array of “trend” objects that encode the name of the "
+"trending topic, the query parameter that can be used to search for the "
+"topic on Twitter Search, and the Twitter Search URL."
+msgstr ""
+
+#: ../../api.rst:1068
+msgid ""
+"This information is cached for 5 minutes. Requesting more frequently than"
+" that will not return any more data, and will count against your rate "
+"limit usage."
+msgstr ""
+
+#: ../../api.rst:1072
+msgid ""
+"The tweet_volume for the last 24 hours is also returned for many trends "
+"if this is available."
+msgstr ""
+
+#: ../../api.rst:1075
+msgid ""
+"The Yahoo! Where On Earth ID of the location to return trending "
+"information for. Global information is available by using 1 as the WOEID."
+msgstr ""
+
+#: ../../api.rst:1078
+msgid ""
+"Setting this equal to hashtags will remove all hashtags from the trends "
+"list."
+msgstr ""
+
+#: ../../api.rst:1085
+msgid ""
+"Returns the locations that Twitter has trending topic information for, "
+"closest to a specified location."
+msgstr ""
+
+#: ../../api.rst:1088
+msgid ""
+"The response is an array of “locations” that encode the location’s WOEID "
+"and some other human-readable information such as a canonical name and "
+"country the location belongs in."
+msgstr ""
+
+#: ../../api.rst:1092
+msgid "A WOEID is a Yahoo! Where On Earth ID."
+msgstr ""
+
+#: ../../api.rst:1094
+msgid ""
+"If provided with a long parameter the available trend locations will be "
+"sorted by distance, nearest to furthest, to the co-ordinate pair. The "
+"valid ranges for longitude is -180.0 to +180.0 (West is negative, East is"
+" positive) inclusive."
+msgstr ""
+
+#: ../../api.rst:1098
+msgid ""
+"If provided with a lat parameter the available trend locations will be "
+"sorted by distance, nearest to furthest, to the co-ordinate pair. The "
+"valid ranges for longitude is -180.0 to +180.0 (West is negative, East is"
+" positive) inclusive."
+msgstr ""
+
+#: ../../api.rst:1106
+msgid "Geo Methods"
+msgstr ""
+
+#: ../../api.rst:1111
+msgid ""
+"Given a latitude and longitude, looks for places (cities and "
+"neighbourhoods) whose IDs can be specified in a call to "
+":func:`update_status` to appear as the name of the location. This call "
+"provides a detailed response about the location in question; the "
+":func:`nearby_places` function should be preferred for getting a list of "
+"places nearby without great detail."
+msgstr ""
+
+#: ../../api.rst:1117
+msgid "The location's latitude."
+msgstr ""
+
+#: ../../api.rst:1118
+msgid "The location's longitude."
+msgstr ""
+
+#: ../../api.rst:1119
+msgid ""
+"Specify the \"region\" in which to search, such as a number (then this is"
+" a radius in meters, but it can also take a string that is suffixed with "
+"ft to specify feet). If this is not passed in, then it is assumed to be "
+"0m"
+msgstr ""
+
+#: ../../api.rst:1123
+msgid "Assumed to be `neighborhood' by default; can also be `city'."
+msgstr ""
+
+#: ../../api.rst:1125
+msgid ""
+"A hint as to the maximum number of results to return. This is only a "
+"guideline, which may not be adhered to."
+msgstr ""
+
+#: ../../api.rst:1131
+msgid "Given *id* of a place, provide more details about that place."
+msgstr ""
+
+#: ../../api.rst:1133
+msgid "Valid Twitter ID of a location."
+msgstr ""
+
+#: ../../api.rst:1137
+msgid "Utility methods"
+msgstr ""
+
+#: ../../api.rst:1141
+msgid ""
+"Returns the current configuration used by Twitter including twitter.com "
+"slugs which are not usernames, maximum photo resolutions, and t.co "
+"shortened URL length. It is recommended applications request this "
+"endpoint when they are loaded, but no more than once a day."
+msgstr ""
+
+#: ../../api.rst:1148
+msgid "Media methods"
+msgstr ""
+
+#: ../../api.rst:1152
+msgid "Use this endpoint to upload images to Twitter."
+msgstr ""
+
+#: ../../api.rst:1154
+msgid ""
+"The filename of the image to upload. This will automatically be opened "
+"unless ``file`` is specified."
+msgstr ""
+
+#: ../../api.rst:1156
+msgid ""
+"A file object, which will be used instead of opening ``filename``. "
+"``filename`` is still required, for MIME type detection and to use as a "
+"form field in the POST data."
+msgstr ""
+
+#: ../../api.rst:1159
+msgid ":class:`Media` object"
+msgstr ""
+
+#: ../../api.rst:1164
+msgid ""
+"This endpoint can be used to provide additional information about the "
+"uploaded media_id. This feature is currently only supported for images "
+"and GIFs. Call this endpoint to attach additional metadata such as image "
+"alt text."
+msgstr ""
+
+#: ../../api.rst:1169
+msgid "The ID of the media to add alt text to."
+msgstr ""
+
+#: ../../api.rst:1170
+msgid "The alt text to add to the image."
+msgstr ""
+
+#: ../../api.rst:1174
+msgid ":mod:`tweepy.error` --- Exceptions"
+msgstr ""
+
+#: ../../api.rst:1176
+msgid ""
+"The exceptions are available in the ``tweepy`` module directly, which "
+"means ``tweepy.error`` itself does not need to be imported. For example, "
+"``tweepy.error.TweepError`` is available as ``tweepy.TweepError``."
+msgstr ""
+
+#: ../../api.rst:1183
+msgid "The main exception Tweepy uses. Is raised for a number of things."
+msgstr ""
+
+#: ../../api.rst:1185
+msgid ""
+"When a ``TweepError`` is raised due to an error Twitter responded with, "
+"the error code (`as described in the API documentation "
+"<https://developer.twitter.com/en/docs/basics/response-codes>`_) can be "
+"accessed at ``TweepError.response.text``. Note, however, that "
+"``TweepError``\\ s also may be raised with other things as message (for "
+"example plain error reason strings)."
+msgstr ""
+
+#: ../../api.rst:1195
+msgid ""
+"Is raised when an API method fails due to hitting Twitter's rate limit. "
+"Makes for easy handling of the rate limit specifically."
+msgstr ""
+
+#: ../../api.rst:1198
+msgid ""
+"Inherits from :exc:`TweepError`, so ``except TweepError`` will catch a "
+"``RateLimitError`` too."
+msgstr ""
+
+#: ../../api.rst:1203
+msgid "Footnotes"
+msgstr ""
+
+#: ../../api.rst:1204
+msgid "https://web.archive.org/web/20170829051949/https://dev.twitter.com/rest/reference/get/search/tweets"
+msgstr ""
+
+#: ../../api.rst:1205
+msgid ""
+"https://twittercommunity.com/t/favorited-reports-as-false-even-if-status-"
+"is-already-favorited-by-the-user/11145"
+msgstr ""
+
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2009-2019, Joshua Roesslein
+# This file is distributed under the same license as the tweepy package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: tweepy 3.8.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-11-15 19:26+0900\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.7.0\n"
+
+#: ../../extended_tweets.rst:6
+msgid "Extended Tweets"
+msgstr ""
+
+#: ../../extended_tweets.rst:8
+msgid "This supplements `Twitter's Tweet updates documentation`_."
+msgstr ""
+
+#: ../../extended_tweets.rst:11
+msgid "Introduction"
+msgstr ""
+
+#: ../../extended_tweets.rst:13
+msgid ""
+"On May 24, 2016, Twitter `announced <https://blog.twitter.com/express-"
+"even-more-in-140-characters>`_ changes to the way that replies and URLs "
+"are handled and `published plans <https://blog.twitter.com/2016/doing-"
+"more-with-140-characters>`_ around support for these changes in the "
+"Twitter API and initial technical documentation describing the updates to"
+" Tweet objects and API options.\\ [#]_ On September 26, 2017, Twitter "
+"`started testing "
+"<https://blog.twitter.com/official/en_us/topics/product/2017/Giving-you-"
+"more-characters-to-express-yourself.html>`_ 280 characters for certain "
+"languages,\\ [#]_ and on November 7, 2017, `announced "
+"<https://blog.twitter.com/official/en_us/topics/product/2017/tweetingmadeeasier.html>`_"
+" that the character limit was being expanded for Tweets in languages "
+"where cramming was an issue.\\ [#]_"
+msgstr ""
+
+#: ../../extended_tweets.rst:27
+msgid "Standard API methods"
+msgstr ""
+
+#: ../../extended_tweets.rst:29
+msgid ""
+"Any ``tweepy.API`` method that returns a Status object accepts a new "
+"``tweet_mode`` parameter. Valid values for this parameter are ``compat`` "
+"and ``extended``, which give compatibility mode and extended mode, "
+"respectively. The default mode (if no parameter is provided) is "
+"compatibility mode."
+msgstr ""
+
+#: ../../extended_tweets.rst:35
+msgid "Compatibility mode"
+msgstr ""
+
+#: ../../extended_tweets.rst:37
+msgid ""
+"By default, using compatibility mode, the ``text`` attribute of Status "
+"objects returned by ``tweepy.API`` methods is truncated to 140 "
+"characters, as needed. When this truncation occurs, the ``truncated`` "
+"attribute of the Status object will be ``True``, and only entities that "
+"are fully contained within the available 140 characters range will be "
+"included in the ``entities`` attribute. It will also be discernible that "
+"the ``text`` attribute of the Status object is truncated as it will be "
+"suffixed with an ellipsis character, a space, and a shortened self-"
+"permalink URL to the Tweet."
+msgstr ""
+
+#: ../../extended_tweets.rst:47
+msgid "Extended mode"
+msgstr ""
+
+#: ../../extended_tweets.rst:49
+msgid ""
+"When using extended mode, the ``text`` attribute of Status objects "
+"returned by ``tweepy.API`` methods is replaced by a ``full_text`` "
+"attribute, which contains the entire untruncated text of the Tweet. The "
+"``truncated`` attribute of the Status object will be ``False``, and the "
+"``entities`` attribute will contain all entities. Additionally, the "
+"Status object will have a ``display_text_range`` attribute, an array of "
+"two Unicode code point indices, identifying the inclusive start and "
+"exclusive end of the displayable content of the Tweet."
+msgstr ""
+
+#: ../../extended_tweets.rst:59
+msgid "Streaming"
+msgstr ""
+
+#: ../../extended_tweets.rst:61
+msgid ""
+"By default, the Status objects from streams may contain an "
+"``extended_tweet`` attribute representing the equivalent field in the raw"
+" data/payload for the Tweet. This attribute/field will only exist for "
+"extended Tweets, containing a dictionary of sub-fields. The ``full_text``"
+" sub-field/key of this dictionary will contain the full, untruncated text"
+" of the Tweet, and the ``entities`` sub-field/key will contain the full "
+"set of entities. If there are extended entities, the "
+"``extended_entities`` sub-field/key will contain the full set of those. "
+"Additionally, the ``display_text_range`` sub-field/key will contain an "
+"array of two Unicode code point indices, identifying the inclusive start "
+"and exclusive end of the displayable content of the Tweet."
+msgstr ""
+
+#: ../../extended_tweets.rst:73
+msgid "Handling Retweets"
+msgstr ""
+
+#: ../../extended_tweets.rst:75
+msgid ""
+"When using extended mode with a Retweet, the ``full_text`` attribute of "
+"the Status object may be truncated with an ellipsis character instead of "
+"containing the full text of the Retweet. However, since the "
+"``retweeted_status`` attribute (of a Status object that is a Retweet) is "
+"itself a Status object, the ``full_text`` attribute of the Retweeted "
+"Status object can be used instead."
+msgstr ""
+
+#: ../../extended_tweets.rst:82
+msgid ""
+"This also applies similarly to Status objects/payloads that are Retweets "
+"from streams. The dictionary from the ``extended_tweet`` attribute/field "
+"contains a ``full_text`` sub-field/key that may be truncated with an "
+"ellipsis character. Instead, the ``extended_tweet`` attribute/field of "
+"the Retweeted Status (from the ``retweeted_status`` attribute/field) can "
+"be used."
+msgstr ""
+
+#: ../../extended_tweets.rst:89
+msgid "Examples"
+msgstr ""
+
+#: ../../extended_tweets.rst:91
+msgid ""
+"Given an existing ``tweepy.API`` object and ``id`` for a Tweet, the "
+"following can be used to print the full text of the Tweet, or if it's a "
+"Retweet, the full text of the Retweeted Tweet::"
+msgstr ""
+
+#: ../../extended_tweets.rst:101
+msgid "If ``status`` is a Retweet, ``status.full_text`` could be truncated."
+msgstr ""
+
+#: ../../extended_tweets.rst:103
+msgid ""
+"This Status event handler for a ``StreamListener`` prints the full text "
+"of the Tweet, or if it's a Retweet, the full text of the Retweeted "
+"Tweet::"
+msgstr ""
+
+#: ../../extended_tweets.rst:118
+msgid ""
+"If ``status`` is a Retweet, it will not have an ``extended_tweet`` "
+"attribute, and ``status.text`` could be truncated."
+msgstr ""
+
+#: ../../extended_tweets.rst:122
+msgid "Footnotes"
+msgstr ""
+
+#: ../../extended_tweets.rst:123
+msgid ""
+"https://twittercommunity.com/t/upcoming-changes-to-simplify-replies-and-"
+"links-in-tweets/67497"
+msgstr ""
+
+#: ../../extended_tweets.rst:124
+msgid ""
+"https://twittercommunity.com/t/testing-280-characters-for-certain-"
+"languages/94126"
+msgstr ""
+
+#: ../../extended_tweets.rst:125
+msgid ""
+"https://twittercommunity.com/t/updating-the-character-limit-and-the-"
+"twitter-text-library/96425"
+msgstr ""
+
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2009-2019, Joshua Roesslein
+# This file is distributed under the same license as the tweepy package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: tweepy 3.8.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-11-15 19:26+0900\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.7.0\n"
+
+#: ../../streaming_how_to.rst:8
+msgid "Streaming With Tweepy"
+msgstr ""
+
+#: ../../streaming_how_to.rst:9
+msgid ""
+"Tweepy makes it easier to use the twitter streaming api by handling "
+"authentication, connection, creating and destroying the session, reading "
+"incoming messages, and partially routing messages."
+msgstr ""
+
+#: ../../streaming_how_to.rst:13
+msgid ""
+"This page aims to help you get started using Twitter streams with Tweepy "
+"by offering a first walk through. Some features of Tweepy streaming are "
+"not covered here. See streaming.py in the Tweepy source code."
+msgstr ""
+
+#: ../../streaming_how_to.rst:17
+msgid ""
+"API authorization is required to access Twitter streams. Follow the "
+":ref:`auth_tutorial` if you need help with authentication."
+msgstr ""
+
+#: ../../streaming_how_to.rst:21
+msgid "Summary"
+msgstr ""
+
+#: ../../streaming_how_to.rst:22
+msgid ""
+"The Twitter streaming API is used to download twitter messages in real "
+"time. It is useful for obtaining a high volume of tweets, or for "
+"creating a live feed using a site stream or user stream. See the `Twitter"
+" Streaming API Documentation`_."
+msgstr ""
+
+#: ../../streaming_how_to.rst:27
+msgid ""
+"The streaming api is quite different from the REST api because the REST "
+"api is used to *pull* data from twitter but the streaming api *pushes* "
+"messages to a persistent session. This allows the streaming api to "
+"download more data in real time than could be done using the REST API."
+msgstr ""
+
+#: ../../streaming_how_to.rst:33
+msgid ""
+"In Tweepy, an instance of **tweepy.Stream** establishes a streaming "
+"session and routes messages to **StreamListener** instance. The "
+"**on_data** method of a stream listener receives all messages and calls "
+"functions according to the message type. The default **StreamListener** "
+"can classify most common twitter messages and routes them to "
+"appropriately named methods, but these methods are only stubs."
+msgstr ""
+
+#: ../../streaming_how_to.rst:41
+msgid "Therefore using the streaming api has three steps."
+msgstr ""
+
+#: ../../streaming_how_to.rst:43
+msgid "Create a class inheriting from **StreamListener**"
+msgstr ""
+
+#: ../../streaming_how_to.rst:45
+msgid "Using that class create a **Stream** object"
+msgstr ""
+
+#: ../../streaming_how_to.rst:47
+msgid "Connect to the Twitter API using the **Stream**."
+msgstr ""
+
+#: ../../streaming_how_to.rst:51
+msgid "Step 1: Creating a **StreamListener**"
+msgstr ""
+
+#: ../../streaming_how_to.rst:52
+msgid ""
+"This simple stream listener prints status text. The **on_data** method of"
+" Tweepy's **StreamListener** conveniently passes data from statuses to "
+"the **on_status** method. Create class **MyStreamListener** inheriting "
+"from **StreamListener** and overriding **on_status**.::"
+msgstr ""
+
+#: ../../streaming_how_to.rst:65
+msgid "Step 2: Creating a **Stream**"
+msgstr ""
+
+#: ../../streaming_how_to.rst:66
+msgid ""
+"We need an api to stream. See :ref:`auth_tutorial` to learn how to get an"
+" api object. Once we have an api and a status listener we can create our "
+"stream object.::"
+msgstr ""
+
+#: ../../streaming_how_to.rst:73
+msgid "Step 3: Starting a Stream"
+msgstr ""
+
+#: ../../streaming_how_to.rst:74
+msgid ""
+"A number of twitter streams are available through Tweepy. Most cases will"
+" use filter, the user_stream, or the sitestream. For more information on "
+"the capabilities and limitations of the different streams see `Twitter "
+"Streaming API Documentation`_."
+msgstr ""
+
+#: ../../streaming_how_to.rst:79
+msgid ""
+"In this example we will use **filter** to stream all tweets containing "
+"the word *python*. The **track** parameter is an array of search terms to"
+" stream. ::"
+msgstr ""
+
+#: ../../streaming_how_to.rst:84
+msgid ""
+"This example shows how to use **filter** to stream tweets by a specific "
+"user. The **follow** parameter is an array of IDs. ::"
+msgstr ""
+
+#: ../../streaming_how_to.rst:88
+msgid ""
+"An easy way to find a single ID is to use one of the many conversion "
+"websites: search for 'what is my twitter ID'."
+msgstr ""
+
+#: ../../streaming_how_to.rst:91
+msgid "A Few More Pointers"
+msgstr ""
+
+#: ../../streaming_how_to.rst:94
+msgid "Async Streaming"
+msgstr ""
+
+#: ../../streaming_how_to.rst:95
+msgid ""
+"Streams do not terminate unless the connection is closed, blocking the "
+"thread. Tweepy offers a convenient **is_async** parameter on **filter** "
+"so the stream will run on a new thread. For example ::"
+msgstr ""
+
+#: ../../streaming_how_to.rst:102
+msgid "Handling Errors"
+msgstr ""
+
+#: ../../streaming_how_to.rst:103
+msgid ""
+"When using Twitter's streaming API one must be careful of the dangers of "
+"rate limiting. If clients exceed a limited number of attempts to connect "
+"to the streaming API in a window of time, they will receive error 420. "
+"The amount of time a client has to wait after receiving error 420 will "
+"increase exponentially each time they make a failed attempt."
+msgstr ""
+
+#: ../../streaming_how_to.rst:108
+msgid ""
+"Tweepy's **Stream Listener** passes error codes to an **on_error** stub. "
+"The default implementation returns **False** for all codes, but we can "
+"override it to allow Tweepy to reconnect for some or all codes, using the"
+" backoff strategies recommended in the `Twitter Streaming API Connecting "
+"Documentation`_. ::"
+msgstr ""
+
+#: ../../streaming_how_to.rst:123
+msgid ""
+"For more information on error codes from the Twitter API see `Twitter "
+"Response Codes Documentation`_."
+msgstr ""
+
projects / tweepy.git / commitdiff